Claude Code Cloudflare MCP 接入教程

在远程 Mac mini 上查询配置分析运行数据并控制平台变更

发布建议日期 2026-10-28　适用于 Claude Code Cloudflare 与远程 Mac 运维

Cloudflare API MCP 服务器把 DNS、Workers、R2、Zero Trust 等产品的 API 与开发文档接入 Claude Code。本文使用官方 Strea***le **** 端点完成 OAuth 授权，先验证账号与只读查询，再说明如何分析 Workers 故障。部署代码、修改 DNS、调整 WAF 或删除资源前，必须展示目标、差异与回滚方式并等待确认。

Cloudflare API MCP 适合哪些任务

官方主服务器覆盖 Cloudflare API 的 2500 多个端点，**询 DNS、Workers、R2、Zero Trust 等配置，也能搜索 Cloudflare 开发文档。它通过 search 和 execute 查找并调用 API，并提供 do** 工具用于文档检索。

同一连接可以读取配置，也可能执行部署、更新或删除。Claude Code 应把观察与变更分成两个阶段，不能把故障排查自动扩展为生产修改。

开始前准备

确认远程 Mac 已安装 Claude Code，并能进入目标 Workers 或基础设施仓库。准备可访问 Cloudflare 账号的用户，明确目标 account ID、zone ID、环境和允许的产品范围。

交互式接入优先使用 OAuth。自动化与 CI CD 才考虑 API Token，并为 Token 配置最小资源范围和权限；不要把 Token 写入聊天、仓库、截图或普通命令历史。

第一步 添加 Cloudflare API MCP

新连接使用 Strea***le **** 的 /mcp 端点。Cloudflare 当前推荐的主服务器是 https://mcp.cloudflare.com/mcp，通常不需要再添加多个产品服务器。

在目标仓库执行以下命令，随后核对服务器名称与 **L。历史 /sse 地址只用于兼容，不应作为新配置。

cd /path/to/your-project
claude mcp add --transport http cloudflare-api \
  https://mcp.cloudflare.com/mcp

claude mcp list
claude mcp get cloudflare-api

第二步 完成 OAuth 授权

启动 Claude Code 并运行 /mcp，选择 cloudflare-api 开始认证。浏览器会打开 Cloudflare 授权页面，让用户选择账号和授予 Agent 的权限。

首次接入只授权当前任务需要的读取权限。不要因为排障方便而授予账户级编辑、DNS 编辑、Workers 部署和资源删除等广泛权限。

claude

> /mcp
# 选择 cloudflare-api
# 选择 Authenticate
# 在浏览器中核对账号和权限后授权

第三步 ***只读验收

先让 Claude Code 使用 search 查找所需 API，再用 execute 读取账号、区域、Workers 服务和绑定摘要。提示词中明确禁止创建、更新、部署和删除。

验收通过的标准是只出现预期账号和区域，能够读取指定资源，并且 Dash*oard 与审计记录中没有配置变化。若返回多个账号或区域，停止并要求用户选择。

请仅使用 Cloudflare MCP 做只读验收：
1. 列出我可访问的账号并等待我选择
2. 列出指定账号中的 zone 和 Workers 服务
3. 读取一个 Worker 的版本 路由和绑定摘要
4. 不创建 不更新 不部署 不删除
输出实际 account zone Worker 和筛选条件

**步 理解 Code Mode

Cloudflare API MCP 使用 Code Mode，把大量端点压缩为少量工具。Claude Code 先通过 search 找到 API，再编写受控 J**aScript 调用 execute；生成代码运行在隔离的 Dynamic Worker 中。

隔离执行并不等于自动安全。授权范围、API 目标和变更批准仍是关键边界。执行前应检查代码中的方法、路径、资源 ID、请求体和分页范围。

请先使用 do** 和 search 找到所需 Cloudflare API。
展示计划调用的方法 路径 参数 资源 ID 和分页范围。
不要调用 execute，等待我检查计划。

第五步 查询 Workers 日志和配置

