Claude Codeの設定 - MCPサーバのソースを表示

== 概要 ==
MCP (Model Context Protocol) は、LLMと外部ツールの統合を標準化したオープンプロトコルであり、AIのUSBと呼ばれる技術標準である。<br>
Anthropic社が開発したこの技術により、Claude Codeは複数の外部システムと自然言語で対話できる。<br>
<br>
MCPを使用することにより、以下に示すメリットが得られる。<br>
* 統一されたインターフェース
*: 複数のツールとサービスを標準化されたプロトコルで接続
* 自然言語による操作
*: イシュートラッカー、データベース、監視データ分析、デザインツール、ワークフロー自動化を自然言語で依頼可能
* 複数サーバの同時接続
*: Claude Codeは複数のMCPサーバを同時に接続して使用可能
* オープンエコシステム
*: コミュニティによって開発された4,000以上のMCPサーバが利用可能
<br>
[[ファイル:Claude Code MCP Architecture 1.png|フレームなし|中央|625x355px]]
<br><br>

== MCPの基本構造 ==
MCPは、MCPクライアント (Claude Code) とMCPサーバ (外部システムへの接続を提供) の間で通信を行うプロトコルである。<br>
<br>
==== MCPサーバとMCPクライアント ====
* MCPクライアント
*: Claude Codeがクライアントとして機能し、MCPサーバに接続する。
*: ユーザーの自然言語リクエストをMCPサーバへのツール呼び出しに変換する。
* MCPサーバ
*: 外部システム (GitHub、データベース、Notionなど) への接続を提供する。
*: ツール、リソース、プロンプトの3つの主要機能を提供する。
<br>
==== トランスポートの種類 ====
MCPサーバは、以下の3つのトランスポート方式で接続される。<br>
<br>
<center>
{| class="wikitable"
|+ トランスポートの種類
! トランスポート !! 推奨度 !! 説明 !! 使用例
|-
| HTTP || 最も推奨 || クラウドベースサービスに広くサポートされる。 || GitHub MCP、Supabase MCP、Zapier MCP
|-
| stdio (標準入出力) || 推奨 || ローカルプロセスとして実行される。<br>システムアクセスが必要なツールに最適。 || Filesystem MCP、Playwright MCP
|-
| SSE (Server-Sent Events) || 非推奨 || 利用可能だが、HTTPへの移行を推奨。 || -
|}
</center>
<br>
==== 接続可能な外部システム ====
MCPサーバを介して以下のシステムに接続できる。<br>
<br>
<center>
{| class="wikitable"
|+ 接続可能な外部システム
! カテゴリ !! 接続可能なシステム
|-
| 開発ツール || GitHub、GitLab、Playwright
|-
| データベース || PostgreSQL、MySQL、Supabase
|-
| ドキュメント管理 || Notion、Google Docs、ファイルシステム
|-
| 検索 || Brave Search、Google Search
|-
| 自動化 || Zapier、n8n
|-
| 監視・デバッグ || Sentry、Datadog
|-
| デザイン || Figma
|}
</center>
<br><br>

== MCPサーバの設定場所 (スコープ) ==
MCPサーバの設定は、3つのスコープで管理される。<br>
<br>
* local (デフォルト)
*: 現在のプロジェクトのみで使用される。
*: 設定ファイル : <u>~/.claude.json</u>
* project
*: プロジェクトルートに配置され、チーム全体で共有可能。
*: 設定ファイル : プロジェクトルートの <u>.mcp.json</u>
* user
*: 全プロジェクトで使用可能なグローバル設定。
*: 設定ファイル : <u>~/.claude.json</u>
<br>
<center>
{| class="wikitable"
|+ MCPサーバ設定ファイルのパス
! スコープ !! 設定ファイルパス !! 用途
|-
| local || ~/.claude.json || 現在のプロジェクトのみ
|-
| project || プロジェクトルート/.mcp.json || チーム共有可能
|-
| user || ~/.claude.json || 全プロジェクトで使用可能
|}
</center>
<br><br>

== MCPサーバのインストール ==
MCPサーバのインストールには、3つの方法がある。<br>
<br>
==== CLIコマンドによるインストール ====
<code>claude mcp add</code> コマンドを実行して、対話的にMCPサーバをインストールできる。<br>
<br>
 # 基本
 claude mcp add --transport http github https://api.githubcopilot.com/mcp/
 
 # stdioトランスポートのインストール
 claude mcp add --transport stdio playwright -- npx -y @playwright/mcp@latest
 
 # スコープを指定したインストール
 claude mcp add --transport http --scope project supabase https://mcp.supabase.com/
