Claude CodeにMCPサーバーを追加する現行CLI手順

結論

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

Claude CodeへのMCP追加はclaude mcp addを使い、手書きJSONより先にtransportとscopeを明示する方法が安全です。

HTTPサーバーはURL、stdioサーバーは実行コマンドと引数を登録し、追加後にlist、get、/mcpで確認します。

共有設定はproject scope、全プロジェクト共通はuser scope、端末限定はlocal scopeを選びます。

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

# HTTP MCPを共有プロジェクトへ追加
# ターミナルで実行：MCPサーバーを登録
claude mcp add --transport http docs   https://mcp.example.com/docs --scope project

# stdio MCPを個人環境へ追加
# ターミナルで実行：MCPサーバーを登録
claude mcp add --transport stdio local-tool   --scope user -- /usr/local/bin/local-mcp --readonly

# ターミナルで実行：登録済みMCPサーバーを確認
claude mcp list
# ターミナルで実行：MCP設定を管理
claude mcp get docs

具体的な手順

1. 提供元の接続手順とtransportを確認する

2. scopeを決めてaddコマンドを実行する

3. OAuth対応サーバーならclaude mcp login <name>を実行する

4. /mcpで接続状態と公開toolを確認する

project scopeは.mcp.jsonとして共有されるため、固定tokenを直接書かず${MCP_TOKEN}のような環境変数展開を使います。

サーバー名は短く一意にし、prompt内で明示できる名前にします。

実践プロンプト

追加したドキュメントMCPの疎通確認プロンプトです。

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

docs MCPの利用可能なツールを確認してください。
読み取り専用の検索を使い、「認証トークンの更新手順」に関する文書を1件取得してください。
取得元のタイトルと更新日時を示し、内容を要約してください。
書き込み、コメント投稿、外部URLへの再送信は行わないでください。

注意点

claude_mcp.jsonはClaude Codeの現行project設定ファイル名ではなく、共有設定は.mcp.jsonです。

追加直後にserverが見えない場合は、名前の重複、scope、コマンドの絶対パス、環境変数、OAuth状態をclaude mcp getと/mcpで確認します。

stdioでnpx -yを使う構成は起動時にコードを取得し得るため、パッケージversion固定と供給元監査を行ってください。