「Claude CodeでGitHubやNotionと連携させたい」と検索したのに、claude mcp addの1行だけ貼られた記事に迷った経験はないでしょうか。
私も最初の設定でスコープの違いを理解せずハマり、プロジェクトごとに同じコマンドを打ち直す羽目になりました。
この記事では設定手順・コマンド一覧・実際に運用しているサーバー構成まで、つまずいた箇所を含めて解説します。
結論から言うと、Claude Code MCPはclaude mcp addコマンド一発で設定でき、スコープ（local/project/user）を使い分ければチームでも個人でも運用できます。
PARTS LIST ／目次
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追加すると再起動しなくてもすぐ反映されます。/mcpコマンドで接続状態を確認しましょう。ここで「Connected」と表示されれば設定は完了です。
localデフォルトproject.mcp.json に保存userproject は .mcp.json がリポジトリに入るため、APIキーは書かず環境変数で渡します。スコープ（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を開く回数がかなり減りました。
導入は以下の1行で完了します。Claude Codeが自動でOAuth認証画面を開くので、ブラウザでGitHubアカウントの認可を済ませれば使い始められます。
claude mcp add --transport http github https://api.githubcopilot.com/mcp/Dockerコンテナ版を使いたい場合や、個人のPersonal Access Tokenで認証したい場合は後述の「サーバーの追加とAPIキー設定」を参照してください。
Context7｜最新ドキュメントでハルシネーション防止
Upstashが提供するドキュメント参照サーバーです。
ライブラリの最新APIを参照させられるため、古いバージョンの書き方を提案されてしまう事故を減らせます。
APIキー不要ですぐ試せるので、最初の1台として向いています。
claude mcp add --transport http context7 https://mcp.context7.com/mcpアクセス制限にかかりやすい場合は、Context7のダッシュボードで無料APIキーを発行して--headerオプションで渡すとレート制限が緩和されます。
Playwright MCP｜ブラウザ操作を自動化
私自身、懸賞応募や自社サイトの動作確認をPlaywrightベースの自動化スクリプトに置き換えてきました。
AppleScriptでも似たことはできますが、iframeをまたぐ操作でどうしても詰まる場面があり、汎用性ではPlaywrightに分があると感じています。
Playwright MCPを入れれば「このフォームが正しく動くか確認して」と頼むだけで、Claude Codeが実際にブラウザを動かして検証してくれます。
claude mcp add playwright -- npx @playwright/mcp@latestその他おすすめサーバー（Notion/Figma/DB系）
用途がはっきりしているツール系は、必要になったタイミングで追加すればよいでしょう。導入難易度と向いている人の目安は以下のとおりです。
それぞれの導入コマンドは以下のとおりです。NotionとSentryはOAuth認証、Figmaはデスクトップアプリ側での有効化、PostgreSQLは接続文字列が必要になります。
# Notion（追加後、/mcp コマンドでOAuth認証）
claude mcp add --transport http notion https://mcp.notion.com/mcp
# Figma（先にFigmaデスクトップアプリでDev Mode MCPサーバーを有効化し、表示されたURLを使う）
claude mcp add --transport http figma-desktop http://127.0.0.1:3845/mcp
# PostgreSQL（接続文字列は環境変数で渡す。参照専用ロールのユーザーを使うこと）
claude mcp add postgres -- npx -y @modelcontextprotocol/server-postgres "$DATABASE_URL"
# Sentry（追加後、/mcp コマンドでOAuth認証）
claude mcp add --transport http sentry https://mcp.sentry.dev/mcpFigmaだけは少し特殊で、Dev Mode MCPサーバーはFigmaデスクトップアプリ内で動くローカルサーバーのため、Figmaを開いて該当ファイルをDev Modeに切り替えた状態でないと接続できません。チームで使うならclaude plugin install figma@claude-plugins-officialでプラグイン経由で入れる方法もあります。
全部を一度に入れる必要はありません。1つ導入して効果を確かめてから次に進んだほうが、設定でつまずいたときに原因を切り分けやすくなります。
番外｜コード専門のSerena MCPも検討したい
7選では紹介しませんでしたが、コードベースの規模が大きい人にはSerena（oraios/serena）も検討してほしいサーバーです。GitHubで29,000件以上のスターを集めている、コード専門のセマンティック編集MCPの代表格です。
Serenaは、LSP（Language Server Protocol）を使ってコードを「シンボル単位」で理解させる仕組みです。ファイルをまるごと読んで検索するのではなく、「この関数の定義はどこか」「このクラスを参照している箇所はどこか」をIDEのように正確に把握できるようになります。find_symbol（シンボル検索）・find_referencing_symbols（参照箇所の検索）・replace_symbol_body（シンボル単位での書き換え）など21個のツールを備え、Java・Python・TypeScript・Go・Rustなど40以上の言語に対応しています。
Serenaはnpxで即起動できる他のサーバーと違い、uv（Pythonのパッケージマネージャ）で本体をインストールしてから接続します。
# 1. Serena本体をインストール（事前にuvが必要）
uv tool install -p 3.13 serena-agent
# 2. 初期化
serena init
# 3. 今のプロジェクトに接続する
claude mcp add serena -- serena start-mcp-server --project "$(pwd)" --context ide-assistant全プロジェクトで使いたい場合は、--project "$(pwd)"の代わりに--project-from-cwdを付け、-s userスコープで登録します。
Serenaの公式READMEは「MCPマーケットプレイスや古い紹介記事にあるuvx --from git+...形式のコマンドは古くなっている場合があるので避け、公式のQuick Startに従ってほしい」と明記しています。導入時は上記のuv tool install経由のコマンドを使ってください。
注意点として、Claude Code自体がLSPベースのシンボル検索機能を取り込みつつあります。SerenaのGitHub Issueでは、Claude Code 2.0.74以降で追加されたシンボル定義検索・参照検索・ファイル構造の概要表示が、Serenaのfind_symbol・find_referencing_symbols・get_symbols_overviewと重複すると報告されています（このIssueは「対応しない」扱いでクローズされています）。単純なシンボル検索程度ならClaude Code単体でも足りる場面が増えていますが、大規模なクロスファイル・リネームや一括リファクタリングのような複数ステップの操作を1回で安全に終わらせたい場面では、まだSerenaに分があります。
番外｜実用性より「面白さ」で選ぶMCPサーバー3選
実務向けの7選とは別に、入れてみると普通に楽しいMCPサーバーも紹介します。業務には直結しませんが、Claude CodeがMCP経由でできることの幅の広さが体感できます。
Blender MCP｜日本語の指示で3Dモデリング
ahujasid氏が公開しているBlender MCP（GitHubで16,000件以上のスター）は、3DソフトのBlenderをAIに操作させるサーバーです。「立方体を削除して、代わりに犬の頭の形を作って」のような指示で、実際にBlenderの画面上でモデリングが進みます。
claude mcp add blender uvx mcp-for-blender導入後は、Blender側にアドオンをインストールして有効化する必要があります（uvx mcp-for-blender install-addonを実行し、Blenderの環境設定でアドオンを有効にします）。Blenderを開いた状態でないと動きません。
Minecraft MCP｜Claude Codeにマイクラを操作させる
yuniko-software/minecraft-mcp-serverは、Minecraft（Java版）のキャラクターをAIに動かさせるサーバーです。移動・採掘・ブロック設置・チャット送信など、プレイヤーが普段操作している内容の多くをClaudeに委任できます。建物の画像をアップロードして「これを建てて」と頼むような使い方もできます。
claude mcp add minecraft -- npx -y github:yuniko-software/minecraft-mcp-server --host localhost --port 25565 --username ClaudeBotシングルプレイのワールドを「LANに公開」した状態で起動しておく必要があります。対応バージョンは開発側の対応状況に依存するため、導入前にGitHubのREADMEで現在のサポート状況を確認してください。
Home Assistant MCP｜家の照明やエアコンをClaudeに頼む
スマートホーム管理ツールのHome Assistantは、公式にMCPサーバーを統合しています。公開設定したエンティティ（照明・エアコン・スイッチ等）を、Claude Codeから会話形式で操作できるようになります。
claude mcp add --transport http HA https://<自宅のHome AssistantのURL>/api/mcp追加後は/mcpコマンドでOAuth認証を済ませます。インターネット経由でアクセスできない自宅内ネットワークのHome Assistantを使う場合は、mcp-proxyという中継サーバーを別途挟む構成が公式ドキュメントで案内されています。
いずれも実務での即効性は薄いですが、「AIエージェントが外の世界に手を伸ばす」というMCPの本質を体感するには向いています。
本当に全部MCPで入れるべきか？CLIで足りる場面が増えている
正直に言うと、ここで紹介した7つを全部そのまま勧めるのは少し乱暴です。2026年に入ってから、MCPサーバーを繋がなくてもCLIコマンドだけで同じ結果に辿り着くケースが増えています。
Claude CodeはBashツールでgit・gh・curl・jqといった既存のCLIをそのまま呼び出せます。GitHubの操作で言えば、「このIssueを直して」程度の単発作業なら、GitHub MCPを常時接続しなくてもgh issue viewやgh pr createをClaude Codeに打たせれば済んでしまいます。
MCPサーバーを1つ繋ぐと、そのサーバーが公開する関数の説明（スキーマ）がツール一覧に乗ります。Claude CodeはMCPツールの定義を必要になった時だけ取得する遅延読み込み（ToolSearch）の仕組みでコストを抑えてはいますが、それでも接続するサーバーが増えるほど、どのツールを呼ぶべきかClaude Codeが迷う場面は増えます。
そこで、今回の7選を「CLIで代替できるか」という基準で見直してみます。- GitHub MCP：
ghコマンドで代替できる場面が多いです。Issue確認・PR作成程度の単発作業ならghで十分。Issueを読んで修正してPRを出すまでを多段で任せたい、チーム全員に同じ操作範囲を配りたい場合はMCPに分があります - Context7・Playwright：CLIの代替が弱い（実質存在しない）領域なので、今でも導入する価値があります。Context7はドキュメント検索専用で置き換えにくく、Playwrightはブラウザを実際に操作して検証する点でAppleScript等より汎用的です
- Notion・Figma・Sentry：そもそも公式CLIが用意されていない（またはごく限定的な）サービスなので、MCPが実質唯一の導線になります。使う予定があるなら入れておいて損はありません
- PostgreSQL：単発のクエリなら
psqlで済みます。Claude Codeにスキーマ調査やクエリ作成を頻繁にやらせたい場合はMCPのほうが手数が減ります
結論としては「7つとも入れておけば損はしないが、GitHubだけはghコマンドとの比較を一度検討する価値がある」というところに落ち着きます。MCPサーバーは増やすほどツール一覧が肥大化するので、使っていないサーバーはclaude mcp removeでこまめに外すのがコツです。
実際に運用しているMCP構成を公開
自分のブログ運営・自動化スクリプト群のリポジトリで、実際にどう組んでいるかを公開します。
理屈だけでは伝わらない部分も多いので、参考にしてもらえたらと思います。
うちのリポジトリで使っているMCPサーバー構成
ブログの投稿・分析・SEO最適化まで自動化しているリポジトリでは、ファイル操作系に加えてブラウザ自動化とドキュメント参照を軸に構成しています。
生活を一番変えた自動化はブログ運用そのもので、投稿から分析までを自動化で回せるようになったのは、こうしたツール連携の積み重ねがあってのことです。
特にPlaywright MCPは、WordPressの記事投稿やSEO分析の検証作業で日常的に使っています。
CLAUDE.mdでAIの操作範囲を制限するコツ
MCPを使い始める前に、AIにしてほしくないことをCLAUDE.mdに明記しておくと安心して任せられます。
「秘密情報をコミットしない」「破壊的なgit操作は確認を取る」のようなルールを先に書いておけば、後から追加するより事故が少なくなります。
実際にこの運用に切り替えてから、意図しない操作で慌てる場面はほぼなくなりました。
Claude Codeの実践的な活用法をさらに体系的に学びたい方には以下の書籍もおすすめです。
MCPサーバーが繋がらないときのトラブルシューティング
設定したのに反応しない場合、原因はいくつかのパターンに絞られます。上から順に確認すれば大半は解決します。
/mcpコマンドで接続状況を確認する
まず/mcpで状態を見ましょう。それでも直らなければClaude Codeを再起動します。
「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. 公式ドキュメント上、サーバー数の上限は明記されていません。ツール定義は既定で必要になるまで読み込まれません（tool search）が、使わないサーバーは無効化しておくのが望ましいです。
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. JSON構文の確認、settings.jsonでの無効化設定の確認、Claude Codeの再起動、という順番で切り分けると原因が見つけやすいです。
まとめ｜MCPでClaude Codeの可能性を広げる
MCPは、Claude Codeを「ファイルを読み書きするだけのツール」から「外部サービスと連携して動くエージェント」に変える仕組みです。
設定はclaude mcp addコマンド一発で済み、スコープを使い分ければチームでも個人でも運用できます。
- まずはContext7かPlaywright MCPなど、APIキー不要のサーバーから試す
- チームで使うなら
-s project、個人なら-s userを選ぶ - 導入前に
CLAUDE.mdでAIの操作範囲を明記しておく - GitHubのような単発操作が中心のサーバーは、まず
ghコマンドなどのCLIで足りないか確認してから入れる
1つ入れて効果を確かめてから、次のサーバーを足していきましょう。この記事の構成をそのまま真似れば、迷わず自分の開発環境に合ったMCP構成が作れるはずです。
| REV. | DATE | 内容 |
|---|---|---|
| 2 | 2026-10-16 | 図解を描き直し（図面のデザインにそろえた） |
| 1 | 2026-08-09 | 初版 |