<br>
==== 設定ファイルの直接編集 ====
<code>~/.claude.json</code> または <code>.mcp.json</code> を直接編集してMCPサーバを追加できる。<br>
<br>
* HTTPサーバの設定例
*: <syntaxhighlight lang="json">
 {
   "mcpServers": {
     "github": {
       "url": "https://api.githubcopilot.com/mcp/"
     }
   }
 }
 </syntaxhighlight>
*: <br>
* stdioサーバの設定例
*: <syntaxhighlight lang="json">
 {
   "mcpServers": {
     "playwright": {
       "command": "npx",
       "args": ["-y", "@playwright/mcp@latest"]
     }
   }
 }
 </syntaxhighlight>
<br>
==== --mcp-configオプション ====
コマンドライン引数で設定ファイルを指定できる。<br>
<br>
 # カスタム設定ファイルを指定
 claude --mcp-config /path/to/custom-mcp.json
<br>
このオプションにより、プロジェクトごとに異なる設定を使い分けることができる。<br>
<br><br>

== MCPサーバの管理コマンド ==
Claude CodeはMCPサーバの管理のためのCLIコマンドを提供する。<br>
<br>
* <code>claude mcp list</code>
*: 全てのMCPサーバを一覧表示
* <code>claude mcp get <名前></code>
*: 特定のMCPサーバの詳細を取得
* <code>claude mcp add</code>
*: 新しいMCPサーバを追加
* <code>claude mcp remove <名前></code>
*: MCPサーバを削除
* <code>claude mcp add-json</code>
*: JSON構成からMCPサーバを追加
* <code>claude mcp add-from-claude-desktop</code>
*: Claude Desktopの設定からMCPサーバをインポート
<br>
使用例を以下に示す。<br>
 # 全てのMCPサーバを一覧表示
 claude mcp list
 
 # GitHubサーバの詳細を取得
 claude mcp get github
 
 # MCPサーバを削除
 claude mcp remove github
<br><br>

== 設定ファイルの書式 ==
MCPサーバの設定ファイルは、JSON形式で記述される。<br>
<br>
==== HTTP / SSEサーバの設定例 ====
HTTPトランスポートのMCPサーバ設定例を以下に示す。<br>
<br>
 <syntaxhighlight lang="json">
 {
   "mcpServers": {
     "github": {
       "url": "https://api.githubcopilot.com/mcp/",
       "headers": {
         "Authorization": "Bearer ${GITHUB_TOKEN}"
       }
     },
     "supabase": {
       "url": "https://mcp.supabase.com/"
     }
   }
 }
 </syntaxhighlight>
<br>
==== stdioサーバの設定例 ====
stdioトランスポートのMCPサーバ設定例を以下に示す。<br>
<br>
 <syntaxhighlight lang="json">
 {
   "mcpServers": {
     "playwright": {
       "command": "npx",
       "args": ["-y", "@playwright/mcp@latest"]
     },
     "filesystem": {
       "command": "npx",
       "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/directory"]
     },
     "db": {
       "command": "npx",
       "args": ["-y", "@bytebase/dbhub", "--dsn", "postgresql://user:pass@localhost:5432/mydb"]
     }
   }
 }
 </syntaxhighlight>
<br>
==== 環境変数の設定 ====
MCPサーバの設定には環境変数を使用できる。<br>
<br>
 <syntaxhighlight lang="json">
 {
   "mcpServers": {
     "github": {
       "url": "https://api.githubcopilot.com/mcp/",
       "env": {
         "GITHUB_TOKEN": "your_github_token_here"
       }
     },
     "db": {
       "command": "npx",
       "args": ["-y", "@bytebase/dbhub", "--dsn", "${DATABASE_URL}"],
       "env": {
         "DATABASE_URL": "postgresql://user:pass@localhost:5432/mydb"
       }
     }
   }
 }
 </syntaxhighlight>
<br>
認証情報は環境変数で管理し、<u>.mcp.json</u>ファイルを<u>.gitignore</u>に追加することを推奨する。<br>
<br>
==== HTTPヘッダの設定 ====
HTTPトランスポートのMCPサーバには、カスタムヘッダを設定できる。<br>
<br>
 <syntaxhighlight lang="json">
 {
   "mcpServers": {
     "custom-api": {
       "url": "https://api.example.com/mcp/",
       "headers": {
         "Authorization": "Bearer ${API_TOKEN}",
         "X-Custom-Header": "custom-value"
       }
     }
   }
 }
 </syntaxhighlight>
<br><br>

