MCPを介してClaude Codeをツールに接続する

Claude Codeは、AI-ツール統合のためのオープンソース標準であるModel Context Protocol (MCP)を通じて、数百の外部ツールやデータソースに接続できます。MCPサーバーは、Claude Codeにあなたのツール、データベース、APIへのアクセスを提供します。

​

MCPでできること

MCPサーバーが接続されると、Claude Codeに以下のことを依頼できます：

• 課題トラッカーからの機能実装: “JIRA課題ENG-4521で説明されている機能を追加し、GitHubでPRを作成してください。”
• 監視データの分析: “SentryとStatsigをチェックして、ENG-4521で説明されている機能の使用状況を確認してください。”
• データベースクエリ: “Postgresデータベースに基づいて、機能ENG-4521を使用した10人のランダムユーザーのメールアドレスを見つけてください。”
• デザインの統合: “Slackに投稿された新しいFigmaデザインに基づいて、標準メールテンプレートを更新してください”
• ワークフローの自動化: “新機能についてのフィードバックセッションにこれら10人のユーザーを招待するGmailドラフトを作成してください。“

​

人気のMCPサーバー

Claude Codeに接続できる一般的に使用されるMCPサーバーをいくつか紹介します：

​

MCPサーバーのインストール

MCPサーバーは、ニーズに応じて3つの異なる方法で設定できます：

​

オプション1: ローカルstdioサーバーを追加

Stdioサーバーは、マシン上でローカルプロセスとして実行されます。直接システムアクセスやカスタムスクリプトが必要なツールに最適です。

# 基本構文
claude mcp add <name> <command> [args...]

# 実際の例: Airtableサーバーを追加
claude mcp add airtable --env AIRTABLE_API_KEY=YOUR_KEY \
  -- npx -y airtable-mcp-server

​

オプション2: リモートSSEサーバーを追加

SSE（Server-Sent Events）サーバーは、リアルタイムストリーミング接続を提供します。多くのクラウドサービスがライブ更新にこれを使用しています。

# 基本構文
claude mcp add --transport sse <name> <url>

# 実際の例: Linearに接続
claude mcp add --transport sse linear https://mcp.linear.app/sse

# 認証ヘッダーを使用した例
claude mcp add --transport sse private-api https://api.company.com/mcp \
  --header "X-API-Key: your-key-here"

​

オプション3: リモートHTTPサーバーを追加

HTTPサーバーは標準的なリクエスト/レスポンスパターンを使用します。ほとんどのREST APIとWebサービスがこのトランスポートを使用します。

# 基本構文
claude mcp add --transport http <name> <url>

# 実際の例: Notionに接続
claude mcp add --transport http notion https://mcp.notion.com/mcp

# Bearerトークンを使用した例
claude mcp add --transport http secure-api https://api.example.com/mcp \
  --header "Authorization: Bearer your-token"

​

サーバーの管理

設定後、これらのコマンドでMCPサーバーを管理できます：

# 設定されたすべてのサーバーをリスト
claude mcp list

# 特定のサーバーの詳細を取得
claude mcp get github

# サーバーを削除
claude mcp remove github

# （Claude Code内で）サーバーステータスを確認
/mcp

# これによりWindowsが実行できる command="cmd" が作成されます
claude mcp add my-server -- cmd /c npx -y @some/package

​

MCPインストールスコープ

MCPサーバーは3つの異なるスコープレベルで設定でき、それぞれがサーバーのアクセシビリティと共有の管理において異なる目的を果たします。これらのスコープを理解することで、特定のニーズに最適なサーバー設定方法を決定できます。

​

ローカルスコープ

ローカルスコープのサーバーはデフォルトの設定レベルを表し、プロジェクト固有のユーザー設定に保存されます。これらのサーバーはあなたにとってプライベートであり、現在のプロジェクトディレクトリ内で作業している場合にのみアクセス可能です。このスコープは、個人開発サーバー、実験的設定、または共有すべきでない機密認証情報を含むサーバーに最適です。

# ローカルスコープのサーバーを追加（デフォルト）
claude mcp add my-private-server /path/to/server

# 明示的にローカルスコープを指定
claude mcp add my-private-server --scope local /path/to/server

​

プロジェクトスコープ

プロジェクトスコープのサーバーは、プロジェクトのルートディレクトリにある.mcp.jsonファイルに設定を保存することで、チームコラボレーションを可能にします。このファイルはバージョン管理にチェックインされるように設計されており、すべてのチームメンバーが同じMCPツールとサービスにアクセスできることを保証します。プロジェクトスコープのサーバーを追加すると、Claude Codeは自動的にこのファイルを作成または更新し、適切な設定構造を提供します。

# プロジェクトスコープのサーバーを追加
claude mcp add shared-server --scope project /path/to/server

結果として生成される.mcp.jsonファイルは標準化された形式に従います：

{
  "mcpServers": {
    "shared-server": {
      "command": "/path/to/server",
      "args": [],
      "env": {}
    }
  }
}

セキュリティ上の理由から、Claude Codeは.mcp.jsonファイルからプロジェクトスコープのサーバーを使用する前に承認を求めます。これらの承認選択をリセットする必要がある場合は、claude mcp reset-project-choicesコマンドを使用してください。

​

ユーザースコープ

ユーザースコープのサーバーは、プロジェクト間でのアクセシビリティを提供し、ユーザーアカウントにプライベートを保ちながら、マシン上のすべてのプロジェクトで利用可能にします。このスコープは、個人用ユーティリティサーバー、開発ツール、または異なるプロジェクト間で頻繁に使用するサービスに適しています。

