Cloudflare 官方 MCP Server 怎麼配:查 Workers 日誌、KV / D1 數據庫、文檔檢索與帳號授權

Cloudflare 官方統一遠程 MCP 伺服器 https://mcp.cloudflare.com/mcp 採用 Code Mode 模式覆蓋超 2500 個接口與開發文檔。本文整理配置方法、查 Workers / KV / D1 用法與 OAuth 授權。

NNathaniel bigo··原創首發·AI 輔助撰寫
12 分鐘讀完
資料核對於 2026-11-18 · 依據官方文檔與公開資料整理 免費帳號 帳號

結論先說

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

Cloudflare 統一遠程 MCP 工作模式與配置步驟

圖:本站根據 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(先搜尋再沙箱執行) 解決了工具膨脹問題:

實現方式暴露工具數量初始上下文佔用估算
傳統全量掛載完整 Schema2,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 數據庫與文檔檢索實戰

連接成功後,可以在同一個對話裏組合完成三類高頻任務:

  1. 查 Workers 報錯與觀測日誌:直接提問「查詢我帳號下 api-gateway Worker 最近 1 小時的錯誤日誌與狀態碼分佈,定位 500 報錯原因」;
  2. 讀寫 KV 命名空間與 D1 數據庫:讓助手「列出當前帳號下的所有 D1 數據庫並查看 users 表結構,不要修改現有記錄」,或核對某個 Worker 綁定的 KV 鍵值配置;
  3. 實時檢索官方最新文檔:寫配置前要求「先調 docs 工具查 Cloudflare Workers 最新 wrangler.jsonc 裏 D1 綁定的標準寫法,再幫我改配置文件」,避免模型憑舊訓練記憶編造過時字段。

Cloudflare MCP 常見操作與權限排錯決策

圖:本站根據 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,全程無需交出帳號密碼,支持開具增值稅發票;實時價格與售後邊界(封號不在質保範圍)以對應商品頁為準。

相關教學

參考資料

  • 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

Nathaniel 的更多內容

  1. 01

    獨立開發者用 ChatGPT + Codex 跑通產品全流程:市場驗證、PRD、原型到代碼上線覆盤清單

    單人做獨立產品最容易陷入「閉門寫兩個月代碼上線零用戶」或「AI 寫到一半目錄越改越崩」。本文整理「ChatGPT 負責市場驗證、PRD 與覆盤 + Codex 負責工程實現與測試」的五階段雙軌流程,附起手提示詞與 7 項上線覆盤清單。

    ChatGPTCodex0
  2. 02

    用 ChatGPT 批量生成規範文件命名規則、整理混亂目錄樹與合併零散發票抬頭清單腳本

    面對滿桌面的「新建文件夾」「最終版2」和上百張零散電子發票,手工改名抄台帳耗時又容易漏重。本文分享先脫敏取樣、再用 ChatGPT 生成帶預演和回滾日誌的本地 Python 腳本,離線安全完成目錄整理與發票抬頭合併去重的實戰流程。

    ChatGPT0
  3. 03

    用 ChatGPT 做海外電郵營銷(EDM)受眾分層文案、A/B 主題行測試與防進垃圾箱自檢

    做海外獨立站或出海 SaaS 電郵營銷(EDM),最怕千人一面群發被直接送進垃圾箱。本文結合 Gmail/Yahoo 批量發件人規範,梳理用 ChatGPT 設計受眾分層文案、批量生成 A/B 主題行矩陣並開展發前垃圾詞與合規自檢的實戰提示詞。

    ChatGPT0
  4. 04

    用 ChatGPT 寫 Notion Formula 2.0 公式、Obsidian Dataview 查詢與 Airtable 自動化腳本

    給 Notion 數據庫寫多條件 Formula 2.0 公式、給 Obsidian 寫 Dataview 動態看板,或在 Airtable 裏寫自動化腳本,經常因為一個小括號或類型不匹配報錯半天。本文整理三大工具的通用上下文喂料規範與三套直接可複製的生成提示詞。

    ChatGPT其他 AI 工具0
  5. 05

    用 ChatGPT 處理複雜 JSON / YAML / XML 字段映射、格式轉換與校驗規則編寫實戰

    對接第三方 API、遷移 Kubernetes 配置或解析政企 XML 報文時,手工對照幾百行嵌套字段既慢又容易漏掉空值與類型邊界。本文整理用 ChatGPT 完成字段映射表梳理、生成確定性轉換腳本以及編寫 JSON Schema / Pydantic / XSD 校驗規則的實戰流。

    ChatGPT其他 AI 工具0
  6. 06

    用 ChatGPT 準備本科/碩士畢業論文答辯:提煉答辯 PPT 結構、模擬導師犀利追問與 3 分鐘自述稿

    畢業論文寫完後,要在 3–5 分鐘內講清研究價值並頂住答辯評委的連環追問並不輕鬆。本文整理在嚴格遵守高校學術規範的前提下,用 ChatGPT 提煉答辯 PPT 結構、打磨 3 分鐘口語自述稿並開展模擬導師犀利追問的排練流程與提示詞。

    ChatGPT0