== 人気のMCPサーバ一覧 ==
コミュニティによって開発された人気のMCPサーバを示す。<br>
<br>
==== 開発・コード管理 ====
===== GitHub MCP =====
GitHubリポジトリ、Pull Request、Issueを管理する。<br>
<br>
* 機能
*: リポジトリの作成・管理、PR作成・レビュー、Issue管理、コードの検索
* 設定方法
*: <pre>claude mcp add --transport http github https://api.githubcopilot.com/mcp/</pre>
<br>
===== Playwright MCP =====
ブラウザ自動化とテストを実行する。<br>
<br>
* 機能
*: ブラウザ操作の自動化、Webページのテスト、スクリーンショット撮影、スクレイピング
* 設定方法
*: <pre>claude mcp add --transport stdio playwright -- npx -y @playwright/mcp@latest</pre>
<br>
==== データベース ====
===== PostgreSQL MCP =====
PostgreSQLデータベースのクエリとスキーマ検査を実行する。<br>
<br>
* 機能
*: SQLクエリの実行、スキーマ検査、テーブル情報の取得、データベース管理
* 設定方法
*: <pre>claude mcp add --transport stdio db -- npx -y @bytebase/dbhub --dsn "postgresql://user:pass@localhost:5432/mydb"</pre
<br>
===== Supabase MCP =====
Supabaseフルエコシステムへのアクセスを提供する。<br>
<br>
* 機能
*: データベース操作、認証、ストレージ、エッジ関数の管理
* 設定方法
*: <pre>claude mcp add --transport http supabase https://mcp.supabase.com/</pre>
<br>
==== ファイル・ドキュメント ====
===== Filesystem MCP =====
ローカルファイルシステムの操作を実行する。<br>
<br>
* 機能
*: ファイルの読み書き、ディレクトリの作成・削除、ファイル検索、ファイル情報の取得
* 設定方法
 npm install -g @modelcontextprotocol/server-filesystem
 claude mcp add --transport stdio filesystem -- npx -y @modelcontextprotocol/server-filesystem /path/to/allowed/directory
<br>
===== Context7 MCP =====
最新の技術ドキュメントを取得する。<br>
<br>
* 機能
*: 公式ドキュメントの検索、技術情報の取得、最新のライブラリ情報の参照
* 設定方法
*: Context7の公式サイトから設定手順を参照
<br>
===== Notion MCP =====
Notionワークスペースとの連携を提供する。<br>
<br>
* 機能
*: ページの作成・編集、データベースの操作、コンテンツの検索
* 設定方法
*: <pre>claude mcp add --transport http notion https://mcp.notion.com/mcp</pre>
<br>
==== 検索 ====
===== Brave Search MCP =====
Brave検索エンジンを使用してWeb検索を実行する。<br>
<br>
* 機能
*: Web検索、ニュース検索、画像検索
* 無料枠
*: 月2,000クエリ
* 設定方法
*: Brave Search APIキーを取得して設定
<br>
==== 自動化・生産性 ====
===== Zapier MCP =====
8,000以上のアプリとの連携を提供する。<br>
<br>
* 機能
*: ワークフローの自動化、アプリ間のデータ連携、トリガーとアクションの設定
* 設定方法
*: <pre>claude mcp add --transport http zapier https://mcp.zapier.com/</pre>
<br>
===== n8n MCP =====
オープンソースの自動化プラットフォームを提供する。<br>
<br>
* 機能
*: ワークフローの作成・実行、複数サービスの連携、カスタムノードの作成
* GitHub Star
*: 10万以上
* 設定方法
*: n8nの公式サイトから設定手順を参照
<br>
==== 監視・デバッグ ====
===== Sentry MCP =====
エラー追跡と監視を実行する。<br>
<br>
* 機能
*: エラーログの分析、パフォーマンス監視、問題の診断
* 設定方法
*: <pre>claude mcp add --transport http sentry https://mcp.sentry.dev/mcp</pre>
<br>
==== デザイン ====
===== Figma MCP =====
Figma Dev Modeとの連携を提供する。<br>
<br>
* 機能
*: デザインファイルの取得、コンポーネント情報の参照、デザイントークンの抽出
* 設定方法
*: Figmaの公式サイトから設定手順を参照
<br>
==== 思考支援 ====
===== Sequential Thinking MCP =====
構造化された問題解決を支援する。<br>
<br>
* 機能
*: 複雑な問題を段階的に分解、推論プロセスの可視化、意思決定の支援
* 設定方法
*: <pre>claude mcp add --transport stdio sequential-thinking -- npx -y @modelcontextprotocol/server-sequential-thinking</pre>
<br>
==== MCPサーバの検索サイト ====
コミュニティ主導のMCPサーバディレクトリを以下に示す。<br>
<br>
* Smithery (smithery.ai)
*: 4,000以上のMCPサーバが登録されたディレクトリ
*: カテゴリ別検索、人気順ソート、詳細なドキュメント
* mcp.so
*: コミュニティ主導のMCPサーバディレクトリ
*: 日本語対応、カテゴリ別分類、使用例の提供
* mcp-awesome.com
*: 1,200以上の品質検証済みMCPサーバ
*: 厳選されたサーバ、詳細なレビュー、インストール手順
<br><br>

