Claude CodeでMCP Serverを追加・管理する現行コマンド

結論

最初にやること：OSのターミナルでclaude mcp add --transport http docs https://example.com/mcpを実行します。

Claude CodeのMCP Serverは、手書きのclaude_mcp.jsonではなく、原則としてclaude mcp addで登録します。

リモートサービスはHTTP、ローカルプロセスはstdioを選び、認証情報を含む構成は既定のlocal scopeに置くのが安全です。

チーム共有が必要な構成だけ--scope projectを指定すると、リポジトリ直下の.mcp.jsonへ保存されます。

実行場所：OSのターミナルで実行します。

# HTTP型のリモートMCP
# ターミナルで実行：MCPサーバーを登録
claude mcp add --transport http docs https://example.com/mcp

# stdio型のローカルMCP
# ターミナルで実行：MCPサーバーを登録
claude mcp add --transport stdio filesystem -- npx -y @modelcontextprotocol/server-filesystem ./docs

具体的な手順

scopeを決めずにAPIキー入り設定を共有しないため、localを既定にすることが重要です。

1. まず提供元の公式ドキュメントで、接続URL、パッケージ名、必要権限、対応transportを確認します。

2. 個人用・秘密情報付きならlocal、全プロジェクト共通ならuser、チーム共有ならproject scopeを選びます。

3. 登録後は一覧と詳細を確認し、対話画面の/mcpでOAuth認証や接続状態を確定します。

実行場所：コメントに従い、ターミナルとClaude Codeの対話画面を使い分けます。

# ターミナルで実行：登録済みMCPサーバーを確認
claude mcp list
# ターミナルで実行：MCP設定を管理
claude mcp get docs
# ターミナルで実行：Claude Codeを起動
claude
# Claude Code起動後の対話画面で実行：MCP接続と認証状態を管理
/mcp

実践プロンプト

接続テストでは、最初から書き込みをさせず、読み取り専用の小さな要求から始めます。

入力場所：Claude Codeの対話画面へ貼り付けます。

接続済みのMCPサーバーを確認してください。
docsサーバーだけを使い、認証方式と利用可能なツール名を一覧化してください。
外部データの変更やファイル書き込みは行わないでください。

注意点

Addedと表示されても、設定が保存されたことを示すだけで、認証成功までは保証しません。

Needs authenticationなら/mcpから認証し、Failed to connectならURL、プロキシ、実行コマンド、環境変数を確認します。

project scopeの.mcp.jsonは初回にworkspace trustとサーバー承認が必要であり、拒否状態はclaude mcp reset-project-choicesでリセットできます。

npxを使うstdioサーバーだけはNode.jsが必要で、HTTP型MCPの利用自体にはNode.jsは必須ではありません。