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で説明されている機能の使用状況を確認してください。”
• データベースをクエリする: “PostgreSQLデータベースに基づいて、機能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 をstdio MCPサーバー として開始
claude mcp serve

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

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

​

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