Claude Code 活用ガイド

MCP（Model Context Protocol）完全ガイド
外部ツール連携の設定と活用例

GitHubやデータベース、Slack など外部サービスを Claude Code に繋いで、AIがリアルタイムに情報を取得・操作できるようにする仕組みを解説します。

Claude Code MCP 外部ツール連携 API統合開発効率化

MCP（Model Context Protocol）とは？

一言でいうと「AIと外部ツールを繋ぐ標準プロトコル」

MCP（Model Context Protocol）は、Claude Code が外部のツールやサービスと連携するための仕組みです。MCPサーバーを追加することで、Claude Code はリアルタイムで GitHub のイシューを読んだり、データベースにクエリを投げたり、Slack にメッセージを送ったりできるようになります。

従来のAIチャットはトレーニングデータの知識しか持てませんでしたが、MCP によって Claude Code は「今この瞬間の外部データ」に直接アクセスできるようになります。

🔌

標準規格

Anthropic が策定したオープンな標準規格。対応ツールなら Claude Code 以外の AI クライアントでも使える。

⚡

リアルタイム連携

GitHub のイシュー一覧・エラーログ・DB の最新データなど、今の情報を取得して応答に活かせる。

🛠️

双方向操作

読み取りだけでなく、PR 作成・チケット更新・コマンド実行など書き込みも可能。

🌐

エコシステム

GitHub・Sentry・PostgreSQL・Slack など多数の公式・サードパーティ製サーバーが公開されている。

MCPサーバーの接続方式

MCPサーバーへの接続には3つのトランスポート方式があります。使うサーバーに合わせて選択します。

方式	コマンドオプション	特徴	主な用途
HTTP（SSE）	`--transport http`	URLで接続。OAuth認証対応。	クラウドサービス・外部API
SSE	`--transport sse`	Server-Sent Events。旧来の方式。	レガシーサーバー
stdio	`--transport stdio` （省略可）	ローカルプロセスを起動して通信。	ローカルツール・npm パッケージ

ほとんどの npm パッケージ型サーバーは stdio 方式です。claude mcp add はデフォルトで stdio を使うため、ローカルツールの場合はオプション省略で OK です。

スコープ：どこに設定を保存するか

MCPサーバーの設定は3つのスコープで管理されます。用途に応じて使い分けましょう。

local	自分だけのローカル設定（デフォルト） `~/.claude.json` に保存。Git にコミットされない。APIキーなど秘密情報はここに書く。コマンド例: `claude mcp add github --transport http https://api.githubcopilot.com/mcp/`
project	プロジェクト共有設定 `.mcp.json`（プロジェクトルート）に保存。Git にコミットしてチームで共有できる。コマンド例: `claude mcp add --scope project postgres npx @modelcontextprotocol/server-postgres`
user	全プロジェクト共通のユーザー設定 `~/.claude/settings.json` に保存。どのプロジェクトでも使いたいサーバーに適用。コマンド例: `claude mcp add --scope user sentry npx @sentry/mcp-server-sentry`

基本的な使い方：MCPサーバーを追加する

サーバーを追加する

claude mcp add コマンドで MCPサーバーを登録します。stdio 方式の場合はコマンドを直接指定します。

接続を確認する

claude mcp list で登録済みのサーバー一覧を表示。claude mcp get <名前> で詳細確認ができます。

Claude Code で利用する

追加後は Claude Code のセッションを再起動すると新しいサーバーが有効になります。/mcp コマンドで接続状況を確認できます。

基本コマンド一覧

# サーバーを追加（stdio 方式）
claude mcp add <名前> <コマンド> [引数...]

# HTTP/SSE 方式で追加
claude mcp add --transport http <名前> <URL>

# スコープを指定して追加（project / user）
claude mcp add --scope project <名前> <コマンド>

# 登録済みサーバーを一覧表示
claude mcp list

# 特定サーバーの詳細確認
claude mcp get <名前>

# サーバーを削除
claude mcp remove <名前>

# 接続状態を確認（Claude Code セッション内）
/mcp

実践的な活用例

公式・サードパーティ製を合わせて多数のMCPサーバーが公開されています。代表的なものをご紹介します。

🐙 GitHub

PR の作成・コードレビュー・イシュー管理を Claude が直接操作。コードを書きながらそのままPRを出せる。

claude mcp add --transport http github https://api.githubcopilot.com/mcp/

🔥 Sentry

エラートラッキングサービスと連携。「最新のエラーを調べて修正して」と頼むと Sentry のログを見ながらコードを直してくれる。

claude mcp add sentry npx @sentry/mcp-server-sentry

🐘 PostgreSQL

データベースに自然言語でクエリ。「売上が高い上位10件を取得して」とチャットするだけで SQL を発行してくれる。

claude mcp add postgres npx @modelcontextprotocol/server-postgres postgresql://localhost/mydb

🔍 Brave Search

最新のウェブ情報を検索。Claude の知識カットオフ以降の情報も調べながら回答できる。

claude mcp add brave-search npx @modelcontextprotocol/server-brave-search

📁 Filesystem

