結論
最初にやること：OSのターミナルでclaude mcp add --transport http --scope project notion https://mcp.notion.com/mcpを実行します。
Claude CodeのMCP設定はclaude_mcp.jsonではなく、CLIコマンドまたはプロジェクト共有用の.mcp.jsonで管理します。
クラウドサービスへの接続は、非推奨のSSEよりリモートHTTPトランスポートを優先します。
実行場所：OSのターミナルで実行します。
# プロジェクト共有のHTTP MCPを追加
# ターミナルで実行：MCPサーバーを登録
claude mcp add --transport http --scope project notion https://mcp.notion.com/mcp
# 接続状態を確認
# ターミナルで実行：登録済みMCPサーバーを確認
claude mcp list具体的な手順
MCPは共有範囲と権限を決めてから登録します。
- 個人の全プロジェクトなら
--scope userを選択 - リポジトリ共有なら
--scope projectを選択 - 端末固有なら
--scope localを選択 - 起動後に
/mcpで接続とOAuth状態を確認
ローカルstdioサーバーはコマンドと引数を--の後へ渡し、接続文字列をリポジトリへ直書きしません。
実行場所：OSのターミナルで実行します。
# ターミナルで実行：MCPサーバーを登録
claude mcp add --transport stdio --scope local my-tool -- node ./tools/mcp-server.js
# ターミナルで実行：MCP設定を管理
claude mcp get my-tool実践プロンプト
MCPに許可する操作を最小化し、まず読み取り専用の問い合わせで接続確認を行います。
入力場所：Claude Codeの対話画面へ貼り付けます。
利用可能なMCPサーバー名とツールを列挙してください
書き込み操作は行わず、接続中のサービスから
取得できる情報の種類だけを説明してください注意点
.mcp.jsonをコミットする前に秘密鍵やBearerトークンが含まれていないか確認します。
接続失敗時はJSONを手編集する前にclaude mcp getと/mcpを確認し、URLだけの設定にはtype: httpが必要である点にも注意します。