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

> Claude CodeのMCP設定を5分で始める方法。claude mcp add、stdioとHTTP、設定範囲、7つのサーバー、hooksによる許可リスト、/mcpでの接続確認を解説します。

Source: https://ailoot.ai/blog/ja/mcp-servers-claude-code/
Canonical: https://ailoot.ai/blog/ja/mcp-servers-claude-code/
Language: ja
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-172
Revision: sha256-d1b831189ed9091df81b36970b82c33ed7ac807ea22b7f59f98cff7ec3548121


Ailootの利用に関する追加の説明は[ドキュメント](https://ailoot.ai/docs/)をご覧ください。



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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="このセクションの重要なポイント">

重要なポイント

MCP（Model Context Protocol）はAnthropicが公開したオープン標準で、統一されたインターフェースを通じてClaude Codeが外部のツールやデータにアクセスできるようにします。10種類の異なるAPIを使う代わりに、1つのプロトコルを使います。Anthropicはこれを「AIアプリケーションのUSB-C」と呼んでいます。ポートに接続すれば、Claudeはデータベース、メール、メッセンジャー、リポジトリを参照できます。

</div>

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`です。

<figure>
<blockquote>
USB-Cがさまざまな周辺機器を接続するための標準的な方法を提供するように、MCPはAIモデルをさまざまなデータソースやツールに接続する標準的な方法を提供します。
</blockquote>
<figcaption>— Model Context Protocol、https://modelcontextprotocol.io/</figcaption>
</figure>

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

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="このセクションの重要なポイント">

重要なポイント

3つの仕組みは似ているように見えますが、解決する問題は異なります。Skillsはワークフローやプロンプトをコードとして扱うものです。サブエージェントは、それぞれ独自のコンテキストを持つ専門の「同僚」です。MCPはClaudeがサービスやデータにアクセスするための外部ツールを提供します。トークンコストも異なり、最も安価なのはSkillで、MCPは通常より高コストです。MCPは最初、ツール名とサーバーの指示だけをコンテキストに入れ、必要に応じてClaudeが詳しい説明を読み込みます。コストの大半はサービスからの応答によるもので、応答が大きく、会話に残る場合があります。

</div>

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

| 仕組み | 内容 | 使用する場面 | トークンコスト |
|----|----|----|----|
| Skill | `.claude/skills/`にある指示とプロンプトのファイル | メール作成、レポート作成、投稿公開などのワークフローを繰り返すとき | 低。トリガーに応じて読み込まれる |
| サブエージェント | 独自のコンテキストとツールを持つ別のエージェント | レビュー、監査、調査など、長時間にわたる並行タスク | 中。独自のコンテキストを使う |
| MCPサーバー | JSON-RPCを介してツールやリソースを提供するサービス | データベース、メール、メッセンジャー、リポジトリなど、ライブデータへのアクセスが必要なとき | 中から高。コンテキストに残るのはツール名だけで、説明は必要に応じて読み込まれる。サービスの応答は大きくなる場合がある |

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

隣接する2つの仕組みについて詳しくは、[Claude Code Skills：独自のライブラリを構築する方法](https://ailoot.ai/blog/ja/claude-code-skills-library/)と[Claude Codeサブエージェント：すぐ使える5つの例](https://ailoot.ai/blog/ja/claude-code-subagents/)をご覧ください。

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="このセクションの重要なポイント">

重要なポイント

どの場合でも同じ構文を使います。`claude mcp add [name] -- [launch command]`です。サーバーは`claude mcp list`の一覧に表示されます。その後、Claudeがサーバーのツールを検出し、会話の中で使い始めます。設定を手作業で編集する必要はなく、すべてCLI経由で行えます。

</div>

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

```bash
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秒ほどで起動します。

```bash
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の利用に関する追加の説明は[ドキュメント](https://ailoot.ai/docs/)をご覧ください。選択したMCPサーバーのREADMEで、固有のコマンドを確認してください。

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="このセクションの重要なポイント">

重要なポイント

stdioは自分のマシン上で動くローカルプロセスです。ネットワークがなくてもすべて動作し、OAuthも不要です。HTTPはトークンまたはOAuthでアクセスするリモートサービスで、複数のデバイスから共有できます。MCPサーバーを`npx`または`uvx`でインストールする場合はstdioを使います。サービスに独自の公開サービスアドレスがある場合はHTTPを使います。SSEは公式に非推奨とされているため、利用を前提にしないでください。

</div>

主な基準で比較します。

| 基準 | stdio | HTTP |
|----|----|----|
| 実行場所 | ローカル（Claude Codeの子プロセス） | リモートサーバー |
| 認証 | 不要 | OAuth 2.1またはBearerトークン |
| ネットワークポート | なし | 公開アドレス |
| 使用例 | Filesystem、Postgres、ローカルユーティリティ | GitHub、Slack、Notion、Linear、Sentry |
| 再接続 | 不要 | 指数バックオフ、最大5回 |
| デプロイ | ローカルにパッケージをインストール | ベンダーのサービス |

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

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="このセクションの重要なポイント">

重要なポイント

バイブコーダーのタスクの80%をカバーする7つの構成を紹介します。コード（GitHub）、ファイル（Filesystem）、データベース（DBHub経由のPostgres）、チーム内のコミュニケーション（Slack）、ナレッジベース（Notion）、エラー追跡（Sentry）、ブラウザーのワークフロー（Playwright）です。各構成について、1行のインストールコマンドと、実際の会話でClaudeに作業を頼む具体例を紹介します。

</div>

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

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

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

```bash
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](https://github.com/github/github-mcp-server)。

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

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

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

```bash
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）：

```bash
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](https://github.com/bytebase/dbhub)。

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

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

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

```bash
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）：

```bash
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](https://developers.notion.com/guides/mcp/get-started-with-mcp)。

### 5.6. Sentry MCP — エラー追跡

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

インストール（HTTP）：

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

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

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

リポジトリ：[getsentry/sentry-mcp](https://github.com/getsentry/sentry-mcp)。

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

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

インストール（stdio）：

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

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

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

リポジトリ：[microsoft/playwright-mcp](https://github.com/microsoft/playwright-mcp)。

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



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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="このセクションの重要なポイント">

重要なポイント

MCPはAIに大きな力を与えます。データベースへの書き込み、メッセージの送信、ファイルの削除が可能です。PreToolUseフックは一致するツール呼び出しを制御できますが、SQLの接頭辞の正規表現はDBの認可ではありません。PostgresだけのmatcherはSlackやファイルツールを覆いません。サービスとファイルシステムの実権限を先に使い、フックの正確な範囲は別にテストします。

</div>

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

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

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

```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の公式判定仕様](https://code.claude.com/docs/en/hooks#pretooluse-decision-control)を返します。

```bash
#!/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](https://ailoot.ai/blog/ja/claude-code-plan-mode/)ガイドでも詳しく説明しており、「実行前に確認する」類似の仕組みが扱われています。

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="このセクションの重要なポイント">

重要なポイント

サーバーが7つあると、ツールは簡単に50〜100個になります。Claude CodeではTool Searchがデフォルトで有効です。起動時にはツール名とサーバーの指示だけがコンテキストに入り、Claudeはツールが必要になった時点で詳しい説明を読み込みます。検索がオフの場合は、すべての説明が一度に読み込まれ、ツールが約40個を超えるとClaudeは混乱し始めます。間違ったツールを選んだり、通常のコマンドで済む場面でMCPを使おうとしたりします。

</div>

[Claude Codeのドキュメント](https://code.claude.com/docs/en/mcp#scale-with-mcp-tool-search)によると、現在はデフォルトで有効になっており、手動でオンにする必要はありません。

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でコンテキストを減らす](https://ailoot.ai/blog/ja/claude-code-token-limits-saving/)方法も役立つ場合があります。

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="このセクションの重要なポイント">

重要なポイント

トークンの観点では、Claudeに外部機能を与える方法の中でMCPが最も高コストです。既成のCLIツール（`gh issue list`、`psql`、`curl`）や1ページのSkillで対応できるなら、MCPサーバーを作らずにそれらを使ってください。目安は、AIにサービスとのライブな双方向のやり取りが必要な場合だけMCPを使うことです。単発の応答で済むなら必要ありません。

</div>

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

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つのパターン

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="このセクションの重要なポイント">

重要なポイント

MCPを使い始めて最初の数週間に、バイブコーダーがつまずきやすい具体的な間違いを6つ紹介します。それぞれ1分で見直せます。`claude mcp list`を開いて一覧を確認し、スコープとhookを点検してください。問題の多くは、新しいサーバーを追加するのではなく、不要なサーバーを削除することで解決します。このセクションは上から順に確認できる短いチェックリストです。

</div>

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の使用制限の追跡](https://ailoot.ai/blog/ja/claude-code-token-limits-saving/)で使用量の変化を確認してください。

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="このセクションの重要なポイント">

重要なポイント

よくある問題は、OAuthコールバックが動作しない、サーバー名が既存の名前と競合する、`add`の実行後に`claude mcp list`にツールが表示されない、などです。標準的なトラブルシューティングの手順で解決できます。`list`で接続状況を確認し、`status`でステータス表示を調べ、赤色なら`logs`でスタックトレースを確認します。`--scope`またはENV変数を変更した後は、すべて再起動してください。

</div>

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

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

    ```bash
    claude mcp list
    ```

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

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

    ```bash
    claude mcp status <name>
    ```

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

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

    ```bash
    claude mcp logs <name>
    ```

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

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

    ```bash
    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サーバー、プラグインマーケットプレイス

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="このセクションの重要なポイント">

重要なポイント

すぐに使える7つのサーバーの次に取り組むのは、独自のHTTPサーバーをチームで共有したい場合のOAuth、独自サービス向けのMCPの作成、AnthropicのPlugin Marketplaceへの接続の3つです。Marketplaceは2025年10月9日に開始され、1つのコマンドでインストールできるプラグインにMCPをまとめています。

</div>

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

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

```bash
claude plugin install <plugin-name>
```

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

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

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

<div class="section" role="doc-bibliography" aria-label="出典">

### 出典

- [Model Context Protocol — 公式サイト](https://modelcontextprotocol.io/)
- [Anthropic Introduces MCP — 2024年11月25日](https://www.anthropic.com/news/model-context-protocol)
- [Claude Code MCPドキュメント](https://code.claude.com/docs/en/mcp)
- [Claude Code：MCP Tool Search](https://code.claude.com/docs/en/mcp#scale-with-mcp-tool-search)
- [Claude Code Pluginsの発表 — 2025年10月9日](https://claude.com/blog/claude-code-plugins)
- [Code with Claude 2026](https://claude.com/code-with-claude)
- [modelcontextprotocol/servers — 公式レジストリ](https://github.com/modelcontextprotocol/servers)
- [github/github-mcp-server](https://github.com/github/github-mcp-server)
- [microsoft/playwright-mcp](https://github.com/microsoft/playwright-mcp)
- [bytebase/dbhub — Postgres MCP](https://github.com/bytebase/dbhub)
- [getsentry/sentry-mcp](https://github.com/getsentry/sentry-mcp)
- [makenotion/claude-code-notion-plugin](https://github.com/makenotion/claude-code-notion-plugin)
- [Notion MCPガイド](https://developers.notion.com/guides/mcp/get-started-with-mcp)
- [Anthropic Claude Codeリポジトリ — issueと変更履歴](https://github.com/anthropics/claude-code)

</div>





モデルを使った作業を続けるには、[Ailoot](https://ailoot.ai/)にアクセスしてください。

## Claude CodeのMCP設定【2026年版】：7つのサーバーと導入手順：よくある質問

### このフックで本番DBを読み取り専用にできますか？

いいえ。例は指定MCPファミリーへの全呼び出しを隔離し、SQLを分類しません。読み取り専用は、検証した権限を持つ別のDBロールで実現します。フックは追加の制御として使ってください。

### フックの対象範囲はどう試しますか？

隔離セッションで、一致するツール名の読み取りと書き込み、小文字やコメント付きSQLがすべて拒否されるか確認します。無関係なツールが対象外なことも調べ、その経路には別の権限や方針を用意してください。


## Ailoot · 企業とそのプロジェクト群

Ailootは、蓄積した運営経験、幅広い顧客基盤、安定したサービス、継続的なKPI管理を基盤としています。

企業とそのプロジェクト群：数百万の顧客、毎月数十億規模の売上。

Ailootはこの運営経験を、お客様の製品、エージェント、アプリケーション、自動化でAI機能を利用するためのAPIアクセスに活かしています。
