Claude CodeにMCPサーバーを追加

Claude Codeは、claude mcp addコマンドまたはリポジトリのルートにある.mcp.jsonファイルからサーバーを読み込みます。

macOS

~/.claude.json

Windows

~/.claude.json

Linux

~/.claude.json

プロジェクトファイル

.mcp.json

トップレベルキー

mcpServers

形式

json

リモートサーバーのOAuth

●はい

設定例

この例では、GitHub のホスト型サーバーと Playwright のローカルサーバーを、このクライアントが想定する形式で追加します。

{
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/"
    },
    "playwright": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "@playwright/mcp@latest"
      ]
    }
  }
}

claude mcp add --transport http --scope project github https://api.githubcopilot.com/mcp/
claude mcp add --scope project playwright -- npx @playwright/mcp@latest

注意点と仕様

• デフォルトのローカルスコープとユーザースコープは~/.claude.jsonに保存され、プロジェクトスコープは.mcp.jsonに保存されます。
• urlを含む各エントリーには、httpなどのtypeも必要です。urlだけを指定するとエラーになります。
• ファイル内の値では${VAR}と${VAR:-default}が展開されます。
• OAuthサーバーにサインインするには、セッション内で/mcpを実行します。OAuthアプリが事前登録されている場合は、--client-id、--client-secret、--callback-portを渡してください。

Claude Codeの設定を作成 →

その他のクライアント