Claude CodeのMCP設定：2026年版・7つのサーバーと導入手順

Ailootの利用に関する追加の説明はドキュメントをご覧ください。

MCPサーバーとは何か、Claude Codeに必要な理由#

Anthropicは2024年11月25日に、オープン標準としてMCPを発表しました。それから1年で、このプロトコルは業界標準になり、OpenAI、Google DeepMind、Microsoftもサポートしています。公式のmodelcontextprotocol/serversリポジトリには、MCPプロジェクト自体が提供する参照サーバー（Filesystem、Memory、Sequential Thinking、Fetchなど）が含まれています。GitHub、Notion、Stripe、Linear、Cloudflare、Sentryなどのベンダーは、それぞれのリポジトリでMCPサーバーを公開しています。コミュニティのインデックスには数千のサーバーが掲載されています。

技術的には、MCPはJSON-RPC 2.0上で動作します。構成はシンプルです。Claude Codeがクライアントで、任意のサービスがサーバーとなり、その間にあるMCPサーバーには3つの要素があります。AIが呼び出せるtools、AIが読めるresources、そしてすぐに使えるテンプレートのpromptsです。

バイブコーダーにとって重要なのは、MCPが登場する前はClaudeとサードパーティサービスを接続するたびに、独自のラッパーを持つ個別の統合が必要だったことです。MCPを使えば、Postgres、Slack、GitHubの接続には似た形式のコマンドを3つ実行するだけです。不要になったときに接続を解除するのも同じくらい簡単です。

MCPはSkillsやサブエージェントとどう違うのか#

違いを整理するための簡単な表を示します。

実用上の目安はこうです。一度指定した作業をテキストとして繰り返すならSkillです。AIが外部システムからライブ応答を得る必要があるならMCPです。タスクが長く分岐し、別の頭脳が必要ならサブエージェントです。

隣接する2つの仕組みについて詳しくは、Claude Code Skills：独自のライブラリを構築する方法とClaude Codeサブエージェント：すぐ使える5つの例をご覧ください。

Claude Code MCP 設定 方法を5分で確認し、最初のコマンドを実行#

公式ドキュメントに記載されている完全な構文は次のとおりです。

claude mcp add <name> [options] -- <command> [args...]

3種類のトランスポートに対応しています。--transport stdio（デフォルト。ローカルプロセス）、--transport http（リモートHTTP）、--transport sse（非推奨と明記されています。サーバーがまだ移行していない場合のみ使用してください）です。

--scopeフラグでは3種類のスコープを指定できます。

• local — 現在のプロジェクトフォルダーだけで使用（デフォルト）。
• project — .mcp.jsonに書き込まれ、リポジトリにコミットされ、チーム全体で利用可能。
• user — マシン上のすべてのプロジェクトで利用可能。

MCPプロジェクトの参照用Filesystemサーバーを使った最小限の例です。30秒ほどで起動します。

claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem@2026.8.31 /Users/me/projects
claude mcp list

listを実行すると、コマンドで指定したフォルダーが存在する場合は一覧にfilesystemが表示されます。フォルダーがなければサーバーは起動しません。このサーバーはClaude Codeの作業フォルダー、つまりClaude Codeを起動したフォルダーを参照できます。その理由と、このサーバーが実際に役立つ場面については、後述の5.2で説明します。

MCPが接続されているか確認するには、Claude Codeのセッション内で/mcpを実行します。すべてのサーバー、そのステータス、ツール一覧が表示されます。Ailootの利用に関する追加の説明はドキュメントをご覧ください。選択したMCPサーバーのREADMEで、固有のコマンドを確認してください。

stdioとHTTP：どちらのトランスポートを選ぶべきか#

主な基準で比較します。

目安として、ディスク上またはローカルデータベースにあるものはstdioを使います。クラウド上にあるものはHTTPを使います。SSEは公式に非推奨とされているため、選ばないでください。

起業家向け、すぐに使える7つのMCPサーバー#

5.1. GitHub MCP — GitHub公式サーバー

できること：Claude Codeからissue、プルリクエスト、リポジトリのファイル、アクションの実行結果にアクセスできます。このサーバーはオープンソースで、GitHub上で30,000を超えるスターを獲得しています。