指定したディレクトリ配下のファイルを安全に読み書き。プロジェクトのファイル操作を細かくコントロールできる。

claude mcp add files npx @modelcontextprotocol/server-filesystem /path/to/dir

💬 Slack

Slack チャンネルの読み取り・投稿。コード修正後に「Slack の #dev チャンネルに報告して」が実現できる。

claude mcp add slack npx @modelcontextprotocol/server-slack

OAuth 認証が必要なサーバーへの接続

GitHub など OAuth 認証が必要なサービスは、サーバーを追加した後に認証を行います。

サーバーを追加する

通常通り claude mcp add でサーバーを登録します。

/mcp コマンドで認証を開始

Claude Code のセッション内で /mcp コマンドを実行し、該当サーバーの「認証」を選択します。ブラウザが開いてサービスの認証画面が表示されます。

ブラウザで認証を完了する

OAuth フローで許可を与えると、アクセストークンが自動的に保存されます。次回以降は自動認証されます。

GitHub MCP の設定例

# 1. HTTP 方式でサーバーを追加
claude mcp add --transport http github https://api.githubcopilot.com/mcp/

# 2. Claude Code セッション内で認証
/mcp
# → 「github」を選択 → 「ブラウザで認証」
# → GitHub の OAuth 認証ページが開く
# → 認証完了後に自動でトークンが保存される

チームで共有する：.mcp.json の使い方

プロジェクトスコープで追加したサーバーは、プロジェクトルートの .mcp.json に保存されます。このファイルを Git にコミットすることで、チーム全員が同じ MCPサーバーを使えるようになります。

.mcp.json の例

{
  "mcpServers": {
    "postgres": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-postgres",
        "postgresql://localhost/myapp"
      ]
    },
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/"
    }
  }
}

⚠️ セキュリティ注意事項

.mcp.json には APIキーやパスワードなどの秘密情報を直接書かないでください。機密情報は環境変数（env フィールド）で渡すか、ローカルスコープ（~/.claude.json）に保存し、Git にはコミットしないようにしましょう。

環境変数で APIキーを渡す例

{
  "mcpServers": {
    "brave-search": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-brave-search"],
      "env": {
        "BRAVE_API_KEY": "${BRAVE_API_KEY}"
      }
    }
  }
}

応用：Claude Code 自体を MCPサーバーとして使う

Claude Code を他のAIツールから呼び出せる

claude mcp serve コマンドを実行すると、Claude Code 自体が MCPサーバーとして起動します。他の MCP クライアント（別の AIエディタなど）から Claude Code の機能（ファイル編集・コード生成・コマンド実行）を呼び出せるようになります。

Claude Code を MCPサーバーとして起動

# stdio 方式で MCP サーバーとして起動
claude mcp serve

# 別の MCP クライアントから利用する場合の設定例
# （クライアント側の設定ファイルに記述）
{
  "mcpServers": {
    "claude-code": {
      "type": "stdio",
      "command": "claude",
      "args": ["mcp", "serve"]
    }
  }
}

この機能を使うと、VS Code の GitHub Copilot や Cursor など、MCP 対応のエディタから Claude Code のコード生成・編集能力を活用できます。複数のAIツールを組み合わせた高度なワークフローが構築できます。

よくある問題と対処法

接続できない・サーバーが見つからない

claude mcp list で登録を確認

サーバーが正しく登録されているか確認します。表示されない場合は claude mcp add から再登録。

セッションを再起動する

サーバー追加後にセッションを再起動しないと反映されません。Claude Code を一度終了して再起動してください。

–mcp-debug フラグでログを確認

詳細なデバッグログを表示したい場合は claude –mcp-debug で起動します。接続エラーの詳細が確認できます。

認証エラーが出る

OAuth の場合は /mcp コマンドで再認証を試みる
APIキーが必要なサーバーは環境変数が正しく設定されているか確認する
claude mcp remove で一度削除し、再追加する

プロジェクトスコープのサーバーが使えない

⚠️ .mcp.json の承認が必要

セキュリティ上、プロジェクトスコープのサーバーは初回起動時に「信頼するか確認」のプロンプトが表示されます。–allowedMcpServers フラグで自動承認するか、起動時の確認画面で許可してください。

まとめ：MCP でできることが大きく広がる

MCP を活用することで、Claude Code は単なるコード補助ツールから「外部サービスを操作できるAIエージェント」に進化します。

📋

開発フローの自動化

GitHub のイシュー確認 → コード修正 → PR 作成 → Slack 報告をすべて Claude Code に任せられる。

🔎

リアルタイム情報の活用

ログ・DBデータ・検索結果など最新情報を踏まえた回答と対応が可能になる。

🤝

チーム共有

.mcp.json をコミットするだけで、チーム全員が同じ環境・ツールで Claude Code を使える。

Claude Code のさらなる活用法

MCP 以外にも Claude Code には便利な機能がたくさんあります。

スラッシュコマンドでワークフローをカスタマイズ
hooks で自動テスト・フォーマットを設定
Remote Control でリモートからコードを操作

ぜひ他の記事もご覧ください！

MCP（Model Context Protocol）完全ガイド外部ツール連携の設定と活用例