Claude Code MCP設定ガイド｜使い方とおすすめ7選

「Claude CodeでGitHubやNotionと連携させたい」と検索したのに、claude mcp addの1行だけ貼られた記事に迷った経験はないだろうか。

私も最初の設定でスコープの違いを理解せずハマり、プロジェクトごとに同じコマンドを打ち直す羽目になった。

この記事では設定手順・コマンド一覧・実際に運用しているサーバー構成まで、つまずいた箇所を含めて解説する。

結論から言うと、Claude Code MCPはclaude mcp addコマンド一発で設定でき、スコープ（local/project/user）を使い分ければチームでも個人でも運用できる。

Claude Code MCPとは？できることを解説

MCP（Model Context Protocol）とは、AnthropicがClaude向けに公開した外部ツール接続の標準規格である。

GitHubやNotion、データベースなど、Claude Codeが本来アクセスできない情報やサービスを、共通のプロトコルで橋渡しする。

導入すると、Issueの内容を読んでコードを直すよう頼んだり、ブラウザを操作してフォームの動作を確認させたりできるようになる。

ファイルの読み書きしかできなかったClaude Codeが、外の世界に手を伸ばせる状態になるとイメージすると分かりやすい。

MCP（Model Context Protocol）の仕組み

MCPサーバーは、Claude Codeとは別プロセスで起動する小さなプログラムである。

GitHubなら「Issueを取得する」「PRを作る」といった操作を、Notionなら「ページを検索する」といった操作を、あらかじめ関数として公開している。

Claude Codeはそのサーバーに接続すると公開された関数の一覧を受け取り、会話の中で必要に応じて呼び出す。

1つのMCPサーバーを作れば、Claude・ChatGPT・Cursorなど複数のクライアントから使い回せるのも特徴だ。

Claude Desktopとの設定方法の違い

同じMCPでも、Claude DesktopとClaude Codeでは設定の置き場所が違う。

Claude Desktopはclaude_desktop_config.jsonを直接編集する方式のみだ。

一方Claude Codeはclaude mcp addコマンドと.mcp.jsonの直接編集、どちらも選べる。

Claude Code MCPサーバーの設定方法【3ステップ】

Claude Codeへのサーバー追加は、ターミナルでclaude mcp addを打つだけで完結する。

手順は「サーバーを追加する」「スコープを決める」「必要ならJSONを直接編集する」の3ステップに分かれる。順番に見ていく。

claude mcp addコマンドの使い方

基本の書式はclaude mcp add [サーバー名] -- [起動コマンド]だ。

Claude Codeの中ではなく、通常のターミナルで実行する点に注意する。

たとえばブラウザ操作用のPlaywright MCPなら、以下の1行で追加できる。

claude mcp add playwright -- npx -y @playwright/mcp@latest

追加が終わったらClaude Codeを再起動し、/mcpコマンドで接続状態を確認する。ここで「Connected」と表示されれば設定は完了である。

スコープ（local/project/user）の使い分け

私が最初に混乱したのがこのスコープだ。-sオプションで指定でき、デフォルトはlocalとなる。

• local：今のプロジェクトの自分の環境だけに適用（デフォルト）
• project：.mcp.jsonに書き込まれ、リポジトリを共有するメンバー全員に反映される
• user：自分の全プロジェクトで共通して使える

チームで同じMCP構成を使い回したいならproject、個人的によく使うツールならuserを選ぶとよい。

APIキーを含む設定をprojectスコープで共有すると秘密情報がリポジトリに残ってしまうため、キー類は環境変数経由で渡す運用にしている。

.mcp.json（設定ファイル）を直接編集する方法

コマンドを打たずに、プロジェクトルートの.mcp.jsonを直接書いても同じ結果になる。

複数のサーバーをまとめて設定したいときは、こちらの方が見通しがよい。

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["-y", "@playwright/mcp@latest"]
    },
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/"
    }
  }
}