インストール（OAuth経由のHTTP）：

claude mcp add --transport http github https://api.githubcopilot.com/mcp/

OAuthではなくPATトークンが必要な場合は、Docker経由のstdioを使う方法もあります。

例：「bugラベルが付いた未解決のissueを読み、コンポーネントごとに分類して、対応を完了する順序を提案してください。」ClaudeはGitHub MCPを呼び出してすべてのissueを読み、優先順位を付けた一覧を返します。

リポジトリ：github/github-mcp-server。

5.2. Filesystem MCP — MCPプロジェクトの参照サーバー

できること：承認されたフォルダー内にあるコンピューター上のファイルに、AIがアクセスできるようにします。MCPプロジェクト自体が公開しており、npmレジストリではModel Context Protocol a Series of LF Projects, LLCが作者として記載されています。

インストール（stdio）。バージョンを固定します。

claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem@2026.8.31 /Users/me/projects

Claude Codeが接続すると、作業フォルダーをサーバーに渡し、コマンドで指定したフォルダーをすべて置き換えます。Claude Codeの作業フォルダーとは、起動した場所に加えて、/add-dirコマンドまたは--add-dirフラグで追加したフォルダーです。コマンドを使って、モックアップがある別のフォルダーをサーバーに指定することはできません。それでも、コマンドで指定したフォルダーは存在していなければならず、そうでないとサーバーは起動しません。

そのため、Claude Codeでは組み込みツールと機能が重複することがほとんどです。別のフォルダー内のファイルにアクセスするには、/add-dirを使うだけで十分です。追加後はClaude Codeの組み込みツールでもそのフォルダーを読み取れます。このサーバーがより役立つのは、独自のファイルアクセス機能を持たないプログラムです。Claude Desktopでは別の問題が起きる場合があります。サーバーのツール説明が古いスキーマ形式を使っているため、拒否されることがあります。この問題はまだ解決されていません。

コマンドと/add-dirの両方で、実際に必要なフォルダーだけにアクセスを許可してください。ディスクのルートへのアクセスを許可しないでください。これは最初に避けるべきセキュリティ上の穴です。

例：まず/add-dir ~/Documents/designを実行し、次に「~/Documents/design/landing-v3/にあるモックアップをすべて現在のプロジェクトに移動し、hero-*.pngの規則に従って名前を変更してください。」と頼みます。

5.3. Postgres MCP — DBHub（Bytebase）

できること：ClaudeをPostgres、MySQL、SQL Server、MariaDB、SQLiteに接続します。読み取り専用モードに対応しているため、AIエージェントがコマンド1つでデータベースを削除することはできません。Anthropicのアーカイブ済み参照サーバーserver-postgresの代替としてよく使われます。

インストール（読み取り専用のHTTP）：

claude mcp add postgres -- npx -y @bytebase/dbhub --dsn "postgresql://user:pass@localhost:5432/mydb?sslmode=disable" --readonly

本番データベースでは、必ず読み取り専用権限を持つ別ユーザーを使い、VIEWまたは中間APIルートを介して個人データを匿名化してください。書き込み権限を持つ状態で本番データベースに接続しないでください。

例：「サブスクリプションのステータスがexpiredで、過去1か月に該当する顧客を検索し、支払い総額の上位20件を一覧にしてください。」

リポジトリ：bytebase/dbhub。

5.4. Slack MCP — チームのコミュニケーション

できること：ClaudeがSlackのチャンネルを読み取り、メッセージを送れるようにします。自動化に役立ちます。「ビルドに成功したら#releasesに投稿する」「#engineeringから週次サマリーを作成する」といった作業ができます。

インストール（@modelcontextprotocol/server-slackやベンダー製の同等品など、npxラッパー経由のstdio）：

claude mcp add slack \
  -e SLACK_BOT_TOKEN=xoxb-... \
  -e SLACK_TEAM_ID=T0... \
  -- npx -y @modelcontextprotocol/server-slack

認証にはSlack Bot Tokenを使います。アクセス範囲はSlack側のスコープで制限できます。AIにchat:readとchat:write:userだけを与えれば、ワークスペースの設定を編集できません。エコシステムは急速に変化するため、選択したサーバーのREADMEで最新のコマンドを確認してください。

