結論先說
- Cloudflare 官方現在主推單一統一端點
https://mcp.cloudflare.com/mcp,連上這一個地址即可覆蓋全量 2,500 多個 API 端點(含 Workers、KV、D1、R2、DNS、Zero Trust)以及官方開發文檔。 - 採用 Code Mode(代碼模式)大幅省上下文:服務端只暴露
search()、execute()和docs()工具,初始僅佔約 1,000 tokens,避免傳統全量 Schema 吃掉百萬級上下文。 - 本地客戶端直接走 OAuth 網頁授權並勾選權限範圍;自動化流水線則可在請求頭傳入最小權限的 Cloudflare API Token。
- 除了單配 MCP,還可搭配官方
cloudflare/skills插件,把 MCP 連接與 Workers 最佳實踐規則一起裝進編程助手。 - 主力模型訂閱與帳號配套入口:跑通 MCP 工具鏈與多文件智能體編碼依賴穩定的底層大模型配額,國內免境外卡自助開通可見本站 Claude Code 訂閱頁、ChatGPT Plus 充值頁 與 AI 會員充值總覽。

圖:本站根據 Cloudflare 開發者文檔:Cloudflare's own MCP servers 整理的示意圖
本文根據 Cloudflare 開發者文檔《Cloudflare's own MCP servers》及 Claude Code 文檔整理,資料核對於 2026-11-18。配圖為本站整理的示意圖,不是介面截圖。本站(bigolab.com)不是 Cloudflare 或 Anthropic 官方網站。
適用於誰
- 想在 Claude Code、Cursor 或 Codex 裏直接查詢 Cloudflare Workers 運行狀態、操作 KV / D1 / R2 資源或檢索官方文檔的開發者;
- 以前裝過四五個拆分的 Cloudflare 子服務 MCP 導致上下文爆滿,想升級到官方統一端點的人;
- 需要弄清瀏覽器 OAuth 交互授權與 CI 自動化 API Token 權限控制的工程師。
一、為什麼只需連 https://mcp.cloudflare.com/mcp 一個地址
早期社區裏常見按產品拆分的多個遠程地址(如單獨的文檔服、Bindings 服、日誌觀測服),同時開啟十幾個工具集很容易拖慢編輯器響應。
按 Cloudflare 官方文檔現行架構,https://mcp.cloudflare.com/mcp 用 Code Mode(先搜尋再沙箱執行) 解決了工具膨脹問題:
| 實現方式 | 暴露工具數量 | 初始上下文佔用估算 |
|---|---|---|
| 傳統全量掛載完整 Schema | 2,594 個 | 約 1,170,000 tokens |
| 傳統僅掛載必填參數 | 2,594 個 | 約 244,000 tokens |
| 官方現行 Code Mode | 核心 search / execute + docs | 約 1,000 tokens |
模型接到你的指令後,先調 docs() 查最新語法或調 search() 在類型化 OpenAPI 規範裏找對應接口,再生成針對性 JavaScript 代碼放進隔離的 Dynamic Worker 沙箱通過 execute() 安全調用。關於本地與遠程 Streamable HTTP 的協議背景見 MCP 的 stdio、SSE 和 Streamable HTTP 有什麼區別。
二、在主流客戶端添加與帳號授權
1. Claude Code 與 Cursor 手動添加
在 Claude Code 終端運行:
bash
claude mcp add --transport http cloudflare-api https://mcp.cloudflare.com/mcp
隨後進入會話運行 /mcp 完成網頁登入。若在 Cursor 等支持標準 JSON 的客戶端中配置,直接寫入 mcp.json:
json
{
"mcpServers": {
"cloudflare-api": {
"url": "https://mcp.cloudflare.com/mcp"
}
}
}
首次連接時瀏覽器會跳轉到 Cloudflare 授權頁面,讓你確認帳號並勾選授予該 Agent 的具體權限範圍。客戶端詳細配置位置見 Claude Code MCP 配置教學 與 Cursor MCP 配置教學。如果平時用 Claude Code 全棧開發邊緣應用消耗額度較快,可在本站查看 Claude Code 訂閱充值。
2. 一鍵安裝 Cloudflare Skills 插件套裝
如果你使用支持 Agent Skills 標準的客戶端(Claude Code、Cursor、Codex 等),官方還提供了打包 MCP 與開發規則的 cloudflare/skills 插件。例如在 Claude Code 內可直接運行 /plugin marketplace add cloudflare/skills,有關技能與 MCP 的分工可參考 Skill 和 MCP 的區別是什麼。
3. CI/CD 與無瀏覽器環境使用 API Token
在自動化環境無法完成網頁 OAuth 時,前往 Cloudflare 控制檯創建僅含所需權限的用戶令牌(User token)或帳戶令牌(Account token),通過請求頭傳入:
json
{
"mcpServers": {
"cloudflare-api": {
"url": "https://mcp.cloudflare.com/mcp",
"headers": {
"Authorization": "Bearer 你的_CLOUDFLARE_API_TOKEN"
}
}
}
}
編程訂閱與高配額省心方案:在 Cursor、Claude Code 或 Codex 裏掛載外部工具做長鏈路開發時,固定月費訂閱通常比純按量 API 更易控成本。本站支持支付寶、微信支付與 AlipayHK 免密自助兌換 Claude Pro、Claude Max 與 ChatGPT Pro,團隊協作亦可定製 ChatGPT Business 團隊版。
三、查 Workers 日誌、KV / D1 數據庫與文檔檢索實戰
連接成功後,可以在同一個對話裏組合完成三類高頻任務:
- 查 Workers 報錯與觀測日誌:直接提問「查詢我帳號下
api-gatewayWorker 最近 1 小時的錯誤日誌與狀態碼分佈,定位 500 報錯原因」; - 讀寫 KV 命名空間與 D1 數據庫:讓助手「列出當前帳號下的所有 D1 數據庫並查看
users表結構,不要修改現有記錄」,或核對某個 Worker 綁定的 KV 鍵值配置; - 實時檢索官方最新文檔:寫配置前要求「先調
docs工具查 Cloudflare Workers 最新wrangler.jsonc裏 D1 綁定的標準寫法,再幫我改配置文件」,避免模型憑舊訓練記憶編造過時字段。

