AIエージェント

Claude Code × MCP連携完全ガイド｜外部ツールとの接続方法

「Claude CodeでMCPを使いたいけど、設定方法がわからない」「どのMCPサーバーを入れるべき？」。Claude CodeはMCP（Model Context Protocol）との連携を標準サポートしており、GitHub、Slack、Notion、Playwrightなど数百のサービスとAIを接続できます。

しかし、スコープの概念や設定ファイルの保存場所が独特で、初期設定に混乱するユーザーが多いのも事実です。

本記事では、Claude CodeでMCPサーバーを追加する具体的なコマンド、3つのスコープの使い分け、最初に入れるべきおすすめMCPサーバー、実践的な活用パターン、さらにClaude Code自体をMCPサーバーとして公開する方法まで、網羅的に解説します。

「Claude CodeとMCPの連携」を実務の自動化につなげるには、単体ツールの利用で終わらず、既存SaaSや業務フローとの接続まで設計する必要があります。資料では、API・RPA・スクレイピングの使い分け、AI判断と人の承認を組み合わせる設計、段階的な自動化の進め方を解説しています。ツール分断や二重入力を解消したい方は、以下の無料資料をご覧ください。
▶ ツールを増やさず、既存SaaSとAIを統合する設計ガイド

Claude CodeとMCP連携の基本

Claude CodeはMCPクライアントとしての機能を標準搭載しており、外部のMCPサーバーと接続することでAIの能力を大幅に拡張できます。MCP連携を設定すると、Claude Codeがファイル操作だけでなく、GitHub操作、ブラウザ操作、データベースクエリ、Slack投稿など、外部サービスとの連携タスクを自律的に処理できるようになります。

MCP（Model Context Protocol）は、Anthropicが2024年11月に発表したオープンソースの標準プロトコルで、AIと外部ツールをつなぐための「共通言語」です。従来はAIとサービスごとに個別のAPI実装が必要でしたが、MCPにより一度仕組みを覚えれば同じやり方で様々なツールと接続できるようになりました。

Claude CodeのMCP設定が「ややこしい」と感じる理由

Claude CodeのMCP設定が難しいと感じる最大の原因は、「スコープ」の概念です。Claude Codeでは、MCPサーバーの設定を3つのスコープ（適用範囲）に分けて管理します。local（デフォルト）は現在のプロジェクト固有の設定で、.claude/配下に保存されます。projectはチームで共有する設定で、.mcp.jsonファイルに保存されGit管理できます。userはすべてのプロジェクトに適用されるグローバル設定です。

スコープによって設定ファイルの保存場所が変わるため、「設定したはずのMCPサーバーが見つからない」というトラブルの原因になります。原則として、個人で使うMCPはlocal、チームで共有するMCPはproject、どのプロジェクトでも使うMCP（例：ブラウザ操作）はuserスコープで設定しましょう。

Claude CodeでMCPサーバーを設定する方法

Claude CodeでMCPサーバーを追加する方法は、CLIコマンドを使う方法と、設定ファイルを直接編集する方法の2つがあります。公式にはCLIコマンドが推奨されています。

claude mcp addコマンドでの追加（推奨）

MCPサーバーを追加する基本コマンドは「claude mcp add <サーバー名> — <実行コマンド>」です。たとえば、Playwrightでブラウザ操作を可能にするには、「claude mcp add playwright -s project — npx -y @playwright/mcp@latest」と実行します。「-s project」でスコープをprojectに指定しています。

GitHub MCPサーバーを追加する場合は、事前にGitHub Personal Access Tokenを環境変数に設定したうえで、「claude mcp add github — docker run -i –rm -e GITHUB_PERSONAL_ACCESS_TOKEN ghcr.io/github/github-mcp-server」のように実行します。Docker経由での実行が一般的ですが、npx経由で利用できるサーバーも多数あります。

設定ファイルの直接編集

JSON形式の設定ファイルを直接編集する方法もあります。すでにMCPサーバーのJSON設定を持っている場合は、claude mcp add-jsonコマンドで一括インポートできます。設定ファイルの場所は、localスコープが.claude/配下、projectスコープが.mcp.json、userスコープがホームディレクトリの~/.claude/配下です。

リモート型MCPサーバー（SSE/Streamable HTTP）を追加する場合は、「claude mcp add –transport sse <サーバー名> <URL>」のようにトランスポートタイプを指定します。認証が必要なリモートサーバーでは、headersやheadersHelperを使ってAPIキーやOAuthトークンを自動設定できます。

MCPサーバーの管理コマンド

設定後は以下のコマンドでMCPサーバーを管理できます。「claude mcp list」で設定済みのサーバー一覧を表示、「claude mcp get <サーバー名>」で特定サーバーの詳細を確認、「claude mcp remove <サーバー名>」でサーバーを削除します。Claude Codeのセッション中に「/mcp」スラッシュコマンドを実行すると、接続中のMCPサーバーのステータスを確認できます。

MCPサーバーの接続に問題がある場合は、「/mcp」コマンドでステータスを確認し、「Disconnected」と表示されるサーバーがないか確認しましょう。よくある原因は、必要なパッケージの未インストール、環境変数の未設定、npxのパス問題です。

Claude Codeに最初に入れるべきおすすめMCPサーバー4選

Claude Code × MCPの組み合わせで特に実用性が高いMCPサーバーを4つ紹介します。

Playwright MCP：ブラウザ操作の自動化

Playwright MCPは、Claude Codeにブラウザ操作の能力を追加する定番サーバーです。Webページの操作、スクリーンショット取得、フォーム入力、データ抽出などを自動化できます。「claude mcp add playwright -s project — npx -y @playwright/mcp@latest」の1コマンドで追加でき、開発中のWebアプリの動作確認やE2Eテストの自動生成に活用できます。