同產品的其他教學

  1. 01

    用 ChatGPT 速讀英文產品手冊、開源文檔與 GitHub Issue 並沉澱團隊中文內訓手冊

    團隊引入海外 SaaS 工具或開源框架時,全英文文檔晦澀冗長、真正的坑全藏在幾十頁 GitHub Issue 討論裏。本文分享速讀拆解英文手冊、歸類 Issue 排障庫以及重構團隊中文內訓 SOP 的完整實戰流程。

    ChatGPT其他 AI 工具0
  2. 02

    用 ChatGPT 寫油猴腳本(Tampermonkey)與瀏覽器書籤小工具解決網頁繁瑣重複操作實戰

    每天在後台系統裏重複勾選幾十個複選框、手工複製網頁表格或清理遮擋閱讀的側邊欄,既枯燥又浪費時間。本文分享不會寫 JS 也能用 F12 配合 ChatGPT 寫出油猴腳本與書籤小工具的完整實戰流程。

    ChatGPT其他 AI 工具0
  3. 03

    用 ChatGPT 寫高質素 SQL 窗口函數(RANK / LAG / SUM OVER)做留存與漏斗分析實戰

    做用戶留存率、復購間隔與有序轉化漏斗時,多層自連接既難讀又拖垮數據庫,窗口函數則是高效解法。本文整理數據庫方言喂數規範、CTE 分層提示詞以及用內置沙盒先驗證再上線的完整實戰流程。

    ChatGPT其他 AI 工具0
  4. 04

    ChatGPT 連接 Canva、Figma、Linear、Jira、Dropbox 等第三方應用搜不到數據或授權失效怎麼辦

    在 ChatGPT 接入 Canva、Figma、Linear、Jira 或 Dropbox 後,明明顯示已連接卻搜不到文件工單,或老提示授權失效怎麼辦?本文拆解帳號錯綁、OAuth 範圍漏選、權限繼承與管理員攔截 5 步排障法。

    ChatGPT其他 AI 工具0
  5. 05

    Anthropic Contextual Retrieval(上下文增強檢索)是什麼、怎麼實現:給文檔塊自動補背景摘要結合緩存降失誤率

    長文檔切成小塊後丟了公司名、年份和主語指代導致 RAG 頻頻搜錯?本文按 Anthropic 官方技術文章詳解 Contextual Retrieval 原理、官方公開評測失誤率下降 49% 至 67% 的組合架構,以及用 Claude 提示詞緩存低成本批量生成切片背景的完整 Python 代碼。

    Claude其他 AI 工具0
  6. 06

    RAG 知識庫回答不準怎麼調優:切片大小(Chunking)、BM25 + 向量混合檢索與 Rerank 重排序三步排查法

    搭好的 RAG 企業知識庫一問具體型號、報錯碼或跨行表格就答非所問?本文按 OpenAI 與 Anthropic 官方檢索文檔,給出先隔離檢索與生成故障、再按結構化切片(Chunking)、BM25 加向量混合召回(RRF)與 Rerank 重排序逐層調優的三步法。

    Claude其他 AI 工具0

0 條評論

登入 後參與評論

還沒有評論,來搶沙發~