Claude Codeの `claude mcp add` で公式ドキュメント検索をつなぐ — 最初のMCPを10分で接続確認

Claude Codeを使い始めたばかりで、MCPという言葉は見たけれど、まだ接続したことがない方向けです。
この記事では、Claude Code公式ドキュメントのMCPサーバーを1つだけ追加し、✔ Connectedを確認するところまでを10分の成功にします。
前提はClaude Codeのインストールと認証です。操作はすべて、Claude Codeの会話画面ではなく通常のターミナルで行います。

いきなり複数の外部サービスをつなぐ必要はありません。まずはAPIキー不要の公式サーバーを1つ接続し、「追加できた」と「接続できた」の違いを自分の画面で確かめる。今日はそこまでで十分です。

今回使う機能は `claude mcp add` だけ

Claude Codeは、コードを読み、ファイルを編集し、コマンドを実行できるAIエージェントです。ここでいうAIエージェントは、質問に文章で答えるだけでなく、許可された範囲でツールを使って作業を進める仕組みだと思ってください。

MCP（Model Context Protocol）は、AIツールを外部のデータや機能へつなぐための公開規格です。少し乱暴にたとえるなら、Claude Codeに外部ツール用の差込口を増やすようなものです。

今回つなぐのは、Claude Code公式ドキュメントを検索するためのMCPサーバーです。MCPサーバーは、Claude Codeにツールを提供する側のプログラムやサービスを指します。

扱う中心機能は、サーバーを登録する次のコマンド1つです。

claude mcp add --transport http claude-code-docs https://code.claude.com/docs/mcp

listとgetも使いますが、新しい機能を増やすためではありません。今追加した1件が接続できたかを確認するためです。

10分後の成功状態

この記事のゴールは、次のような表示を自分のターミナルで確認することです。

claude-code-docs: https://code.claude.com/docs/mcp (HTTP) - ✔ Connected

ここで大事なのは、AddedとConnectedは別だということです。

Addedは設定が保存された状態
Connectedはサーバーへ接続し、利用準備ができた状態

設定ファイルに1行増えただけでは、サーバーが実際に応答するとは限りません。なんか地味なんですが、この確認を1回挟むだけで「登録したのに使えない」という迷いを減らせます。

なお、Connectedはモデルがすでに検索を実行したという意味ではありません。この記事では接続確認までを扱います。

前提を確認する

ターミナルとは

ターミナルは、画面上のボタンではなく文字でコンピューターを操作するアプリです。macOSなら「ターミナル」、WindowsならPowerShellやWindows Terminal、Linuxなら各環境の端末を使います。

Claude Codeが入っているか確認する

通常のターミナルで、次を実行します。

claude --version

バージョン番号とClaude Codeが表示されれば、次へ進めます。

2.x.x (Claude Code)

数字は更新で変わるため、同じ番号でなくても問題ありません。command not foundと表示された場合は、先に公式Overviewの手順でClaude Codeをインストールしてください。macOS、Linux、WSL向けの公式推奨コマンドは次です。

curl -fsSL https://claude.ai/install.sh | bash

公式MCPクイックスタートは、Claude Codeがインストール済みで、認証済みであることを前提にしています。初回利用ではClaude Codeを起動し、画面の案内に沿ってログインしてください。認証情報やAPIキーを記事、チャット、スクリーンショットへ貼らないようにします。

手順1: 練習フォルダを作る

まず、今回の設定先を分かりやすくするため、練習用フォルダを作ります。macOS、Linux、WSLでは次の3行をそのまま実行できます。

mkdir -p ~/claude-mcp-practice
cd ~/claude-mcp-practice
pwd

pwdは、いまいるフォルダの場所を表示するコマンドです。末尾がclaude-mcp-practiceなら準備できています。

/Users/あなたの名前/claude-mcp-practice

上の出力は例です。利用者名や先頭部分は環境ごとに違います。

手順2: 公式ドキュメントMCPを追加する

同じターミナルで、次の1行を実行します。

claude mcp add --transport http claude-code-docs https://code.claude.com/docs/mcp

コマンドを分けて見ると、こうなっています。

部分	意味
`claude mcp add`	Claude CodeへMCPサーバーを登録する
`--transport http`	URLへHTTPで接続する
`claude-code-docs`	今回つけるサーバー名
`https://code.claude.com/docs/mcp`	公式サーバーの接続先

成功すると、Added HTTP MCP serverから始まる確認と、変更された設定ファイルが表示されます。

Added HTTP MCP server claude-code-docs with URL: https://code.claude.com/docs/mcp to local config
File modified: ...

ここでのlocal configは、この利用者の、このプロジェクトだけで使う設定です。別のプロジェクト全部へ一括適用する設定ではありません。最初の練習では、この狭い範囲が扱いやすいと思います。

手順3: `Connected`を確認する

追加直後に、接続状態を確認します。

claude mcp list

Claude Codeがサーバーの状態を調べ、成功すれば次のように表示します。

Checking MCP server health…

claude-code-docs: https://code.claude.com/docs/mcp (HTTP) - ✔ Connected

これで10分の初回成功は完了です。

もう少しだけ設定を読みたい場合は、次を実行します。

claude mcp get claude-code-docs