== リソース参照 (@メンション) ==
MCPサーバが提供するリソースを @メンションで参照できる。<br>
<br>
リソース参照の例:<br>
* @github/issue/123
*: GitHubのIssue #123を参照
* @sentry/error/latest
*: Sentryの最新エラーログを参照
* @postgres/table/users
*: PostgreSQLのusersテーブルを参照
* @notion/page/project-overview
*: Notionのプロジェクト概要ページを参照
<br>
リソース参照により、MCPサーバが管理する外部システムのデータを直接参照できる。<br>
<br><br>

== MCPスラッシュコマンド (/mcp) ==
セッション内でMCPサーバのステータスを確認するコマンドである。<br>
<br>
 # MCPサーバのステータス確認
 /mcp
<br>
このコマンドにより、以下に示す情報が表示される。<br>
* 接続中のMCPサーバ一覧
* 各サーバの接続状態
* 利用可能なツール
* リソースの数
<br><br>

== コンテキスト最適化 (Tool Search) ==
Tool Searchは、MCPサーバが提供する多数のツールを動的に検索してコンテキスト消費を削減する機能である。<br>
<br>
* 有効化方法
*: <syntaxhighlight lang="sh">
 export ENABLE_TOOL_SEARCH=true
 </syntaxhighlight>
<br>
この機能により、以下に示すメリットが得られる。<br>
* コンテキストウィンドウの節約
*: 全てのツールをコンテキストに含めるのではなく、必要なツールのみを動的に検索
* パフォーマンスの向上
*: 不要なツール情報をスキップすることで応答速度が向上
* 大規模MCPサーバの実用化
*: 数百のツールを提供するMCPサーバでも効率的に使用可能
<br><br>

== Claude CodeをMCPサーバとして使用 ==
Claude Code自体をMCPサーバとして他のアプリケーションから使用できる。<br>
<br>
* 設定例
*: この設定により、他のMCPクライアント (Claude Desktopなど) からClaude Codeの機能を使用できる。
*: <syntaxhighlight lang="json">
 {
   "mcpServers": {
     "claude_code": {
       "command": "/usr/local/bin/claude",
       "args": ["mcp", "serve"],
       "env": {}
     }
   }
 }
 </syntaxhighlight>
<br><br>

== 組織でのMCP管理 ==
組織でMCPサーバを管理するための2つの方法がある。<br>
<br>
==== 排他的制御 (managed-mcp.json) ====
<u>managed-mcp.json</u>ファイルを使用すると、組織が承認したMCPサーバのみを使用するように強制できる。<br>
<br>
設定ファイルのパス:<br>
* Linux/WSL
*: <u>/etc/claude-code/managed-mcp.json</u>
* Windows
*: <u>C:\Program Files\ClaudeCode\managed-mcp.json</u>
* MacOS
*: <u>/Library/Application Support/ClaudeCode/managed-mcp.json</u>
<br>
* 設定例
*: この設定により、ユーザーは <code>managed-mcp.json</code> で定義されたMCPサーバのみを使用できる。
*: <syntaxhighlight lang="json">
 {
   "mcpServers": {
     "github": {
       "url": "https://api.githubcopilot.com/mcp/"
     },
     "sentry": {
       "url": "https://mcp.sentry.dev/mcp"
     }
   }
 }
 </syntaxhighlight>
<br>
==== ポリシーベース制御 (allowedMcpServers / deniedMcpServers) ====
許可または拒否するMCPサーバのリストを定義できる。<br>
<br>
* 設定例
*: この設定により、組織が承認したMCPサーバのみを使用でき、特定のサーバを明示的に拒否できる。
*: <syntaxhighlight lang="json">
 {
   "allowedMcpServers": [
     "github",
     "sentry",
     "supabase"
   ],
   "deniedMcpServers": [
     "experimental-server"
   ]
 }
 </syntaxhighlight>
<br><br>

