mcp-server-manager

MCP サーバー マネージャー

概要

MCP（Model Context Protocol）サーバーは、Claude Code を外部のツール、データベース、API に接続します。このスキルでは、claude mcp コマンドラインインターフェースを使用して MCP サーバーをインストール、設定、管理する方法を説明します。

クイックリファレンス

基本的なコマンド

設定済みのすべての MCP サーバーを一覧表示します：

claude mcp list

特定のサーバーの詳細を取得します：

claude mcp get <server-name>

サーバーを削除します：

claude mcp remove <server-name>

サーバーのステータスを確認します（Claude Code 内から）：

/mcp

MCP サーバーの追加

トランスポートの種類

MCP サーバーでは、3 種類のトランスポートプロトコルを使用します。サーバーの種類に応じて、適切なトランスポートを選択してください。

HTTP トランスポート（リモートサーバー）

HTTP エンドポイントを提供するクラウドベースのサービス向け：

# Basic syntax
claude mcp add --transport http <name> <url>

# Example: Add Notion server
claude mcp add --transport http notion https://mcp.notion.com/mcp

# With authentication header
claude mcp add --transport http secure-api https://api.example.com/mcp \
  --header "Authorization: Bearer YOUR_TOKEN"

SSE トランスポート（Server-Sent Events）

SSE プロトコルを使用するリモートサーバー向け：

# Basic syntax
claude mcp add --transport sse <name> <url>

# Example: Add Webflow server
claude mcp add --transport sse webflow https://mcp.webflow.com/sse

# With API key header
claude mcp add --transport sse private-api https://api.company.com/sse \
  --header "X-API-Key: YOUR_KEY"

Stdio トランスポート（ローカルプロセス）

stdio 通信を使用するローカルプロセスとして実行されるサーバー向け：

# Basic syntax
claude mcp add --transport stdio <name> [--env KEY=VALUE ...] -- <command> [args...]

# Example: Add Airtable server
claude mcp add --transport stdio airtable \
  --env AIRTABLE_API_KEY=YOUR_KEY \
  -- npx -y airtable-mcp-server

# Example: Add local Python server
claude mcp add --transport stdio custom-db \
  --env DB_URL=postgresql://localhost/mydb \
  -- python3 /path/to/server.py

重要：環境変数の終わりとコマンドの開始位置を示すため、コマンドの前に -- 区切り文字を使用してください。

設定スコープ

MCP サーバーは、次の 3 つのスコープで設定できます。

ローカルスコープ（デフォルト）

現在のプロジェクトディレクトリ内でのみ有効です。次の用途に適しています：

• 個人の開発サーバー
• 実験的な設定
• 機密性の高い認証情報を持つサーバー

# Local scope (default)
claude mcp add --transport http stripe https://mcp.stripe.com

# Explicitly specify local scope
claude mcp add --transport http stripe --scope local https://mcp.stripe.com

プロジェクトスコープ

プロジェクトルートの .mcp.json を通じてチームメンバーと共有します。次の用途に適しています：

• チームで共有するサーバー
• プロジェクト固有のツール
• バージョン管理された設定

# Add project-scoped server
claude mcp add --transport http paypal --scope project https://mcp.paypal.com/mcp

.mcp.json を作成または更新します：

{
  "mcpServers": {
    "paypal": {
      "type": "http",
      "url": "https://mcp.paypal.com/mcp"
    }
  }
}

セキュリティに関する注意：Claude Code は、プロジェクトスコープのサーバーを使用する前に承認を求めます。次のコマンドで承認をリセットします：

claude mcp reset-project-choices

ユーザースコープ

マシン上のすべてのプロジェクトで使用できます。次の用途に適しています：

• 個人用のユーティリティサーバー
• 複数のプロジェクトで使用する開発ツール
• 頻繁に使用するサービス

# Add user-scoped server
claude mcp add --transport http hubspot --scope user https://mcp.hubspot.com/anthropic

スコープの優先順位

同じ名前のサーバーが複数のスコープに存在する場合： ローカル > プロジェクト > ユーザー

認証

OAuth 2.0（リモートサーバー）

多くのリモート MCP サーバーは OAuth を使用します。認証の流れ：

1. claude mcp add を使用してサーバーを追加します
2. 初回使用時に OAuth のブラウザーフローが開始されます
3. ブラウザーで認証を許可します
4. 認証情報は ~/.mcp-auth/ に保存されます

Webflow を使用した例：

# Add server
claude mcp add --transport sse webflow https://mcp.webflow.com/sse

# Check status - shows "⚠ Needs authentication"
claude mcp list

# Within Claude Code, trigger OAuth
# Ask: "List my Webflow sites"
# Browser opens for authorization

OAuth 認証情報をリセットします：

rm -rf ~/.mcp-auth

API キーとヘッダー

