Cloudflare の API MCP サーバーは claude mcp add で登録し、/mcp で OAuth 認証すれば Claude Code から Workers・D1・DNS を操作できます。search と execute で 2,500 超のエンドポイントを約 1,100 トークンに収める Code Mode の仕組みと、権限・上限の注意点を実行結果つきで解説します。
SNSでシェアして、他のエンジニアにも教えてあげましょう
Cloudflare MCP サーバーを Claude Code で使うには、claude mcp add --transport http cloudflare-api https:/ で登録し、Claude Code の中で / を開いて OAuth でログインするだけです。この「Cloudflare API MCP サーバー」は Code Mode という方式で作られていて、2,500 を超える API エンドポイントを search と execute の 2 つのツール（と docs）で扱います12。そのため、Claude Code の文脈を圧迫せずに Workers・D1・DNS などを会話から操作できます。この記事では、接続の手順、Code Mode でトークンが減る仕組み、実際の使い方と注意点を、筆者が手元で実行した出力つきで説明します（2026 年 10 月時点の情報です）。
Cloudflare MCP サーバーは、Cloudflare が自社で運用している MCP（Model Context Protocol：AI エージェントが外部のツールやデータにつながるための共通の規格）のサーバー群です。どれもリモートの MCP サーバーで、URL を登録するだけで使えます。自分でサーバーを立てる必要はありません3。
中心になるのは、Cloudflare API 全体を扱える Cloudflare API MCP サーバー（https:/）です。DNS・Workers・R2・Zero Trust など、2,500 を超える API エンドポイントにこの 1 本でアクセスできます3。ほかに、用途を絞ったプロダクト別のサーバーも公開されています。
| サーバー | URL | できること |
|---|---|---|
| Cloudflare API（Code Mode） | https:/ | API 全体（Workers・D1・R2・KV・DNS など）の検索と実行 |
| Documentation | https:/ | Cloudflare の開発者ドキュメントの検索 |
| Workers Bindings | https:/ | ストレージ・AI などのバインディングを使った開発 |
| Workers Builds | https:/ | Workers Builds のビルドの確認 |
| Observability | https:/ | Workers のログと分析を使ったデバッグ |
| Agents SDK Documentation | https:/ | Agents SDK のドキュメント検索 |
表は公式の一覧から開発でよく使うものを抜き出したものです。公式の一覧には、ほかに Radar・Browser Run・AI Gateway・Audit Logs・GraphQL など 16 のプロダクト別サーバーが載っています（2026 年 7 月 28 日更新時点）3。
結論として、まずは API サーバー（Code Mode）とドキュメントサーバーの 2 本をつなげば十分です。API サーバーは操作、ドキュメントサーバーは「正しい設定の書き方」の確認に使います。
Code Mode は、ツールを 1 つずつ呼ばせる代わりに、AI に API を呼ぶコードを書かせて、サーバー側の隔離環境で実行する方式です。Cloudflare は 2025 年 9 月 26 日のブログで、LLM は特殊なツール呼び出しよりも、学習データに大量にある「普通のコード」を書く方が得意だという考えを示しました4。2026 年 2 月 20 日には、この方式で Cloudflare API 全体を扱う MCP サーバーを公開しています1。
流れは次の 2 段階です2。
spec.paths）を検索する。一致したエンドポイントだけが返るcloudflare.request() で呼ぶ JavaScript を書いて実行する。API の結果だけが返るコードは Dynamic Worker と呼ばれる V8 の隔離環境で実行されます。ファイルシステムも環境変数もなく、外部への fetch は既定で無効です1。この仕組みは Workers の Dynamic Worker Loader API で作られています5。
普通の作り方では、エンドポイントを 1 つずつ MCP のツールとして登録します。すると、ツールの定義（名前・説明・入力スキーマ）がすべて AI の文脈に入ります。公式 README の比較では、その差は次のとおりです2。
| 方式 | トークン数（トークン） |
|---|---|
| OpenAPI 仕様をそのまま渡す | 2,000,000 |
| ネイティブ MCP（完全なスキーマ） | 1,170,523 |
| ネイティブ MCP（必須パラメータのみ） | 244,047 |
| Code Mode（3 ツール） | 1,100 |
| 方式 | ツール数 | トークン数 | 20 万トークンの文脈に対する割合 |
|---|---|---|---|
| OpenAPI 仕様をそのまま渡す | — | 約 2,000,000 | 977% |
| ネイティブ MCP（完全なスキーマ） | 2,594 | 1,170,523 | 585% |
| ネイティブ MCP（必須パラメータのみ） | 2,594 | 244,047 | 122% |
| Code Mode | 3 | 約 1,100 | 0.5% |
Cloudflare はブログで、Code Mode によって入力トークンを 99.9% 減らせると説明しています1。ツールを 1 つずつ並べる方式では、必須パラメータだけに絞っても 20 万トークンの文脈に収まりません。Code Mode なら、Claude Code に Cloudflare をつないでも、コードや会話に使える文脈はほとんど減りません。
Claude Code が実際に送るのは、次のようなコードです（README の例を短くしたもの）2。
// 1. Workers に関するエンドポイントを探す
search({
code: `async () => {
const results = [];
for (const [path, methods] of Object.entries(spec.paths)) {
for (const [method, op] of Object.entries(methods)) {
if (op.tags?.some(t => t.toLowerCase() === "workers")) {
results.push({ method: method.toUpperCase(), path, summary: op.summary });
}
}
}
return results;
}`,
});
// 2. 見つけたエンドポイントを呼ぶ
execute({
code: `async () => {
const res = await cloudflare.request({
method: "GET",
path: \`/accounts/\${accountId}/workers/scripts\`,
});
return res.result;
}`,
});
人がこのコードを書く必要はありません。「Workers の一覧を出して」と頼めば、Claude Code が仕様を探してコードを組み立てます。複数の API をまたぐ処理（ページ送りや、取得した ID を使った次の呼び出し）も 1 回の execute にまとめられるため、途中のデータが文脈に積み上がりません1。
理由は 3 つあります。
/ から認証できます6cloudflare タグの記事は、2026 年 10 月 5 日までの 14 日間で 3 件でした。その前の 14 日間は 0 件です（Qiita API で筆者集計）7。Google トレンド（日本・過去 90 日、2026-10-05 取得）の相対値でも、「Cloudflare Workers」は直近 4 週の平均が 2.0（その前の 8 週の平均は 0.8）、「MCP サーバー」は 5.0（同 4.8）でした8| 語 | その前 8 週の平均 | 直近 4 週の平均 |
|---|---|---|
| Cloudflare Workers | 0.8 | 2 |
| MCP サーバー | 4.8 | 5 |
Cloudflare でアプリを作るなら、Wrangler（Cloudflare の CLI）に加えて、MCP 経由で「ダッシュボードで確認していた作業」も Claude Code に任せられる段階に来ています。
前提は、Claude Code（筆者は 2.1.289 で確認）と Cloudflare のアカウントです。Wrangler のインストールは不要です。
プロジェクトのディレクトリで、次のコマンドを実行します6。
claude mcp add --transport http cloudflare-api https://mcp.cloudflare.com/mcp
実行すると、次のように表示されます（筆者の環境での実際の出力）。
Added HTTP MCP server cloudflare-api with URL: https://mcp.cloudflare.com/mcp to local config
File modified: /Users/<you>/.claude.json [project: /path/to/my-app]
--scope を付けないと local（自分だけ・このプロジェクトだけ）になります。すべてのプロジェクトで使うなら --scope user を付けます6。
| スコープ | 使える範囲 | 保存先 |
|---|---|---|
local（既定） | このプロジェクトで自分だけ | ~/ |
project | このプロジェクトをチームで共有 | プロジェクト直下の .mcp.json |
user | 自分のすべてのプロジェクト | ~/ |
登録した直後は、まだ認証していません。claude mcp list を実行すると、次のように表示されます。
cloudflare-api: https://mcp.cloudflare.com/mcp (HTTP) - ! Needs authentication
このときサーバーは 401 を返し、WWW-Authenticate ヘッダーで OAuth の情報を伝えています。筆者が curl で確かめたところ、要求されるスコープは user:read account:read でした。
HTTP/2 401
www-authenticate: Bearer realm="OAuth", resource_metadata="https://mcp.cloudflare.com/.well-known/oauth-protected-resource/mcp", scope="user:read account:read"
Claude Code を起動して / を開き、cloudflare-api を選んで認証します。ブラウザで Cloudflare のログイン画面が開き、どの権限を渡すかを自分で選んで許可します13。トークンは macOS ならキーチェーンに保存され、期限が切れると自動で更新されます6。ターミナルから claude mcp login cloudflare-api で認証することもできます6。
設定の書き方を調べる用途には、ドキュメントサーバーを足しておくと便利です。こちらは認証なしで接続できます。
claude mcp add --transport http cloudflare-docs https://docs.mcp.cloudflare.com/mcp
筆者が tools/ を送って確かめたところ、search_cloudflare_documentation と migrate_pages_to_workers_guide の 2 つのツールが返りました（2026 年 10 月 5 日時点）。
ブラウザを開けない CI や、権限をトークンで管理したい場合は、API トークンを Bearer トークンとして渡します23。
export CLOUDFLARE_API_TOKEN="（ダッシュボードで作ったトークン）"
claude mcp add --transport http cloudflare-api https://mcp.cloudflare.com/mcp \
--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"
ユーザートークンとアカウントトークンのどちらも使えます。アカウントトークンには Account Resources : Read の権限を含めると、サーバーがアカウント ID を自動で見つけます2。トークンの作り方は公式ドキュメントにあります9。
チームで同じ設定を使うなら、--scope project で .mcp.json に書き出します。トークンは環境変数で展開し、ファイルに直接書かないようにします6。
{
"mcpServers": {
"cloudflare-api": {
"type": "http",
"url": "https://mcp.cloudflare.com/mcp"
},
"cloudflare-docs": {
"type": "http",
"url": "https://docs.mcp.cloudflare.com/mcp"
}
}
}
OAuth で使う場合は、上のように URL だけを書けば十分です。各メンバーが自分のアカウントで / から認証します。
つないだあとは、Claude Code に日本語で頼むだけです。公式 README の例は「Workers を一覧して」「my-cache という KV の名前空間を作って」「api.example.com の A レコードを 192.0.2.1 に向けて追加して」です2。開発の場面ごとに、次のように使い分けられます。
| 場面 | 頼み方の例 | 主に使う API |
|---|---|---|
| 調査 | 「このアカウントの Workers を、最終更新日つきで一覧にして」 | Workers Scripts |
| 実装 | 「wrangler.jsonc の D1 の database_id が本物と合っているか確かめて」 | D1 のデータベース一覧 |
| 運用 | 「本番の D1 で SELECT count(*) FROM articles を実行して」 | D1 のクエリ |
| 設定 | 「staging.example.com の CNAME を追加して」 | DNS Records |
| 分析 | 「このゾーンの直近 7 日のリクエスト数を日別に出して」 | GraphQL Analytics |
GraphQL Analytics API も同じ execute で呼べます2。ダッシュボードを開いて数字を拾っていた作業を、会話の中で済ませられます。
Workers のアプリを Claude Code で作る全体の流れは Claude Code で Cloudflare Workers アプリを作る全手順 を、D1 を使う API は Hono＋D1 の REST API を Claude Code で作る を参照してください。
execute は書き込みも削除もできます。Claude Code の許可設定では、MCP のツールを mcp__<サーバー名>__<ツール名> の形で指定できます10。たとえば、検索は自動で許可し、実行は毎回確認するなら次のように書きます。
{
"permissions": {
"allow": [
"mcp__cloudflare-api__search",
"mcp__cloudflare-api__docs",
"mcp__cloudflare-docs__*"
],
"ask": ["mcp__cloudflare-api__execute"]
}
}
あわせて、OAuth の同意画面や API トークンでは、必要な権限だけを渡します。AI に渡せるのは、ユーザーが明示的に許可した権限だけです1。
迷ったら、デプロイやローカル開発は Wrangler、アカウントの状態の確認や設定の変更は API MCP サーバーと分けるのが分かりやすいです。
| 方法 | 向いている作業 | 注意点 |
|---|---|---|
| Wrangler（CLI） | wrangler dev・wrangler deploy・マイグレーションなど、コードと一緒に管理する作業 | Claude Code からは Bash で呼ぶ。手順がリポジトリに残る |
| Cloudflare API MCP（Code Mode） | アカウント全体の確認・DNS・設定変更・分析など、API でできるほぼすべて | 書き込みもできるので、権限と許可ルールを絞る |
| プロダクト別 MCP（Observability など） | ログの調査など、特定の作業を手早くする | 用途ごとに登録が必要 |
| Documentation MCP | 設定の書き方・制限値の確認 | 読み取り専用で認証不要 |
すでに自分のクライアント側で Code Mode を使っている場合は、URL に ?codemode=false を付けると、エンドポイントごとのツールとして登録されます。ただし約 1,000 トークンが約 24 万トークンに増えるため、README も必要なときだけにするよう勧めています2。
自分で MCP サーバーを作って Cloudflare に置きたい場合は、Cloudflare Workers にリモート MCP サーバーをデプロイする を、状態を持つエージェントを作るなら Cloudflare Agents SDK で AI エージェントを作る を参照してください。
| 症状 | 原因 | 対処 |
|---|---|---|
! Needs authentication のまま | OAuth を済ませていない | Claude Code で / を開いて認証する。または claude mcp login cloudflare-api6 |
| API トークンで接続できない | トークンに「Client IP Address Filtering」を設定している | IP 制限付きのトークンは未対応。制限なしのトークンを使う2 |
| アカウント ID を毎回聞かれる | アカウントトークンに Account Resources : Read がない | 権限を足すか、プロンプトでアカウント ID を伝える2 |
| 一覧の途中で結果が切れる | ツールの結果は既定で約 6,000 トークンに切り詰められる（--- TRUNCATED --- の印が付く） | 条件を絞って頼む。クライアント側で結果を制限できる場合だけ ?truncateToolResult=false を付ける2 |
| 大きな結果で警告が出る | Claude Code は MCP の出力が 1 万トークンを超えると警告し、既定の上限は 2 万 5,000 トークン | 必要なら MAX_MCP_OUTPUT_TOKENS で上限を変える6 |
| 意図しない変更が怖い | execute は書き込みもできる | 読み取りだけの権限で認証し、execute を ask にする |
特に、本番のアカウントにつなぐときは「まず読み取り権限だけで試す」ことをおすすめします。書き込みが必要になったら、権限を足して認証し直せば済みます。
claude mcp add --transport http cloudflare-api https:/ で登録し、/ で OAuth 認証すれば使えるdocs・search・execute の 3 ツールで、2,500 超のエンドポイントを約 1,100 トークンに収める（ネイティブ MCP なら 1,170,523 トークン）Authorization: Bearer で渡す。IP 制限付きのトークンは使えないmcp__cloudflare-api__execute を ask）と OAuth の権限で絞るMCP サーバーへの接続そのものに料金の記載はなく、操作した Cloudflare の各サービス（Workers・D1 など）の料金体系がそのまま適用されます。公式のドキュメントにも MCP サーバー自体の料金は書かれていません（2026 年 10 月時点）3。
Code Mode の API サーバーは、1 本で Cloudflare API 全体を扱えます。プロダクト別サーバーは Observability や Radar など用途ごとに分かれています3。操作の幅が必要なら API サーバー、ログ調査など決まった作業ならプロダクト別サーバーが手早いです。
使えます。URL（https:/）を登録できる MCP クライアントなら、OAuth か API トークンで接続できます。公式ドキュメントは mcpServers の JSON 設定の例を載せています3。
コードは Dynamic Worker の隔離環境で動き、ファイルシステムや環境変数はなく、外部 fetch も既定で無効です1。ただし、渡した権限の範囲では書き込みや削除もできます。読み取りだけの権限で認証し、Claude Code の許可ルールで execute を毎回確認にすると安全です。
基本的には不要です。Code Mode のサーバーはツール定義が約 1,100 トークンしかありません2。Claude Code は MCP ツールの検索（tool search）も既定で有効にしています6。大きな結果を扱うときだけ、MAX_MCP_OUTPUT_TOKENS の調整を検討します。
Code Mode: give agents an entire API in 1,000 tokens — Cloudflare Blog, 2026-02-20（2026-10-05 参照） ↩ ↩2 ↩3 ↩4 ↩5 ↩6 ↩7 ↩8 ↩9
cloudflare/mcp（README） — Cloudflare, GitHub（2026-10-05 参照） ↩ ↩2 ↩3 ↩4 ↩5 ↩6 ↩7 ↩8 ↩9 ↩10 ↩11 ↩12 ↩13
Cloudflare's own MCP servers — Cloudflare Docs, 2026-07-28 更新（2026-10-05 参照） ↩ ↩2 ↩3 ↩4 ↩5 ↩6 ↩7 ↩8 ↩9
Code Mode: the better way to use MCP — Cloudflare Blog, 2025-09-26（2026-10-05 参照） ↩
Dynamic Worker Loader — Cloudflare Docs（2026-10-05 参照） ↩
Connect Claude Code to tools via MCP — Anthropic, Claude Code Docs（2026-10-05 参照） ↩ ↩2 ↩3 ↩4 ↩5 ↩6 ↩7 ↩8 ↩9
Qiita API v2 ドキュメント — Qiita（タグ別の記事数は筆者集計、2026-10-05 取得） ↩
Google トレンド（日本・過去 90 日） — Google（相対値、2026-10-05 取得） ↩
Create API token — Cloudflare Docs（2026-10-05 参照） ↩
Configure permissions — Anthropic, Claude Code Docs（2026-10-05 参照） ↩