APIキーやトークンを直接書き込むと誤ってコミットする危険があるため、${GITHUB_TOKEN}のように環境変数で参照する形にする。

実際の値は.envで管理し、.gitignoreに加えておく。

MCPサーバーの追加・削除・確認コマンド一覧

設定後によく使うコマンドをまとめておく。覚えるのはこの5つで足りる。

サーバーの追加とAPIキー設定

APIキーが必要なサーバーは-eオプションで環境変数を渡す。GitHub MCPを例にすると以下のようになる。

export GITHUB_PERSONAL_ACCESS_TOKEN=ghp_xxxxxxxxxxxx
claude mcp add github -e GITHUB_PERSONAL_ACCESS_TOKEN=$GITHUB_PERSONAL_ACCESS_TOKEN \
  -- docker run -i --rm -e GITHUB_PERSONAL_ACCESS_TOKEN ghcr.io/github/github-mcp-server

サーバーの削除・一覧確認・接続確認

不要になったサーバーの削除や、現在の登録状況の確認は次のコマンドで行う。

試しに追加してみて合わなければ、claude mcp removeですぐ元に戻せる。気軽に試せるのはコマンド管理の利点だ。

導入すべきおすすめMCPサーバー7選

種類が多すぎて選べないという声をよく聞くが、まず入れるべきものは限られている。実際に使って効果が大きかった順に紹介する。

GitHub MCP｜PR・Issue管理を自動化

GitHub公式のGitHub連携サーバーである。Issueの内容を読んでコードを修正し、そのままPRを出すところまで一気に任せられる。

導入して最初に驚いたのは、「このIssueを見て直して」の一言で本当にブランチ作成からPR作成まで終わったときだった。

ブラウザでGitHubを開く回数がかなり減った。

Context7｜最新ドキュメントでハルシネーション防止

Upstashが提供するドキュメント参照サーバーである。

ライブラリの最新APIを参照させられるため、古いバージョンの書き方を提案されてしまう事故を減らせる。

APIキー不要ですぐ試せるので、最初の1台として向いている。

Playwright MCP｜ブラウザ操作を自動化

私自身、懸賞応募や自社サイトの動作確認をPlaywrightベースの自動化スクリプトに置き換えてきた。

AppleScriptでも似たことはできるが、iframeをまたぐ操作でどうしても詰まる場面があり、汎用性ではPlaywrightに分があると感じている。

Playwright MCPを入れれば「このフォームが正しく動くか確認して」と頼むだけで、Claude Codeが実際にブラウザを動かして検証してくれる。

その他おすすめサーバー（Notion/Figma/DB系）

用途がはっきりしているツール系は、必要になったタイミングで追加すればよい。導入難易度と向いている人の目安は以下のとおりだ。

全部を一度に入れる必要はない。1つ導入して効果を確かめてから次に進んだほうが、設定でつまずいたときに原因を切り分けやすい。

実際に運用しているMCP構成を公開

自分のブログ運営・自動化スクリプト群のリポジトリで、実際にどう組んでいるかを公開する。

理屈だけでは伝わらない部分も多いので、参考にしてもらえたらと思う。

うちのリポジトリで使っているMCPサーバー構成

ブログの投稿・分析・SEO最適化まで自動化しているリポジトリでは、ファイル操作系に加えてブラウザ自動化とドキュメント参照を軸に構成している。

生活を一番変えた自動化はブログ運用そのもので、投稿から分析までを自動化で回せるようになったのは、こうしたツール連携の積み重ねがあってのことだ。

特にPlaywright MCPは、WordPressの記事投稿やSEO分析の検証作業で日常的に使っている。

CLAUDE.mdでAIの操作範囲を制限するコツ

MCPを使い始める前に、AIにしてほしくないことをCLAUDE.mdに明記しておくと安心して任せられる。

