Claude Codeから外部サービスを直接操作する
MCP（Model Context Protocol）は、Claude Codeから外部ツール・データベース・APIを直接操作するための標準プロトコルです。 たとえば、ブラウザの自動操作、外部ドキュメントの参照、図の生成など、 Claude Code単体ではできない操作を「MCPサーバー」を介して実現します。
イメージとしては、Claude Codeに「新しい道具」を追加するプラグインの仕組みです。 MCPサーバーを接続するだけで、Claudeがそのツールの機能を自然言語で呼び出せるようになります。
Anthropic社のBoris Cherny氏も「Claude Codeは、あなたのすべてのツールを使える。 Slack、BigQuery、Sentry、ブラウザ......MCPで接続すればClaudeがそのまま操作してくれる」と述べています。 コードを書くだけでなく、開発に関わるあらゆる外部システムとの連携が可能になるのがMCPの本質です。
MCPサーバーの設定は、用途に応じて3つの場所で管理できます。
// .mcp.json（プロジェクトルートに配置）
{
"mcpServers": {
"context7": {
"command": "npx",
"args": ["-y", "@upstash/context7-mcp"]
},
"playwright": {
"command": "npx",
"args": ["-y", "@playwright/mcp"]
}
}
}サーバータイプは2種類あります。stdioはローカルプロセス（npx, pythonなど）として起動するタイプ、httpはリモートURLのエンドポイントに接続するタイプです。 日常的に使うのはstdioタイプがほとんどです。
「MCPサーバーを追加したいが、何をすればいいかわからない」という声をよく聞きます。 ここでは初めてMCPサーバーを追加する場合のステップバイステップの手順を解説します。
最も簡単な方法はclaude mcp addコマンドです。 設定ファイルを手で編集する必要がなく、コマンド1つでサーバーが登録されます。
# プロジェクトスコープでContext7を追加
claude mcp add context7 -s project -- npx -y @upstash/context7-mcp
# ユーザースコープ（全プロジェクト共通）でPlaywrightを追加
claude mcp add playwright -- npx -y @playwright/mcp-s projectを付けるとプロジェクト単位（.mcp.json）に追加されます。 省略するとユーザーレベル（~/.claude.json）に追加され、すべてのプロジェクトで使えるようになります。
サーバーを追加したら、Claude Codeを起動して接続状況を確認します。
# 現在登録されているMCPサーバーの一覧と状態を確認
claude mcp list正常に接続されていれば、サーバー名とそのステータスが表示されます。 Claude Codeのセッション内で/mcpと入力しても、接続中のMCPサーバーを確認できます。
接続が確認できたら、実際にそのMCPサーバーの機能を呼び出してみます。 たとえばContext7なら「Next.jsの最新APIを調べて」、Playwrightなら「localhost:3000を開いてスクリーンショットを撮って」と指示すれば、 MCPサーバーが呼び出されたことがターミナル上に表示されます。
プロジェクトで使うMCPサーバーが決まったら、.mcp.jsonをリポジトリルートに作成してコミットします。 チームメンバーがリポジトリをcloneするだけで同じMCP構成が使えるようになります。
// .mcp.json — チームで共有するMCP設定
{
"mcpServers": {
"context7": {
"command": "npx",
"args": ["-y", "@upstash/context7-mcp"]
},
"playwright": {
"command": "npx",
"args": ["-y", "@playwright/mcp"]
}
}
}APIキーが必要なサーバーの場合: .mcp.jsonに直接キーを書かないでください。 環境変数の展開構文${API_KEY}を使えば、 各メンバーが自分の.envや環境変数でキーを管理できます。
// 環境変数を使ったAPIキーの安全な管理
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
}
}
}
}私が実際に使って効果を感じているMCPサーバーをカテゴリ別に紹介します。 さらに、チーム開発やサービス連携で活躍するサーバーも追加で取り上げます。
.mcp.jsonにSlack MCPを入れてチーム共有しており、 「Slackのバグ報告スレッドをClaudeに貼って"fix"と言うだけ。コンテキストスイッチがゼロになった」と述べています。// 外部サービス連携MCPの設定例
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
}
},
"slack": {
"command": "npx",
"args": ["-y", "@anthropic/slack-mcp"],
"env": {
"SLACK_BOT_TOKEN": "${SLACK_BOT_TOKEN}"
}
}
}
}Boris Cherny氏のチームではBigQuery CLIをClaude Codeから直接叩いてデータ分析を行っています。 「SQLを自分で書かなくなって6か月以上経つ」とのこと。 MCPやCLIを通じたデータベース連携は、開発効率を大きく変えるカテゴリです。
MCPは単体で使うより、複数のツールを組み合わせたワークフローの中で真価を発揮します。 ここでは、私が実際に行っている3つのワークフローを具体的に紹介します。
GitHub MCPを使えば、Pull Requestの内容確認から修正提案までをClaude Code内で一気通貫で行えます。
ブラウザでGitHubを開く→コードエディタに戻る→また確認......というコンテキストスイッチが完全になくなります。 Slack MCPと組み合わせれば、「Slackに来たバグ報告 → Issue確認 → 修正 → PR」まで一連の流れで処理できます。
Supabase MCPを使ったデータベース中心の開発ワークフローです。
Supabase Dashboardとターミナルとエディタを3つ開いていた作業が、Claude Codeの1つのセッションで完結します。 特にマイグレーションの生成と適用が対話的にできるのは、スキーマ設計の試行錯誤が多いフェーズで威力を発揮します。
PlaywrightまたはChrome DevTools MCPを使ったUI修正のワークフローです。
Claudeにブラウザを渡さずにWebコードを書かせるのは、 「ブラウザを使わずにWebサイトを作れ」と言っているようなものです。 実際の画面を見ながら反復修正できるかどうかで、フロントエンドの完成度は大きく変わります。
MCPサーバーは便利ですが、入れすぎると逆効果になります。 これは感覚論ではなく、Claude Codeのアーキテクチャに起因する構造的な問題です。
各MCPサーバーを接続すると、そのサーバーが提供する全ツールの定義（名前・説明・パラメータスキーマ）が システムプロンプトに注入されます。 つまり、MCPサーバーが増えるほど、Claudeが毎回読まなければならない「命令」の量が増えるのです。
Instruction Budgetとの関係: コンテキスト管理（#16）で解説するInstruction Budget（命令バジェット）によると、 フロンティアLLMが安定的に従える命令数には上限があります（目安: 15〜25個程度）。 CLAUDE.mdのルール、settings.jsonの権限設定、MCPのツール定義......これらすべてが「命令」としてカウントされます。 MCPサーバーを10個入れればツール定義だけで数十の命令を消費し、 本来の作業指示に使えるバジェットが圧迫されます。
Redditでも「15個のMCPサーバーを入れたが、実際に使うのは4個だけだった」という報告が 682件の賛同を得ています。私自身も同じ経験をしました。
実際に私が一時期導入していたデザイン系のMCPサーバーは、 使用頻度が低いにもかかわらずコンテキストを圧迫していたため、外す判断をしました。実務で頻繁に使うものだけを残すのが正解です。 目安として、常時接続するのは4〜5個までに抑えることをおすすめします。
もしプロジェクトごとに必要なサーバーが異なる場合は、 ユーザースコープには最小限（2〜3個）だけ置き、 プロジェクトスコープの.mcp.jsonで追加するという使い分けが有効です。 Sub-agentに専用のMCPを持たせる方法も、メインのコンテキストを節約する手段になります。
MCPサーバーは外部ツールとの接続口になるため、セキュリティ設定が重要です。 settings.jsonでツールごとに細かく権限を制御できます。
// settings.json — MCP権限制御
{
"permissions": {
"allow": [
"mcp__context7__*", // Context7の全ツールを許可
"mcp__playwright__browser_snapshot" // Playwrightはスナップショットのみ許可
],
"deny": [
"mcp__dangerous-server__*" // 危険なサーバーの全ツールを拒否
]
}
}MCPツールの権限はmcp__サーバー名__ツール名の形式で指定します。 ワイルドカード（*）でサーバー内の全ツールを一括制御することも、 特定のツールだけを許可することもできます。
.mcp.jsonに定義されたサーバーは、初回接続時にユーザーの承認が求められます。 settings.jsonで事前に承認・拒否を設定しておくことで、チーム運用が円滑になります。
// settings.json — MCP承認の制御
{
"enableAllProjectMcpServers": true, // .mcp.jsonの全サーバーを自動承認
"enabledMcpjsonServers": ["context7"], // 特定サーバーだけ自動承認
"disabledMcpjsonServers": ["risky-server"] // 特定サーバーを拒否
}enableAllProjectMcpServers: trueはチーム内で信頼済みの.mcp.jsonを使う場合に便利です。 外部のOSSリポジトリを開く際は、不明なMCPサーバーが自動承認されないよう注意してください。
Sub-agent（サブエージェント）を使う場合は、エージェント定義ファイルのmcpServersフィールドでエージェント固有のMCPサーバーを設定できます。 メインのClaude Codeとは異なるMCP構成を持たせることで、 権限の分離と最小権限の原則を実現できます。
CLIからMCPサーバーを管理する主要コマンドを紹介します。
# プロジェクトスコープでContext7を追加
claude mcp add context7 -s project -- npx -y @upstash/context7-mcp
# プロジェクトスコープでPlaywrightを追加
claude mcp add playwright -s project -- npx -y @playwright/mcp
# 環境変数付きでGitHub MCPを追加
claude mcp add github -s project -e GITHUB_PERSONAL_ACCESS_TOKEN=${GITHUB_TOKEN} -- npx -y @modelcontextprotocol/server-github-s projectでプロジェクト単位の設定に追加します。 省略するとユーザーレベル（全プロジェクト共通）に追加されます。-eで環境変数を渡すこともできます。--の後にMCPサーバーの起動コマンドを指定します。
# 現在設定されているMCPサーバーを一覧表示
claude mcp list# Context7を削除
claude mcp remove context7MCPサーバーの追加・削除は即座に反映されます。 Claude Codeを再起動する必要はなく、次のターンから新しいMCP構成が使われます。
MCPサーバーは便利ですが、接続や動作で問題が起きることがあります。 よくある問題と対処法をまとめます。
最も多いトラブルです。以下を順番に確認してください。
npx -y パッケージ名をターミナルで直接実行して、エラーが出ないか確認するnode -vで確認# MCPサーバーの起動を手動でテスト
npx -y @upstash/context7-mcp
# エラーが出る場合はキャッシュクリアも試す
npm cache clean --forceGitHub MCPやSlack MCPなど、APIトークンが必要なサーバーで起きやすいエラーです。
.mcp.jsonで${GITHUB_TOKEN}と書いている場合、 そのシェルセッションにGITHUB_TOKENがexportされているか確認するrepoスコープが必要。 Slackならchannels:readやchat:writeなどのBot Token Scopeが必要MCPサーバーの応答が遅い、またはハングする場合があります。
MCPサーバーは接続されているのに、Claudeが「そのツールは使えない」と答える場合があります。
mcp__サーバー名__*がdenyに入っていると全ツールが使えないclaude mcp listでステータスを確認。disconnectedになっている場合はサーバーの再起動が必要