確認するのは3点だけです。

Scope: Local config (private to you in this project)
Status: ✔ Connected
Type: http

細かい設定項目を全部覚える必要はありません。Local、Connected、httpが確認できれば、今回の目的は達成できています。

次にClaude Codeから使うとき

接続確認の次は、Claude Codeを起動し、公式クイックスタートにあるようにサーバー名を指定して質問できます。

claude

Claude Codeの入力欄では、たとえば次のように頼みます。

Use the claude-code-docs server to look up what MCP_TIMEOUT does

普段はClaude Codeが適切なツールを選べますが、最初の確認ではサーバー名を明示すると、そのMCPを使ったか見分けやすくなります。初回のツール呼び出しで許可を求められたら、接続先と操作内容を読んでから判断してください。

ここは大事なので、検証範囲を正直に分けます。筆者環境ではMCPの追加、listのConnected、getの設定表示までを確認しました。一方、Claude Codeが未認証だったため、モデルがMCPツールを呼び出して検索回答を返すところは筆者未検証です。この記事の成功判定には含めていません。

つまずきポイント

1. `claude: command not found`と出る

Claude Codeが未インストールか、実行ファイルへPATHが通っていません。まずclaude --versionが表示される状態に戻します。インストール後も変わらない場合はターミナルを開き直してください。

2. ログイン画面が出る

初回利用や認証期限切れでは正常な案内です。ブラウザでのログインや権限許可は、利用者自身で内容を確認して進めます。共有PCや所有者不明のアカウントでは進めない方が安全です。

3. `Added`は出たが`Connected`にならない

Addedは設定保存の成功です。続けてclaude mcp listを実行し、接続状態を分けて確認します。失敗したままなら、サーバー名とURLの入力ミス、ネットワーク接続、組織のプロキシやポリシーを確認します。

4. `Failed to connect`や`Connection error`になる

一時的な通信不調の可能性があります。ただし、闇雲に追加コマンドを繰り返すと同名設定の扱いで迷いやすくなります。まず次で登録内容を読みます。

claude mcp get claude-code-docs

URLが公式のhttps://code.claude.com/docs/mcpと一致するか確認し、それでも直らなければ時間を置くか公式MCPトラブルシューティングを確認します。

5. 別のフォルダではサーバーが見えない

今回は既定のlocal scopeを使っています。公式説明では、local scopeはその利用者・そのプロジェクトだけで有効です。練習時に使ったclaude-mcp-practiceへ戻ってclaude mcp listを試してください。

6. 全プロジェクトで使いたくなった

--scope userという選択肢もありますが、最初から影響範囲を広げる必要はありません。まずlocal scopeで必要性を確かめる方が、設定を戻しやすいです。この記事ではscope変更までは扱いません。

7. 不要になったので外したい

同じ練習フォルダで次を実行します。

claude mcp remove claude-code-docs

削除後にclaude mcp listを実行し、一覧から消えたことを確認します。接続を残すか外すかは、実際に使い続けるかで決めれば大丈夫です。

安全に使うための考え方

MCPサーバーはClaude Codeへ外部のデータや機能を渡します。便利さと同時に、接続先を信頼できるかという判断が増えます。

今回はAnthropicのClaude Code公式ドキュメントに掲載された公式docs MCPを使いました。別のサーバーを追加するときは、少なくとも次を確認してください。

提供者と接続先URLが信頼できるか
認証情報をどこへ渡すのか
読み取りだけか、更新操作もできるのか
自分のプロジェクトに本当に必要か

外部コンテンツを取得するサーバーには、文書内の悪意ある指示をAIが拾うprompt injectionのリスクもあります。接続しただけで安全になるわけではありません。重要な操作は、対象と権限を人が確認する必要があります。

この方法が効かない条件と限界

MCPサーバーをConnectedにしても、検索結果やモデル回答の正確さは保証されません。接続確認は、あくまで「道がつながった」ことの確認です。内容の正しさは、参照元と日付を人が確認する必要があります。

また、外部ツールを使わず、Claude Codeの内蔵機能だけで作業が終わる人には、MCPを追加しない方がシンプルです。公式ドキュメントも、接続した各サーバーのツール名や説明がコンテキスト領域を使うため、使わないサーバーを外す意味があると説明しています。

「つなげるものは全部つなぐ」より、「必要な1つを、狭い範囲で、状態確認まで行う」。最初はこのくらいがちょうどいい気がします。

まとめ

今回扱ったのは、Claude Codeのclaude mcp addで公式ドキュメントMCPを1つ接続する機能です。

mkdir -p ~/claude-mcp-practice
cd ~/claude-mcp-practice
claude mcp add --transport http claude-code-docs https://code.claude.com/docs/mcp
claude mcp list

成功判定は、一覧の✔ Connectedです。Addedだけで終わらず、接続状態まで確認する。これで「設定したはず」から「接続できた」へ一歩進めます。

次の1アクションは、練習フォルダで上の4行を実行し、公式docs MCPのConnectedを1回確認することです。確認できたら、今日はそこで終えてかまいません。

参考リンク

確認日: 2026年9月14日

生成AI活用エンジニア&3児のパパ。AI×開発の実践知を毎日発信しています → Xで次の実践例を見る