例：「毎朝9:00に、前日にマージされたPRの一覧を#dailyに送ってください。」

5.5. Notion MCP — ナレッジベース

できること：ClaudeがNotionのページやデータベースにアクセスできるようにします。これはプロジェクトの外にあるナレッジベースです。メモ、顧客台帳、編集方針などをそこに保存していれば、AIが読み取れます。

インストール（OAuth経由のHTTP）：

claude mcp add --transport http notion https://mcp.notion.com/mcp

または、Anthropic公式の@makenotion/claude-code-notion-pluginプラグインを使う方法もあります。

例：「Notionデータベースの『Customers』で、ステータスが『active』で、2週間以上電話していない人を探してください。それぞれにメールの下書きを作成してください。」

Notionのガイド：developers.notion.com/guides/mcp。

5.6. Sentry MCP — エラー追跡

できること：Claudeを本番システムのエラーに接続します。ページで500エラーが発生したとき、「プロジェクトのSentryで最新のissueを10件表示し、それぞれの根本原因を説明してください。」と頼めば、すぐに分析を得られます。

インストール（HTTP）：

claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

認証にはSentry OAuthを使います。特定のプロジェクトだけにアクセスを制限できます。

例：「過去24時間で発生頻度が最も高い3つのissueを取り上げてください。何が起きたかを平易な英語で説明し、修正方法を提案してください。」

リポジトリ：getsentry/sentry-mcp。

5.7. Playwright MCP — ブラウザーのワークフロー

できること：Claudeにブラウザーを使わせます。AIはページを開き、クリックし、フォームに入力し、スクリーンショットを撮影できます。UIの確認、公開後の手動テスト、ワークフローの解析に役立ちます。

インストール（stdio）：

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

2026年5月7日に公開されたバージョンv0.0.75は、Microsoftが積極的にメンテナンスしています（スター数は32,000以上）。

例：「ウェブサイトのホームページを開き、すべてのカードが正しく表示されることを確認して、デスクトップとモバイルのスクリーンショットを撮ってください。」

リポジトリ：microsoft/playwright-mcp。

選択したPlaywright MCPのバージョンのREADMEで、バージョンを固定したコマンド、複数のセッションを同時に実行するためのフラグ、よくあるインストールエラーを確認してください。

PreToolUse Hookでセキュリティを制御する方法#

SQL接頭辞のブラックリストは読み取り専用の境界ではありません。3つの大文字接頭辞では、小文字、コメント、UPDATE、INSERT、ALTER、複数文、副作用を持つ関数を覆えません。別のDBロールに読み取り専用権限を与え、使い捨てのテストDBで検証してください。フックは追加の呼び出し制御で、権限の代わりではありません。

以下は対象を絞った隔離の例です。詳しい方針の審査とテストが済むまで、3つのMCPサーバーファミリーの全操作を拒否し、読み取りも止めます。実際のツール名に合わせてください。改名したサーバー、Bash、別のコネクターは対象外です。

.claude/settings.jsonに別々のルールを入れます。

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "mcp__postgres__.*",
        "hooks": [{"type": "command", "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/deny-unapproved-mcp.sh\""}]
      },
      {
        "matcher": "mcp__slack__.*",
        "hooks": [{"type": "command", "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/deny-unapproved-mcp.sh\""}]
      },
      {
        "matcher": "mcp__filesystem__.*",
        "hooks": [{"type": "command", "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/deny-unapproved-mcp.sh\""}]
      }
    ]
  }
}

次を.claude/hooks/deny-unapproved-mcp.shへ保存します。旧形式のトップレベルdecision: approve/blockではなく、PreToolUseの公式判定仕様を返します。

#!/bin/bash
printf '%s\n' '{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"This MCP server family is quarantined pending a reviewed policy."}}'

このスクリプトはSQLを解析・分類せず、一致した呼び出しを常に拒否します。重要データをつなぐ前に隔離セッションで、SELECT 1、小文字delete、コメント付きUPDATE、Slackの読み取り・送信、Filesystemの.env読み取りが、名前が一致する場合にすべて拒否されるかを確認します。別ファミリーのツールが対象外になることも検証します。

