Claude Code MCP連携ガイド — 外部ツールとの統合で開発を加速

MCPとは — AIツールを外部データソースに接続するオープンスタンダード

Model Context Protocol（MCP）は、Anthropicが2024年11月にリリースした、AIツールと外部データソース・サービスを統合するためのオープンスタンダードです。従来、AI開発ツールは独自のプラグインシステムを採用していましたが、MCPは統一プロトコルとして、Claude Code、Claude Desktop、その他AI製品が共通のMCPサーバーを利用できる仕組みを提供します。月間9,700万SDKダウンロード、10,000以上のアクティブサーバーが稼働しており、GitHub、Slack、Notion、Google Drive、Jira、Linear、AWS、GCP、Azureなど主要サービスの公式MCPサーバーが続々リリースされています。MCPにより、Claude Codeは単なるコード生成ツールから、企業の全システムと連携する統合開発ハブへと進化します。

MCPのアーキテクチャ — JSON-RPCベースのクライアント・サーバーモデル

MCPはJSON-RPCをベースとしたクライアント・サーバーアーキテクチャを採用しています。クライアント（Claude Code、Claude Desktop等）はMCPサーバーに接続し、サーバーが提供する3種類の要素——ツール（Tool）、リソース（Resource）、プロンプト（Prompt）——にアクセスします。ツールは「GitHubでIssueを作成する」「Slackにメッセージを送信する」といった実行可能なアクションを提供し、リソースは「Notionデータベースの記事一覧」「Google Driveのファイル」など読み取り可能なデータを表し、プロンプトはテンプレート化された指示を再利用可能にします。MCPサーバーはTypeScript・Python SDKで実装でき、stdio、SSE、WebSocketの3つの通信方式をサポート。ローカル実行とリモート実行の両方に対応しており、セキュリティポリシーに応じて柔軟に展開できます。

claude mcp addコマンド — MCPサーバーの追加と設定ファイル

Claude CodeへのMCPサーバー追加は `claude mcp add <サーバー名>` コマンドで簡単に実行できます。例えば `claude mcp add github` で公式GitHubサーバーがインストールされ、GitHubトークンの入力を求められます。設定は `.claude/settings.json` に保存され、`mcpServers` セクションに各サーバーの接続情報が記録されます。スコープは3段階あり、プロジェクトスコープ（`./claude/settings.json`）は当該リポジトリのみ、ユーザースコープ（`~/.claude/settings.json`）は全プロジェクト、グローバルスコープ（システム全体）はチーム共通設定を管理します。`claude mcp list` で有効なサーバー一覧を確認し、`claude mcp remove <サーバー名>` で削除可能。品川区・港区エリアの開発チームでは、プロジェクトごとに必要なMCPサーバーセットを定義し、チームメンバー間で設定を共有しています。

GitHub MCP統合 — Issue・PR作成とコードサーチの自動化

GitHub MCPサーバーは、Claude CodeからGitHubリポジトリへの直接アクセスを可能にします。`mcp__github__search_repositories` でリポジトリ検索、`mcp__github__create_issue` でIssue作成、`mcp__github__create_pull_request` でPR作成、`mcp__github__get_pull_request` でPR詳細取得が可能。実際の運用では「本番環境でエラーが発生した際、Claude Codeがログを解析し、該当箇所のコードをGitHubから取得して修正PRを自動生成」といったワークフローが実現します。さらに `mcp__github__search_code` でコードベース全体を横断検索し、「この関数を使用している箇所をすべて見つけてリファクタリング」といった大規模変更も自動化。港区・渋谷区エリアのスタートアップでは、GitHub MCPを活用してIssue→実装→PRのサイクルタイムを50%短縮しています。

Slack MCP統合 — チャンネル連携とバグレポート自動処理

Slack MCPサーバーは、Claude CodeとSlackワークスペースを双方向連携します。`mcp__slack__list_channels` でチャンネル一覧取得、`mcp__slack__get_messages` で特定チャンネルのメッセージ取得、`mcp__slack__post_message` でメッセージ送信が可能。実用例として、`#bug-reports` チャンネルに投稿されたバグレポートをClaude Codeが定期的にポーリングし、再現手順を解析して自動修正、完了後に `#eng-notifications` へ通知するワークフローがあります。また、Slackで `@Claude ログイン画面のUIを改善して` とメンションすると、Claude Codeが起動してタスクを実行し、完了後にスレッドへ結果を返信。品川区・港区エリアの開発チームでは、Slack MCPを活用してサポートチームとエンジニアチーム間のコミュニケーションコストを削減しています。

Notion MCP統合 — ドキュメント参照とナレッジベース連携

Notion MCPサーバーは、Claude CodeがNotionワークスペースのページ・データベースを読み書きできるようにします。`mcp__notion__search` でページ検索、`mcp__notion__get_page` でページ内容取得、`mcp__notion__update_page` でページ更新が可能。実務では、「技術仕様書がNotionに保存されており、Claude Codeが仕様書を参照して実装を進める」「APIレスポンス形式をNotionデータベースから取得してバリデーション処理を生成」といった使い方が一般的です。さらに、「Claude Codeが実装したコードの動作説明をNotionの開発ログページに自動記録」する運用も可能。議事録・設計書・ADR（Architecture Decision Records）をNotionで管理する企業では、Notion MCPによりドキュメントとコードの同期が自動化され、渋谷区・港区エリアのプロダクトチームで導入が進んでいます。

AWS/GCP MCP統合 — クラウドリソース管理と自動デプロイ

