MCP サーバーを管理・共有する
スコープでサーバーを整理し、チームと共有する
⏱ 想定 ~5 分
01 · 読む
MCP サーバーを追加するときは、scope（スコープ） を選んで、誰がそのサーバーを見られるか、どこに保存されるかを決めます。
Local（デフォルト）——プライベート、現在のプロジェクトでのみ有効。プロジェクトパスごとに ~/.claude.json に保存されます。個人開発用のサーバーや、機密性のある認証情報を持つサーバーに使います。
Project ——リポジトリのルートにある .mcp.json を通じてチームと共有します。git にコミットすれば、リポジトリをクローンする全員が同じサーバーを得られます。チーム標準のツールにはこれを使います。
User ——あなたのすべてのプロジェクトで使えます。~/.claude.json に保存されます。どこでも使う個人ツール（GitHub や個人データベースなど）に向いています。
ポイントまとめ
- Local（デフォルト）：プライベート、現在のプロジェクトのみ
- Project：リポジトリ内の .mcp.json でチームと共有、git にコミット
- User：個人用、あなたのすべてのプロジェクトで利用可能
- --scope local|project|user で選択します
02 · コード例
--scope フラグでサーバー設定の保存場所を制御します。
Local スコープ（デフォルト——あなただけ、このプロジェクトのみ）
claude mcp add --transport http stripe https://mcp.stripe.com
Project スコープ（git でチームと共有）
claude mcp add --transport http paypal --scope project https://mcp.paypal.com/mcp
User スコープ（あなた、すべてのプロジェクト）
claude mcp add --transport http github --scope user https://api.githubcopilot.com/mcp/
Local がデフォルトです——--scope local を付ける必要はありません。Project スコープはリポジトリに .mcp.json を作成し、チームメンバーが pull すると受け取れます。User スコープはホームディレクトリの設定に置かれ、どこに行っても付いてきます。
03 · コード例
--scope project を使うと、Claude Code はリポジトリのルートに .mcp.json ファイルを作成します。中身はこんな感じです——git にコミットできます。
.mcp.json（リポジトリにコミットする）
{
"mcpServers": {
"github": {
"type": "http",
"url": "https://api.githubcopilot.com/mcp/"
},
"db": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@bytebase/dbhub", "--dsn", "${DATABASE_URL}"],
"env": {
"DATABASE_URL": "${DATABASE_URL}"
}
}
}
}
${DATABASE_URL} の構文に注目してください——環境変数は実行時に展開されるので、シークレットを露出させずに設定を共有できます。チームメンバーはそれぞれ自分の環境で DATABASE_URL を設定します。ファイル構造は Claude Code が自動で読み取る標準フォーマットに従います。
04 · 読む
サーバーをセットアップしたあとは、いくつかのシンプルなコマンドで管理します。
claude mcp list ですべてのサーバーを表示。claude mcp get <name> で個別サーバーの詳細を表示。claude mcp remove <name> でサーバーを削除します。
Claude Code 内で /mcp と入力すれば、サーバーのステータス確認、OAuth サーバーへの認証、接続トラブルの解消ができます。サーバーが応答しないときは、まず /mcp で診断するのが基本です。
ポイントまとめ
- claude mcp list ——設定済みのサーバーをすべて表示
- claude mcp get <name> ——個別サーバーの詳細
- claude mcp remove <name> ——サーバーを削除
- Claude Code 内の /mcp ——ステータス、認証、トラブルシューティング
05 · クイズ
チーム全員が同じ Sentry MCP サーバーを使う必要があります。git にコミットして、新しいメンバーが自動で受け取れるように設定したいです。どのスコープを使いますか？
- Local（デフォルト）
- Project
- User
- Global
06 · ドラッグ分類
セットアップする MCP サーバーが 3 つあります。それぞれを必要とする人に合わせて、適切なスコープにマッチさせてください。
（このセクションはインタラクティブです — JavaScript を有効にしてください。）
⚠ 全機能のインタラクティブ体験には JavaScript が必要です。JavaScript を有効にして再読み込みしてください。
※ このサイトは独立した教育プロジェクトで、Anthropic の公式製品ではありません。Claude™ は Anthropic, PBC の商標です。