DBの読み取りを許可するには検証済みの実権限を使い、隔離例を実際のツール向けに審査した方針へ置き換えます。Slackは読み取りだけなら送信権限のない認証を使い、ファイルはサーバーの許可ルートとプロセス権限を絞ります。別ツール、シェル、添付、エージェントが編集できる方針ファイルを通じたアクセスまで防ぐとは主張できません。

同じ手法はClaude CodeのPlan Modeガイドでも詳しく説明しており、「実行前に確認する」類似の仕組みが扱われています。

ツールが40個以上あり、Claudeが混乱する場合の対処法#

Claude Codeのドキュメントによると、現在はデフォルトで有効になっており、手動でオンにする必要はありません。

Claude Codeがすべてのツールを即座に読み込む例外があります。サードパーティのプロキシ経由で動作している場合（ANTHROPIC_BASE_URLにAnthropic以外のアドレスが設定されている場合）、Google Cloudで世代4.5より古いモデルを使う場合、Azure上でMicrosoft Foundryのデプロイを使う場合です。ENABLE_TOOL_SEARCH変数で動作を変更できます。

• 未設定 — すべてのMCPツールを遅延させ、必要に応じて読み込む。
• true — 同じ動作に加えて、Claude Codeがプロキシ経由で検索を有効にしようとする。
• auto — しきい値モード。すべてのツール説明がコンテキストウィンドウの10%未満であれば即座に読み込み、それを超えると遅延させる。
• auto:N — 同じ動作だが、しきい値の割合をカスタマイズできる。例：auto:5。
• false — 以前の動作。すべてのツールが即座にコンテキストに入る。

常に表示しておく必要がある重要なツールには、.mcp.jsonでサーバーの説明の横にalwaysLoad: trueフラグを指定できます。そのツールは最初からコンテキストを消費するため、Claudeがほとんどすべての応答で必要とするツールにだけ使ってください。

MCPサーバーが5つ以上あり、Claudeが呼び出すツールを間違える場合は、まず検索が無効になっていないか確認してください。設定内のENABLE_TOOL_SEARCH=falseを探し、プロキシ経由で動作しているかどうかも確認します。

/compactでコンテキストを減らす方法も役立つ場合があります。

MCPが不要なとき：Skill、サブエージェント、CLIのどれがよいか#

トークンコストと複雑さの順に並べると、次のとおりです。

1. Bash経由のCLIコマンド — ほぼ無料です。AIがgh pr list、psql -c、curlを実行し、通常のターミナルユーザーと同じような応答を得ます。
2. Skill — 安価です。何を呼び出し、結果をどう処理するかを指示する、すぐに使えるプロンプトテンプレートです。フォルダー名のトリガーに応じて読み込まれます。
3. サブエージェント — 中程度です。独自のトークンセッションを持ち、長いタスクのためにコンテキストを分けます。
4. MCPサーバー — 高コストです。コンテキストに残るのはツール名だけですが、呼び出し前にClaudeがツールを見つけると、説明が読み込まれます。また、サービスからの応答が大きくなる場合があります。Claude Codeはツールの応答が10,000トークンを超えると警告します。HTTPではOAuthセッションも必要です。

意外に思えるかもしれませんが、ウェブページの解析、gitの操作、PDFを開くこと、オープンソースのユーティリティの利用には、MCPではなくCLIを選んでください。AIは人間と同じようにターミナルコマンドを呼び出せます。ツールの説明やサーバーのオーバーヘッドなしに、コマンドとその応答だけでトークンを使います。

MCPが適しているのは、次の2つの場合です。

• サービスがクローズドである：Slack、Notion、Sentry、Linearなど。CLIツールもありますが、MCPならOAuthとスコープ制御を通じて、より細かくアクセスを管理できます。
• ライブな双方向のやり取りが必要である：AIがPostgresに接続してスキーマを確認し、追加のクエリを出し、データを取得して、次の手順に進みます。CLIで同じことをするには、手動で10個のコマンドを実行することになります。

MCP接続で避けるべき6つのパターン#

1. MCPの置き場。 「念のため」10個のサーバーを接続した結果、Claudeはどのツールを呼び出すか混乱し、応答がコンテキストを圧迫します。対策：現在のプロジェクトでは3〜5個のサーバーだけを残し、それ以外はclaude mcp removeで削除します。