AWS・GCP公式MCPサーバーは、Claude Codeからクラウドリソースへの直接アクセスを提供します。AWS MCPでは `mcp__aws__list_ec2_instances` でEC2一覧取得、`mcp__aws__get_cloudwatch_logs` でログ取得、`mcp__aws__deploy_lambda` でLambda関数デプロイが可能。GCP MCPでは `mcp__gcp__list_gce_instances`、`mcp__gcp__get_cloud_run_logs`、`mcp__gcp__deploy_cloud_function` が利用できます。実用シーンとして、「本番環境のCloudWatchログでエラーパターンを検出し、該当するLambda関数のコードを修正してデプロイ」「GCEインスタンスのリソース使用率を監視し、スケールアウト判断をClaude Codeが実行」といった自動化が実現。品川区・港区エリアのSaaS企業では、AWS/GCP MCPを活用したインフラ運用自動化で、インシデント対応時間を70%削減しています。

カスタムMCPサーバー作成 — 独自ツール・社内API連携の実装

公式MCPサーバーでカバーできない独自ツール・社内APIは、TypeScript/Python SDKでカスタムMCPサーバーを実装できます。TypeScript SDKは `@modelcontextprotocol/sdk` パッケージを利用し、`MCP.Server` クラスを継承してツール・リソース・プロンプトを定義します。例えば、社内の顧客管理システムAPIをラップしたMCPサーバーを作成すれば、「Claude Code、特定顧客IDの情報を取得して請求書を生成して」といった指示が可能に。Python SDKは `mcp` パッケージで同様に実装でき、データサイエンスチームではPandas・Jupyter連携MCPサーバーを構築してデータ分析自動化を実現しています。カスタムサーバーは社内npmレジストリ・PyPIプライベートリポジトリで配布し、チーム全体で共有。港区・品川区エリアのエンタープライズ企業では、レガシーシステムのAPI群をMCP化して、Claude Codeによるモダナイゼーションを加速しています。

Hooks×MCPの組み合わせ — ツール実行前後の制御とセキュリティフック

Claude CodeのHooks機能とMCPを組み合わせることで、ツール実行前後の制御・監査・セキュリティチェックが可能です。PreToolUseフックはMCPツール実行前に発火し、「本番環境リソースへのアクセスは承認者の許可が必要」といったポリシーを実装できます。PostToolUseフックは実行後に発火し、「GitHub PR作成後にSlackへ通知」「AWS Lambda デプロイ後にDatadogへメトリクス送信」といった後続アクションを自動実行。セキュリティフックでは、機密データを含むMCPリソースへのアクセスをログ記録し、監査トレイルを生成します。実装はCLAUDE.mdまたは `.claude/hooks.json` に記述し、JavaScriptでロジックを定義。品川区・港区エリアの金融・ヘルスケア企業では、Hooks×MCPでコンプライアンス要件を満たしながらClaude Code導入を実現しています。

MCPデバッグとトラブルシューティング — 接続エラー・タイムアウト対策

MCP統合のトラブルシューティングには `claude mcp serve --debug` コマンドが有効です。このモードでは、JSON-RPC通信の詳細ログ・エラースタックトレース・タイムアウト情報が出力されます。よくある問題として、認証トークンの有効期限切れ（GitHub・Slack・Notion）、ファイアウォールによるstdio通信のブロック、サーバー起動スクリプトのパス間違いがあります。`claude doctor` で環境診断を実行し、MCPサーバーの接続状態・バージョン・依存関係を確認できます。タイムアウト対策には、`.claude/settings.json` の `timeout` パラメータを延長（デフォルト30秒→120秒）、または非同期実行モードに切り替えます。コミュニティフォーラム（https://github.com/modelcontextprotocol/servers/issues）では、公式メンテナー・コミュニティメンバーが活発にサポートしており、渋谷区・港区エリアの開発者も多数参加しています。

企業導入のベストプラクティス — アクセス制御・監査ログ・Managed Settings

企業でClaude Code MCP連携を導入する際のベストプラクティスを紹介します。まず、アクセス制御は最小権限の原則に従い、MCPサーバーごとに必要最低限のスコープのみを付与します（例: GitHub MCPは読み取り専用、Slack MCPは特定チャンネルのみ）。監査ログは、Hooksを活用してすべてのMCPツール実行を記録し、Splunk・Datadogへ転送します。Managed Settingsを利用すると、チーム管理者が `.claude/managed-settings.json` を集中管理し、メンバー個別の設定上書きを防ぎます。シークレット管理は環境変数または1Password・HashiCorp Vault連携で実施し、平文での保存を避けます。VPN・プロキシ経由のMCPサーバー接続も設定可能で、オンプレミス環境との統合にも対応。品川区・港区エリアのエンタープライズ企業では、これらベストプラクティスを実装した社内MCP統合ガイドラインを策定し、全社展開を進めています。

品川区・港区エリアの企業様向けMCP導入支援 — オブライトのカスタムMCP開発サービス

オブライトは、品川区・港区・渋谷区エリアを中心に、Claude Code MCP連携の導入支援とカスタムMCPサーバー開発を提供しています。サービス内容は、MCP導入戦略策定（既存ツール棚卸・優先順位付け）、公式MCPサーバーのセットアップとカスタマイズ、社内API・レガシーシステム向けカスタムMCPサーバー開発、Hooks連携によるセキュリティ・監査機能実装、チームトレーニング（ハンズオン・ドキュメント作成）、運用保守サポートまでエンドツーエンドで対応。特に、金融・ヘルスケア・製造業での導入実績が豊富で、コンプライアンス要件を満たしたMCP統合設計を得意としています。無料コンサルティングも実施中ですので、お気軽にお問い合わせください。Claude Code×MCPで、あなたの開発チームの生産性を次のレベルへ引き上げましょう。