Claude CodeのMCP設定方法｜claude mcp addの使い方・スコープ・.mcp.json【2026年10月】

1. MCPサーバーの追加方法

リモートのサーバー（HTTP方式・推奨）

claude mcp add --transport http notion https://mcp.notion.com/mcp

APIキーなどをヘッダーで渡す場合は --header を付ける。

claude mcp add --transport http secure-api https://api.example.com/mcp --header "Authorization: Bearer your-token"

手元で動かすサーバー（stdio方式）

-- の後ろに、サーバーを起動するコマンドを書く。環境変数は --env で渡す。

claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable -- npx -y airtable-mcp-server

SSE方式について

公式ドキュメントは、SSE（Server-Sent Events）方式を非推奨としており、使えるならHTTP方式を勧めている。

オプションの短縮形：-t（--transport）、-H（--header）、-s（--scope）、-e（--env）

2. スコープ——誰が使えるかを決める

claude mcp add --scope project --transport http notion https://mcp.notion.com/mcp

同じ名前のサーバーが複数のスコープにある場合は、local ＞ project ＞ user ＞ プラグイン ＞ claude.aiのコネクタの順に優先される。

3. .mcp.json でチームと共有する

projectスコープで追加すると、プロジェクト直下に .mcp.json ができる。中身は次の形だ。

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

• ${VAR} や ${VAR:-default} と書くと環境変数を展開できる（command・args・env・url・headers で使える）。APIキーは直接書かず、環境変数で渡すとGitに秘密情報が入らない
• プロジェクトのサーバーは、各メンバーが初めて使うときに承認を求められる。承認をやり直すときは claude mcp reset-project-choices

4. ログインが必要なサーバーの認証（OAuth）

claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

追加したあと、Claude Codeの中で /mcp を実行するとブラウザが開いて認証できる。シェルからなら claude mcp login 名前、解除は claude mcp logout 名前。コールバックのポートを固定したい場合は --callback-port、事前に登録したクライアントを使う場合は --client-id と --client-secret を指定する。

5. 管理コマンド

6. よく使われる接続例

• NotebookLM（Gemini Notebook）とつなぐ方法：Claude × NotebookLM連携
• Obsidianの保管庫とつなぐ方法：Obsidian × AIエージェント
• Nottaの議事録とつなぐ方法：Notta MCP

よくある質問