API キーまたはカスタムヘッダーが必要なサーバーの場合：

# Bearer token
claude mcp add --transport http api-server https://api.example.com/mcp \
  --header "Authorization: Bearer YOUR_TOKEN"

# API key header
claude mcp add --transport sse service https://service.com/sse \
  --header "X-API-Key: YOUR_KEY"

# Multiple headers
claude mcp add --transport http api https://api.example.com/mcp \
  --header "Authorization: Bearer TOKEN" \
  --header "X-Custom-Header: VALUE"

環境変数（Stdio サーバー）

機密性の高い認証情報は環境変数を介して渡します：

claude mcp add --transport stdio database \
  --env DB_PASSWORD=secret123 \
  --env API_KEY=key456 \
  -- python3 /path/to/db-server.py

トラブルシューティング

よくある問題

サーバーに「⚠ Needs authentication」と表示される

• リモートサーバーで OAuth が必要です
• サーバーのツールを使用して認証を開始します
• claude mcp get <name> で認証ステータスを確認します

サーバーに「✗ Connection failed」と表示される

• URL が正しいことを確認します
• ネットワーク接続を確認します
• 認証情報が有効であることを確認します
• stdio サーバーの場合は、コマンドのパスと権限を確認します

サーバーが一覧に表示されない

• 追加したばかりの場合は、Claude Code CLI を再起動します
• スコープを確認します。サーバーが別のスコープレベルにある可能性があります
• 設定ファイルの構文を確認します

プロジェクトスコープのサーバーで繰り返し承認が必要になる

• セキュリティ対策として、Claude Code は初回使用時に承認を求めます
• プロンプトが表示されたら、「Approve once」または「Always approve」を選択します
• claude mcp reset-project-choices で選択をリセットします

設定ファイルの場所

ローカルスコープ：プロジェクト固有の設定は .claude/settings.local.json プロジェクトスコープ：プロジェクトルートの .mcp.json ユーザースコープ：~/.claude/settings.json

デバッグ

MCP デバッグモードを有効にします：

claude --mcp-debug

または、新しいデバッグフラグを使用します：

claude --debug

サーバーの詳細を確認します：

# Get server configuration
claude mcp get <server-name>

# List all servers with status
claude mcp list

高度な使い方

.mcp.json での環境変数の展開

プロジェクトスコープの設定では、環境変数の展開がサポートされています：

{
  "mcpServers": {
    "api-server": {
      "type": "http",
      "url": "${API_BASE_URL:-https://api.example.com}/mcp",
      "headers": {
        "Authorization": "Bearer ${API_KEY}"
      }
    }
  }
}

構文：

• ${VAR} - 環境変数を展開します
• ${VAR:-default} - 設定されていない場合はデフォルト値を使用します

Claude Desktop からインポート

Claude Desktop ですでに MCP サーバーが設定されている場合：

claude mcp add-from-claude-desktop

Claude Desktop の設定からサーバーをインポートします（macOS および WSL のみ）。

JSON 設定から追加

JSON 設定を直接インポートします：

claude mcp add-json <name> '<json-config>'

例：

claude mcp add-json my-server '{
  "command": "npx",
  "args": ["-y", "server-package"],
  "env": {"API_KEY": "value"}
}'

MCP の出力制限

MCP ツールの最大出力トークン数を制御します：

# Set custom limit (default: 25,000 tokens)
export MAX_MCP_OUTPUT_TOKENS=50000
claude

次のようなサーバーで役立ちます：

• 大規模なデータセットをクエリする
• 詳細なレポートを生成する
• 大量のログを処理する

一般的な MCP サーバー

各カテゴリの人気 MCP サーバーを網羅した一覧については、MCP ドキュメント全体を参照してください：

• 開発とテスト：Sentry、Socket、Hugging Face、Jam
• プロジェクト管理：Asana、Atlassian、Linear、Notion、Monday
• データベース：Airtable、HubSpot、PostgreSQL
• 決済：PayPal、Plaid、Square、Stripe
• デザイン：Figma、Canva、InVideo
• インフラストラクチャ：Cloudflare、Netlify、Vercel
• 自動化：Workato、Zapier

リソース

references/mcp_documentation.md

以下を含む MCP の完全なドキュメントです：

• インストールコマンドを含む包括的なサーバーディレクトリ
• 詳細なトランスポートプロトコル仕様
• 認証方式と OAuth フロー
• プラグインベースの MCP サーバー
• エンタープライズ向け MCP 設定
• 環境変数の展開構文
• 実用的な例とユースケース

次の場合に参照してください：

• 特定の MCP サーバーのインストールコマンドが必要な場合
• 複雑な設定の問題をトラブルシューティングする場合
• エンタープライズ向け MCP のデプロイを設定する場合
• トランスポートプロトコルの詳細を理解する場合