「秘密情報をコミットしない」「破壊的なgit操作は確認を取る」のようなルールを先に書いておけば、後から追加するより事故が少ない。

実際にこの運用に切り替えてから、意図しない操作で慌てる場面はほぼなくなった。

Claude Codeの実践的な活用法をさらに体系的に学びたい方には以下の書籍もおすすめです。

実践Claude Code入門ー現場で活用するためのAIコーディングの思考法 [ 西見 公宏 ]

posted with カエレバ

楽天市場

Amazon

Yahooショッピング

MCPサーバーが繋がらないときのトラブルシューティング

設定したのに反応しない場合、原因はいくつかのパターンに絞られる。上から順に確認すれば大半は解決する。

/mcpコマンドで接続状況を確認する

まずClaude Codeを完全に再起動し、/mcpで状態を見る。

「Connected」になっていなければ、設定ファイルのJSON構文にカンマの過不足がないかを確認する。

settings.jsonやsettings.local.jsonにdisabledMcpjsonServersが設定されているケースもある。

この場合、意図せず無効化されている可能性が高い。

よくあるエラーと対処法

• 認証エラー：APIキー・トークンの有効期限切れが多い。再発行して環境変数を更新する
• 接続が途中で切れる：長時間の作業で不安定になりやすい。タイムアウト値を見直すか、再接続する習慣をつける
• コマンドが見つからない：npxやdockerなど、起動コマンドの実行環境が整っていないケース。事前にインストールしておく
• 連携先サービスの仕様変更：GitHubやNotionなど連携先のAPI仕様が変わり、昨日まで動いていたサーバーが急に反応しなくなることがある。Playwrightの自動化スクリプトがサイト仕様変更で全滅した経験があるので、他人事ではない。claude mcp removeで削除してから追加し直すか、該当MCPサーバーの更新有無を確認する

それでも直らない場合は、claude mcp removeで一度削除してから追加し直すと解決することが多い。

設定ファイルを手で編集して壊してしまった経験があるので、慣れないうちはコマンド操作から始めるのをおすすめする。

Claude Code MCP活用でよくある質問（FAQ）

Q1. MCPサーバーはいくつまで追加できますか？
A1. 技術的な上限はないが、多すぎるとClaude Codeが読み込むツール一覧が肥大化し、応答が遅くなる場合がある。必要なものだけ有効化するのが望ましい。

Q2. Claude Code MCPの設定は無料ですか？
A2. MCPサーバー自体の利用は無料のものが多いが、GitHubやNotionなど連携先サービスのAPI利用条件には従う必要がある。

Q3. claude mcp addで設定したサーバーはチームで共有できますか？
A3. できる。-s projectを指定すれば.mcp.jsonに書き込まれ、リポジトリを共有するメンバー全員に反映される。

Q4. Claude DesktopとClaude Codeで設定は共通ですか？
A4. 共通ではない。設定ファイルの場所が異なるため、両方で使いたい場合はそれぞれ個別に設定する必要がある。

Q5. MCPサーバーが「Connected」にならないときは？
A5. Claude Codeの完全な再起動、JSON構文の確認、settings.jsonでの無効化設定の確認、という順番で切り分けると原因が見つけやすい。

まとめ｜MCPでClaude Codeの可能性を広げる

MCPは、Claude Codeを「ファイルを読み書きするだけのツール」から「外部サービスと連携して動くエージェント」に変える仕組みである。

設定はclaude mcp addコマンド一発で済み、スコープを使い分ければチームでも個人でも運用できる。

• まずはContext7かPlaywright MCPなど、APIキー不要のサーバーから試す
• チームで使うなら-s project、個人なら-s userを選ぶ
• 導入前にCLAUDE.mdでAIの操作範囲を明記しておく

1つ入れて効果を確かめてから、次のサーバーを足していく。この記事の構成をそのまま真似れば、迷わず自分の開発環境に合ったMCP構成が作れるはずだ。