開発体験を大きく向上させるMCPとして、多くの開発者が最初に導入するサーバーです。

GitHub MCP：リポジトリ・Issue・PR操作

GitHub MCPサーバーを追加すると、Claude Codeからリポジトリの情報取得、Issueの作成・更新、プルリクエストの管理、コードレビューなどを自然言語で行えます。「このバグのIssueを作成して」「最新のPRをレビューして」といった指示が可能になります。

Docker経由での追加が推奨されており、GitHub Personal Access Tokenの環境変数設定が事前に必要です。開発ワークフローの自動化において最も効果が高いMCPの一つです。

Filesystem MCP：ローカルファイル操作

Filesystem MCPは、Claude Codeに指定したディレクトリ内のファイル読み書き能力を追加します。Claude Code自体もファイル操作は可能ですが、MCP経由で明示的にアクセス範囲を限定することで、セキュリティを確保しつつ柔軟なファイル操作が実現します。

特に、プロジェクト外のドキュメントフォルダやデータフォルダにアクセスさせたい場合に便利です。アクセス可能なディレクトリを限定できるため、意図しないファイルへのアクセスを防げます。

Context7 MCP：ライブラリドキュメントの参照

Context7 MCPは、AIが最新のライブラリドキュメントを参照できるようにするサーバーです。Claude Codeの学習データに含まれない最新バージョンのAPIやフレームワークのドキュメントを、リアルタイムで取得して参照できます。

新しいライブラリの導入時や、バージョンアップに伴うAPI変更への対応時に特に効果を発揮します。古い情報に基づいたコード生成（ハルシネーション）を防ぐ効果もあります。

Claude Code × MCP 実践活用パターン

MCPを活用した実践的なClaude Code活用パターンを紹介します。

開発ワークフローの自動化

GitHub MCP + Playwright MCPを組み合わせると、「Issueの内容を確認→コードを修正→ブラウザで動作確認→テストを実行→PRを作成」という一連の開発ワークフローをClaude Codeに指示するだけで自動化できます。これまで一つ一つ手作業で行っていたタスクが、自然言語の指示だけで完結します。

さらにSlack MCPを追加すれば、作業完了後にSlackチャンネルへ自動通知する仕組みも構築でき、チーム全体の開発効率が向上します。

社内システムとの連携

企業利用では、HubSpot、freee、Salesforce、Jira、LinearなどのMCPサーバーを活用して、Claude Codeを社内システムと接続するパターンが増えています。たとえば「freeeの直近の売上データを取得して、月次レポートのグラフを生成して」といった指示で、経理業務の自動化が実現します。

社内独自のシステムとの連携には、自作MCPサーバーを構築する方法もあります。Python SDKやTypeScript SDKを使って、自社APIをMCPサーバーとして公開すれば、Claude Codeから直接アクセス可能になります。

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

Claude Codeには、自身をMCPサーバーとして起動する機能も備わっています。これにより、Claude DesktopやCursorなどの他のMCPクライアントからClaude Codeの能力を呼び出せるようになります。

設定方法と活用シーン

Claude Code自体をMCPサーバーとして起動するには、「claude mcp serve」コマンドを使用します。Claude Desktopの設定ファイル（claude_desktop_config.json）に、Claude CodeをMCPサーバーとして登録すると、Claude Desktopのチャット画面からClaude Codeのエージェント機能を呼び出せるようになります。

この機能は、Claude Desktopの直感的なUIでClaude Codeのパワフルなコーディング能力を使いたい場合や、複数のMCPサーバーをClaude Desktop経由で統合管理したい場合に便利です。

Claude Code × MCP連携の注意点とベストプラクティス

MCP連携を安全かつ効率的に活用するための注意点を整理します。

トークン消費とパフォーマンスの管理

MCPサーバーを多数追加しすぎると、ツール定義にトークンを大量に消費し、実際の作業に使えるコンテキストウィンドウが狭くなります。必要なMCPサーバーだけを有効化し、不要なサーバーはこまめに無効化（claude mcp remove）する運用を心がけましょう。

プロジェクトごとに必要なMCPサーバーが異なる場合は、projectスコープを活用して、プロジェクト単位で有効なMCPサーバーを切り替える設計が効率的です。

セキュリティとアクセス制御

MCPサーバーはClaude Codeに外部サービスへのアクセス権限を与えるため、APIキーやOAuthトークンの管理は厳重に行う必要があります。特に、projectスコープの.mcp.jsonファイルはGitリポジトリにコミットされる可能性があるため、APIキーを直接記載せず環境変数経由で渡すようにしましょう。

信頼できる公式MCPサーバーのみを使用し、不明な出所のサーバーは導入しないことが基本です。ツールポイズニング攻撃への対策として、MCPサーバーのツール説明文を定期的に確認する習慣も重要です。

まとめ

Claude CodeとMCPの連携により、AIのコーディング能力にGitHub操作、ブラウザ自動化、データベースクエリ、社内システム連携といった強力な拡張能力を追加できます。設定はclaude mcp addコマンド1行で完了し、3つのスコープ（local・project・user）で適用範囲を柔軟に管理できます。

最初に入れるべきMCPサーバーは、Playwright（ブラウザ操作）、GitHub（リポジトリ管理）、Filesystem（ファイル操作）、Context7（ドキュメント参照）の4つです。これらを組み合わせるだけで、開発ワークフローの自動化レベルが大幅に向上します。

MCPサーバーの追加しすぎによるトークン消費と、APIキーのセキュリティ管理には注意が必要です。まずは「claude mcp add playwright -s project — npx -y @playwright/mcp@latest」の1コマンドから始めて、MCP連携の便利さを体感してみてください。