如何将 Cloudflare Workers Bindings 远程 MCP 连接到 Gemini CLI

约 1 分钟即可把 Cloudflare 的远程 MCP 服务端接入 Gemini CLI。如需排查 OAuth / 401 问题,可先用 OAuth 2.1 调试器体检端点。

🛡️ Official✓ VerifiedHTTP + SSEOAuth 2.1🛡️ A+~449 tok15 tools
HTTP + SSEhttps://bindings.mcp.cloudflare.com/mcp
Legacy SSE endpoint
SSEhttps://bindings.mcp.cloudflare.com/sse

Add to ~/.gemini/settings.json under mcpServers — httpUrl for Streamable HTTP, url for legacy SSE:

{
  "mcpServers": {
    "cloudflare-workers": {
      "httpUrl": "https://bindings.mcp.cloudflare.com/mcp"
    }
  }
}

接入步骤

  1. 编辑设置文件 — 打开 ~/.gemini/settings.json。
  2. 添加服务端 — 在 mcpServers 中加入 "cloudflare-workers": { "httpUrl": https://bindings.mcp.cloudflare.com/mcp }。
  3. 完成认证 — 首次调用时客户端会打开 Cloudflare 的 OAuth 授权页面——点击允许后工具即可用。
  4. 验证 — 在 在线 Inspector 中粘贴 https://bindings.mcp.cloudflare.com/mcp 并运行 initialize + tools/list 验证连通性。

🧰 工具预览(15)

ToolSafetyDescriptionParameters
workers_list
~31 tok
🟢 ReadList Workers scripts in the account.—
worker_get_worker_code
~31 tok
🟢 ReadDownload a Worker's code.—
worker_put_worker_code
~31 tok
🟠 WriteDeploy code for a Worker.—
kv_list_namespaces
~29 tok
🟢 ReadList KV namespaces.—
kv_get
~26 tok
🟢 ReadGet a KV entry value.—
kv_put
~25 tok
🟠 WriteWrite a KV entry.—
kv_delete
~26 tok
🔴 DestructiveDelete a KV entry.—
d1_list_databases
~28 tok
🟢 ReadList D1 databases.—
d1_create_database
~29 tok
🟠 WriteCreate a D1 database.—
d1_database_query
~32 tok
🟠 WriteRun a SQL query on a D1 database.—
r2_list_buckets
~27 tok
🟢 ReadList R2 buckets.—
r2_create_bucket
~28 tok
🟠 WriteCreate an R2 bucket.—
r2_delete_bucket
~28 tok
🔴 DestructiveDelete an R2 bucket.—
r2_list_objects
~30 tok
🟢 ReadList objects in an R2 bucket.—
r2_get_object
~28 tok
🟢 ReadGet an object from R2.—

更多连接指南