== セキュリティ上の注意事項 ==
MCPサーバを使用する際は、以下のセキュリティ上の注意事項を遵守する必要がある。<br>
<br>
==== プロンプトインジェクション対策 ====
MCPサーバが返すデータを盲目的に信頼しないこと。<br>
<br>
* リスク
*: 悪意のあるMCPサーバが、プロンプトインジェクション攻撃を仕掛ける可能性がある。
*: 返されたデータに埋め込まれた指示によって、意図しない動作が引き起こされる。
* 対策
*: 信頼できるMCPサーバのみを使用する。
*: MCPサーバが返すデータを検証する。
*: 重要な操作の前にユーザーに確認を求める。
<br>
==== 信頼できるサーバのみ使用 ====
公式MCPサーバまたはコミュニティで検証されたサーバのみを使用すること。<br>
<br>
* 推奨サーバ
*: Anthropic公式のMCPサーバ
*: GitHub、Sentry、Supabaseなど大手企業が提供するサーバ
*: Smithery、mcp.soで高評価のサーバ
* 避けるべきサーバ
*: 出所不明のサーバ
*: ドキュメントが不十分なサーバ
*: コミュニティで問題が報告されているサーバ
<br>
==== 認証情報の管理 ====
認証情報は環境変数で管理し、設定ファイルをバージョン管理から除外すること。<br>
<br>
 # .gitignoreの設定
 .mcp.json
 .claude.json
<br>
環境変数による認証情報の管理例を以下に示す。<br>
この設定により、<code>${GITHUB_TOKEN}</code> は、環境変数から自動的に展開される。<br>
<br>
 <syntaxhighlight lang="json">
 {
   "mcpServers": {
     "github": {
       "url": "https://api.githubcopilot.com/mcp/",
       "headers": {
         "Authorization": "Bearer ${GITHUB_TOKEN}"
       }
     }
   }
 }
 </syntaxhighlight>
<br><br>

== トラブルシューティング ==
MCPサーバが正しく動作しない場合の対処法を以下に示す。<br>
<br>
==== MCPサーバが認識されない ====
設定ファイルが正しい場所に配置されているか確認する。<br>
<br>
 # 設定ファイルの確認
 cat ~/.claude.json
 cat .mcp.json
<br>
JSON構文が正しいか確認する。<br>
<br>
 # JSON構文の検証
 jq . ~/.claude.json
<br>
Claude Codeを再起動する。<br>
<br>
 # Claude Codeの再起動
 claude
<br>
==== MCPサーバへの接続に失敗する ====
MCPサーバのURLが正しいか確認する。<br>
<br>
 # MCPサーバの詳細を確認
 claude mcp get github
<br>
環境変数が正しく設定されているか確認する。<br>
<br>
 # 環境変数の確認
 echo $GITHUB_TOKEN
<br>
ネットワーク接続を確認する。<br>
<br>
 # MCPサーバへの接続テスト
 curl https://api.githubcopilot.com/mcp/
<br>
==== stdioサーバが起動しない ====
コマンドパスが正しいか確認する。<br>
<br>
 # npxの確認
 which npx
<br>
Windowsでは <code>cmd /c</code> ラッパーを使用する。<br>
<br>
 # Windows用の設定
 claude mcp add --transport stdio my-server -- cmd /c npx -y @some/package
<br>
==== タイムアウトエラーが発生する ====
環境変数 <code>MCP_TIMEOUT</code> を設定してタイムアウトを延長する。<br>
<br>
 # タイムアウトを10秒に設定
 export MCP_TIMEOUT=10000
<br>
==== 出力トークンが多すぎる ====
環境変数 <code>MAX_MCP_OUTPUT_TOKENS</code> を設定して最大出力トークンを調整する。<br>
<br>
 # 最大出力トークンを50,000に設定
 export MAX_MCP_OUTPUT_TOKENS=50000
<br><br>

== 参考リンク ==
* [https://code.claude.com/docs/ja/mcp Claude Code公式ドキュメント - MCP]
* [https://modelcontextprotocol.io/ Model Context Protocol公式サイト]
* [https://github.com/modelcontextprotocol/servers MCP公式サーバリポジトリ]
* [https://github.com/wong2/awesome-mcp-servers Awesome MCP Servers]
* [https://smithery.ai/ Smithery - MCPサーバディレクトリ]
* [https://mcp.so/ja mcp.so - MCPサーバ検索]
* [https://mcp-awesome.com/ mcp-awesome.com - 厳選MCPサーバ]
<br><br>


{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Claude Code,MCP,Model Context Protocol,AI,Anthropic,Development,Programming,SUSE,Linux
|description={{PAGENAME}} - Claude CodeのMCPサーバ設定に関する手順
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:設定]]