# ユーザーサーバーを追加
claude mcp add my-user-server --scope user /path/to/server

​

適切なスコープの選択

以下に基づいてスコープを選択してください：

• ローカルスコープ: 個人サーバー、実験的設定、または1つのプロジェクトに固有の機密認証情報
• プロジェクトスコープ: チーム共有サーバー、プロジェクト固有のツール、またはコラボレーションに必要なサービス
• ユーザースコープ: 複数のプロジェクトで必要な個人ユーティリティ、開発ツール、または頻繁に使用するサービス

​

スコープ階層と優先順位

MCPサーバー設定は明確な優先順位階層に従います。同じ名前のサーバーが複数のスコープに存在する場合、システムはローカルスコープのサーバーを最初に優先し、次にプロジェクトスコープのサーバー、最後にユーザースコープのサーバーという順序で競合を解決します。この設計により、必要に応じて個人設定が共有設定を上書きできることが保証されます。

​

.mcp.jsonでの環境変数展開

Claude Codeは.mcp.jsonファイルでの環境変数展開をサポートしており、チームがマシン固有のパスやAPIキーなどの機密値に対する柔軟性を維持しながら設定を共有できます。

サポートされる構文:

• ${VAR} - 環境変数VARの値に展開
• ${VAR:-default} - VARが設定されている場合はその値に、そうでなければdefaultに展開

展開場所: 環境変数は以下で展開できます：

• command - サーバー実行可能ファイルのパス
• args - コマンドライン引数
• env - サーバーに渡される環境変数
• url - SSE/HTTPサーバータイプ用
• headers - SSE/HTTP サーバー認証用

変数展開を使用した例:

{
  "mcpServers": {
    "api-server": {
      "type": "sse",
      "url": "${API_BASE_URL:-https://api.example.com}/mcp",
      "headers": {
        "Authorization": "Bearer ${API_KEY}"
      }
    }
  }
}

必要な環境変数が設定されておらず、デフォルト値もない場合、Claude Codeは設定の解析に失敗します。

​

実用的な例

​

例: Sentryでエラーを監視

# 1. Sentry MCPサーバーを追加
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

# 2. /mcpを使用してSentryアカウントで認証
> /mcp

# 3. 本番環境の問題をデバッグ
> "過去24時間で最も一般的なエラーは何ですか？"
> "エラーID abc123のスタックトレースを表示してください"
> "これらの新しいエラーを導入したのはどのデプロイメントですか？"

​

リモートMCPサーバーでの認証

多くのクラウドベースのMCPサーバーは認証が必要です。Claude Codeは安全な接続のためにOAuth 2.0をサポートしています。

claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

> /mcp

​

JSON設定からMCPサーバーを追加

MCPサーバーのJSON設定がある場合、直接追加できます：

# 基本構文
claude mcp add-json <name> '<json>'

# 例: JSON設定でstdioサーバーを追加
claude mcp add-json weather-api '{"type":"stdio","command":"/path/to/weather-cli","args":["--api-key","abc123"],"env":{"CACHE_DIR":"/tmp"}}'

claude mcp get weather-api

​

Claude DesktopからMCPサーバーをインポート

Claude DesktopでMCPサーバーをすでに設定している場合、それらをインポートできます：

# 基本構文 
claude mcp add-from-claude-desktop 

claude mcp list 

​

Claude CodeをMCPサ ーバーとして使用

Claude Code自体を他のアプリケーションが接続できるMCPサーバーとして使用できます：

# ClaudeをstdioMCPサーバーとして開始
claude mcp serve

claude_desktop_config.jsonにこの設定を追加することで、Claude Desktopでこれを使用できます：

{
  "mcpServers": {
    "claude-code": {
      "command": "claude",
      "args": ["mcp", "serve"],
      "env": {}
    }
  }
}

​

MCP出力制限と警告

MCPツールが大きな出力を生成する場合、Claude Codeは会話コンテキストを圧迫しないようにトークン使用量の管理を支援します：

• 出力警告しきい値: Claude CodeはMCPツールの出力が10,000トークンを超えると警告を表示します
• 設定可能な制限: MAX_MCP_OUTPUT_TOKENS環境変数を使用して、許可される最大MCP出力トークン数を調整できます
• デフォルト制限: デフォルトの最大値は25,000トークンです

大きな出力を生成するツールの制限を増やすには：

# MCPツール出力のより高い制限を設定
export MAX_MCP_OUTPUT_TOKENS=50000
claude

これは以下のようなMCPサーバーで作業する際に特に有用です：

• 大きなデータセットやデータベースをクエリする
• 詳細なレポートやドキュメントを生成する
• 広範囲なログファイルやデバッグ情報を処理する

​

MCPリソースの使用

MCPサーバーは、ファイルを参照するのと同様に@メンションを使用して参照できるリソースを公開できます。

​

MCPリソースの参照

> @github:issue://123を分析して修正を提案してもらえますか？

> @docs:file://api/authenticationのAPIドキュメントをレビューしてください

> @postgres:schema://usersと@docs:file://database/user-modelを比較してください

​

MCPプロンプトをスラッシュコマンドとして使用

MCPサーバーは、Claude Codeでスラッシュコマンドとして利用可能になるプロンプトを公開できます。

​

MCPプロンプトの実行

> /mcp__github__list_prs

> /mcp__github__pr_review 456

> /mcp__jira__create_issue "ログインフローのバグ" high