Claude CodeでMCPを使いこなす完全ガイド：設定から活用まで

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

# Option 1: リモートHTTPサーバー（推奨）
claude mcp add --transport http <名前> <URL>

# 例: Notionに接続
claude mcp add --transport http notion https://mcp.notion.com/mcp

# Bearerトークン付き
claude mcp add --transport http secure-api https://api.example.com/mcp \
  --header "Authorization: Bearer your-token"

# Option 2: リモートSSEサーバー（非推奨・廃止予定）
# 可能であればHTTPに移行を推奨
claude mcp add --transport sse <名前> <URL>

# Option 3: ローカルstdioサーバー（ローカルプロセスとして動く）
claude mcp add [オプション] <名前> -- <コマンド> [引数...]

# 例: Airtableサーバーを追加
claude mcp add --transport stdio --env AIRTABLE_API_KEY=YOUR_KEY airtable \
  -- npx -y airtable-mcp-server

# Windows環境でのstdioサーバー追加例
claude mcp add --transport stdio my-server -- cmd /c npx -y @some/package

# 設定済みのサーバー一覧
claude mcp list

# 特定サーバーの詳細を確認
claude mcp get github

# サーバーを削除
claude mcp remove github

# Claude Code起動中にサーバーの状態確認
/mcp

# Sentryを追加
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

# OAuth認証
/mcp

直近24時間の主要エラーを確認して
エラーID abc123 のスタックトレースを見せて
どのデプロイでこの新しいエラーが発生し始めたか調べて

# GitHubを追加
claude mcp add --transport http github https://api.githubcopilot.com/mcp/

# OAuth認証
/mcp

PR #456をレビューして改善点を提案して
今見つけたバグ用のissueを作成して
自分にアサインされているPR一覧を表示して

# PostgreSQLを追加（読み取り専用ユーザーを推奨）
claude mcp add --transport stdio db -- npx @bytebase/dbhub@latest --transport stdio --dsn "postgresql://readonly:[email protected]:5432/analytics"

今月の総売上は？
ordersテーブルのスキーマを表示して
90日間購入がないユーザーを抽出して

# コールバックポートを固定して追加
claude mcp add --transport http \
  --callback-port 8080 \
  my-server https://mcp.example.com/mcp

claude mcp add --transport http \
  --client-id your-client-id --client-secret --callback-port 8080 \
  my-server https://mcp.example.com/mcp

# Claude CodeをstdioのMCPサーバーとして起動
claude mcp serve

{
  "mcpServers": {
    "claude-code": {
      "type": "stdio",
      "command": "claude",
      "args": ["mcp", "serve"],
      "env": {}
    }
  }
}

# フルパスを調べるコマンド
which claude

{
  "mcpServers": {
    "claude-code": {
      "type": "stdio",
      "command": "/full/path/to/claude",
      "args": ["mcp", "serve"],
      "env": {}
    }
  }
}

# claude.ai MCPサーバーを無効化する場合
ENABLE_CLAUDEAI_MCP_SERVERS=false claude

claude mcp add-from-claude-desktop

# 基本構文
claude mcp add-json <名前> '<JSON設定>'

# HTTPサーバーの例
claude mcp add-json weather-api '{"type":"http","url":"https://api.weather.com/mcp","headers":{"Authorization":"Bearer token"}}'

# stdioサーバーの例
claude mcp add-json local-weather '{"type":"stdio","command":"/path/to/weather-cli","args":["--api-key","abc123"],"env":{"CACHE_DIR":"/tmp"}}'

# OAuth付きHTTPサーバー
claude mcp add-json my-server '{"type":"http","url":"https://mcp.example.com/mcp","oauth":{"clientId":"your-client-id","callbackPort":8080}}' --client-secret

# MCP出力上限を50,000トークンに設定
export MAX_MCP_OUTPUT_TOKENS=50000
claude

# 起動タイムアウトを10秒に設定
MCP_TIMEOUT=10000 claude

{
  "mcpServers": {
    "internal-api": {
      "type": "http",
      "url": "https://mcp.internal.example.com",
      "headersHelper": "/opt/bin/get-mcp-auth-headers.sh"
    }
  }
}

# Brave Search MCPを追加（APIキーが必要）
claude mcp add --transport stdio brave-search \
  --env BRAVE_API_KEY=your-api-key \
  -- npx -y @modelcontextprotocol/server-brave-search

# AWS Documentation MCPを追加
claude mcp add aws-documentation-mcp-server uvx "awslabs.aws-documentation-mcp-server@latest"

# Context7 MCPを追加
claude mcp add --transport http context7 https://mcp.context7.com/mcp

{
  "mcpServers": {
    "github": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GITHUB_PERSONAL_ACCESS_TOKEN",
        "ghcr.io/github/github-mcp-server"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_PERSONAL_ACCESS_TOKEN}"
      }
    },
    "sentry": {
      "type": "http",
      "url": "https://mcp.sentry.dev/mcp"
    }
  }
}

{
  "mcpServers": {
    "github_work": {
      "command": "docker",
      "args": ["-i", "--rm", "-e", "GITHUB_PERSONAL_ACCESS_TOKEN", "ghcr.io/github/github-mcp-server"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_WORK_TOKEN}"
      }
    },
    "github_personal": {
      "command": "docker",
      "args": ["-i", "--rm", "-e", "GITHUB_PERSONAL_ACCESS_TOKEN", "ghcr.io/github/github-mcp-server"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_PERSONAL_TOKEN}"
      }
    }
  }
}

# 設定確認
claude mcp list
claude mcp get <サーバー名>

# 出力上限を増やす
export MAX_MCP_OUTPUT_TOKENS=50000
claude

claude mcp reset-project-choices