圖:本站根據 Cloudflare 開發者文檔:Cloudflare's own MCP servers 整理的示意圖
四、權限控制與常見問題排查
- 提示無權訪問某個域名(Zone)或存儲桶:OAuth 授權頁或 API Token 配置裏漏勾了對應產品的讀權限,重新授權或收窄/補齊對應資源的 Read 權限即可。
- 防止誤刪 DNS 解析或線上綁定:
execute()具備調用寫接口的能力,日常排障建議在授權時只給只讀(Read)權限,且不在客戶端對execute工具開啟免確認自動執行。
常見問題
問:還需要單獨配 docs.mcp.cloudflare.com 嗎?
答:如果只需要免登入查文檔、完全不想關聯自己的 Cloudflare 帳號,可以單獨配文檔端點;但只要連了 https://mcp.cloudflare.com/mcp,裏面已經內置了 docs() 文檔搜尋工具,無需重複掛載兩個伺服器。
問:名下有多個 Cloudflare 帳戶(Account)怎麼指定查哪一個?
答:在提示詞裏直接說明目標 Account 名稱或 Account ID,或者使用僅限單一帳戶範圍的 Account API Token,避免模型在多團隊帳號間查混資源。
問:怎麼撤銷已經授出去的 Cloudflare MCP 權限?
答:OAuth 登入可在客戶端斷開並在 Cloudflare 帳戶授權管理頁移除對應應用;若是 Bearer Token 方式,直接去控制檯 API Tokens 頁面執行吊銷(Roll / Revoke)即可立即失效。
問:配置好開發環境後,國內沒有外幣卡怎麼開通 Claude 或 ChatGPT 編程訂閱?
答:可在 本站充值中心 自助選購卡密開通 Claude Code(Pro / Max) 或 ChatGPT Plus / Pro,全程無需交出帳號密碼,支持開具增值稅發票;實時價格與售後邊界(封號不在質保範圍)以對應商品頁為準。
相關教學
- Claude Code MCP 配置教學:claude mcp add、配置文件位置與常用 MCP
- Cursor MCP 配置教學:mcp.json 寫法、項目與全局位置、OAuth 與連接失敗排查
- Skill 和 MCP 的區別是什麼:再加上子代理、Hook、CLAUDE.md,到底該選哪個
- MCP 的 stdio、SSE 和 Streamable HTTP 有什麼區別
參考資料
- Cloudflare 開發者文檔:Cloudflare's own MCP servers — https://developers.cloudflare.com/agents/model-context-protocol/cloudflare/servers-for-cloudflare/
- Claude Code 官方文檔:Connect Claude Code to tools via MCP — https://code.claude.com/docs/en/mcp
0 條評論
還沒有評論,來搶沙發~