2. 本番データベースへの書き込みアクセス。 --readonly、別ユーザー、許可リストhookを使わずにPostgres MCPを本番データベースに接続しました。「テストレコードを削除して」というプロンプト1つで、本番データが削除されます。対策：読み取り専用権限を検証した別のDBロール、利用できる場合のサーバーの読み取り専用モード、テスト済みの呼び出し制御を使います。DROP|TRUNCATE|DELETE接頭辞の拒否だけでは十分な認可になりません。

3. 匿名化していない個人情報。 顧客のメールアドレス、電話番号、パスポート情報を含むデータベースを直接接続しました。Claudeがデータを参照でき、それがAnthropicのログに残ります。対策：j***@gmail.comのようなマスク済みデータを返すVIEWまたは中間APIルートを使います。

4. Skillの代わりにMCPを使う。 「X形式の営業レポートを作成する」という定型作業には、すぐに使えるプロンプトを持つSkillで対応できます。MCPサーバーを作らないでください。

5. オープンソースCLIの代わりにMCPを使う。 PDFをテキストに変換するなら、pdftotextがあります。「PDF MCP」を作らないでください。トークンの無駄になります。

6. トークンコストを追跡しない。 接続したサーバーはclaude mcp listで確認できますが、会話ごとの使用量は把握できません。1週間後、「MCPがコンテキストの40%を消費し、それに気づかずずっと料金を払い続けていた」と知ることになります。対策：使っていないサーバーを定期的に無効にし、Claude Codeの使用制限の追跡で使用量の変化を確認してください。

MCP接続の失敗をデバッグする方法#

手順を追って確認します。

1. サーバーは一覧に表示されていますか？

   claude mcp list
   

   表示されない場合は、claude mcp addが完了していません。最もよくある原因は--scopeです。localスコープで追加したものを、別のプロジェクトから確認している可能性があります。

2. サーバーのステータスは緑色ですか？

   claude mcp status <name>
   

   赤色の場合は、stdioならプロセスが起動せず、HTTPならサーバーが応答していません。

3. サーバーログに役立つ情報がありますか？

   claude mcp logs <name>
   

   スタックトレースが表示された場合、通常はパッケージに問題があります（npxがパッケージを見つけられない、またはNodeのバージョンが20未満など）。

4. OAuthコールバックが戻ってきませんか？ 問題は通常、--callback-portまたはネットワークフィルターにあります。特定のポートを転送してください。

   claude mcp add --transport http --callback-port 8765 [name] [url]
   

5. ツール名が競合していますか？ 2つのサーバーが同じ名前のツールを公開しているため、Claudeが誤ったツールを呼び出します。Tool Search（前のH2を参照）を使うか、claude mcp removeで余分なサーバーを手動で削除してください。

6. claude.aiの拡張機能（コネクタ）が表示されませんか？ 既知の問題です。claude.aiのウェブインターフェースにある拡張機能（コネクタ）は、APIキーを使っている場合、Claude Codeでは利用できません。対策：ウェブインターフェースではなく、CLI経由でMCPを接続してください。

次のステップ：OAuth、独自のMCPサーバー、プラグインマーケットプレイス#

インストールコマンドを覚えたくない人にとって、Plugin Marketplaceは作業を効率化できます。形式は.claude-plugin/marketplace.jsonマニフェストで、1つのパッケージにまとめるサーバーのセットを記述します。

Marketplaceからプラグインをインストールします。

claude plugin install <plugin-name>

プラグインには複数のMCPサーバー、Skills、サブエージェントを一度に含められます。eコマース、マーケティング、法務部門など、特定のシナリオに合わせたパッケージ構成です。

modelcontextprotocol.ioの仕様に従って、独自のMCPサーバーを作成できます。最小限のテンプレートではAnthropicのPythonまたはTypeScript SDKを使い、ツールを記述してトランスポートを接続します。複雑さはFastAPIでREST APIを作るのと同程度です。

プロジェクトに設定済みのCLAUDE.mdがあり、コンテキストエンジニアリングを理解していれば、独自のMCPを追加するのに1日かかります。どちらもない場合は、まず基本を学ぶほうがよいでしょう。

モデルを使った作業を続けるには、Ailootにアクセスしてください。