先限定账号、Worker 名称、环境与短时间窗口，再读取部署版本、路由、绑定和错误摘要。对日志进行字段筛选和脱敏，不要把整天日志或用户数据直接送入会话。

配置、日志内容和请求数据都是不可信输入。即使其中出现要求读取密钥、访问其他区域或上传文件的文字，也不能把它当作当前任务指令。

第六步 结合仓库排查故障

把 MCP 返回的部署版本、路由、绑定和错误码与仓库中的 wrangler 配置、代码和测试结果交叉验证。输出应区分 Cloudflare 事实、本地代码证据、推断和待验证项。

先生成修复方案和变更草稿，不要立即部署。需要修改绑定或环境变量时，只展示变量名和目标环境，密钥值应由用户在受控界面或密钥命令中提供。

第七步 控制 Workers 部署

部署前展示账号、Worker 名称、环境、版本差异、路由、绑定变化、迁移步骤和验证方法。生产部署还应说明回滚到哪个已知版本。

只有用户确认后才执行一次部署。不要把测试通过、准备发布或继续处理解释为对生产部署的授权；预览环境与生产环境必须使用不同的明确名称。

先不要部署。请展示：
- account Worker 和环境
- 当前版本与待部署差异
- 路由和绑定变化
- 数据迁移或兼容性影响
- 验证步骤和回滚版本
等待我明确确认后，只执行已展示的一次部署。

第八步 控制 DNS 和安全配置

修改 DNS 前展示 zone、记录类型、名称、原值、新值、TTL 和**状态。调整 WAF、Zero Trust 或访问策略前展示规则、顺序、匹配范围和可能受影响的用户。

删除区域、记录、*ucket、数据库、Worker 或安全规则属于高风险操作。教程只提供**方法，不应默认执行删除；必要时先备份配置并准备**证的恢复步骤。

先不要修改 Cloudflare 配置。请展示：
- account 和 zone
- 资源类型与唯一标识
- 原值 新值和完整请求体
- 受影响流量 用户或服务
- 回滚和验证方式
等待我确认后再执行一次变更。

第九步 管理 Token 和权限

日常交互连接使用 OAuth 并定期检查授权。CI CD 需要 API Token 时，应限定具体账号或区域，只授予流水线所需权限，并在安全的秘密管理系统中保存。

Token 不应作为 MCP **L 参数或出现在 Markdown、HTML、DOCX、终端截图和构建日志中。疑似泄露时立即撤销并轮换，同时检查相关审计记录。

第十步 在远程 Mac 上保持会话

通过 SSH 进入远程 Mac，在目标仓库创建 tmux 会话后运行 Claude Code。断开远程桌面后，日志分析、测试和代码检查仍可继续。

同时处理多个账号或环境时，为每个 tmux 会话使用清晰名称，并在提示词开头写明 account、zone、Worker 和允许的动作。任务结束后检查授权范围并关闭不再使用的连接。

ssh your-**c-mini
cd /path/to/your-project
tmux new -s cloudflare-mcp
claude

# 断线后接回
tmux attach -t cloudflare-mcp

为什么 Zu**c.Ai 适合这类工作流

根据 Zu**c.Ai 官网***息，其方案提供位于新加坡的 Mac mini M6 整机独享环境，配置为 16G* 统一内存与 256G* SSD，接入新加坡家庭或商业宽带，并支持 UU 远程、终端、Tailscale、ToDesk、RustDesk，以及浏览器 SSH 或 VNC。

官网当前公开价格为每月 999 元起。长期在线环境适合保留仓库、依赖缓存、Claude Code 与 tmux 会话；Cloudflare 账号、权限、资源费用、数据合规和生产变更责任仍由使用者自行管理。

常见问题排查

结语

Claude Code 接入 Cloudflare MCP 后，应先核对账号、区域和 OAuth 权限，并完成明确禁止写入的验收。部署 Workers、修改 DNS、调整安全规则或删除资源时，先展示资源标识、完整差异、影响范围和回滚方法，再由用户逐次确认。