本演练使用 Cloudflare MCP 服务器 ↗ 将 Visual Studio Code 直接连接到 Cloudflare API。完成后,你可以输入一句话来创建 DNS 记录,而无需离开编辑器。
位于 mcp.cloudflare.com 的 Cloudflare MCP 服务器会将 Cloudflare API 暴露给任何支持 MCP 的 Agent。Visual Studio Code Copilot Agent 连接到它,你即可通过自然语言运行 API 调用。
精简版本请参阅 Visual Studio Code 快速入门。
- Visual Studio Code,已完全更新。编辑器与 Copilot 扩展版本不匹配,是 Agent 模式错误最常见的来源。
- GitHub Copilot。任何 GitHub 账户都可以,免费层级已足够。
- 一个你愿意让 Agent 指向的 Cloudflare 账户。请使用演示账户。原因会在授权步骤中变得清楚。
-
确认 Visual Studio Code 版本
打开 Visual Studio Code,选择 Help(帮助) > About(关于)。确认你使用的是当前版本。如果标题栏出现 Update(更新) 按钮,请选择它并让 Visual Studio Code 重启后再继续。

-
登录 Copilot
选择状态栏中的 Copilot 图标,选择 Use AI Features(使用 AI 功能),然后使用 GitHub 账户登录。Visual Studio Code 会打开浏览器进行授权。

-
向 Copilot 进行身份验证
按照浏览器页面完成 GitHub 身份验证。

-
创建文件夹并打开它
为此项目创建一个空文件夹,然后通过 File(文件) > Open Folder(打开文件夹) 在 Visual Studio Code 中打开它。例如
~/cloudflare-api-mcp/。
-
创建配置文件
在文件夹内创建单个文件:
.vscode/mcp.json。在资源管理器中输入.vscode/mcp.json会同时创建文件夹和文件。
将以下内容粘贴到文件中,然后保存:
{ "servers": { "cloudflare-api": { "type": "http", "url": "https://mcp.cloudflare.com/mcp" } } } -
启动服务器
保存文件后,
cloudflare-api服务器定义上会出现 Start(启动) 链接。它看起来像注释,但其实是一个按钮(CodeLens ↗)。选择它,然后允许身份验证提示。浏览器会打开 Cloudflare 授权页面。
-
选择访问模板
授权页面是你决定 Agent 可以访问哪些内容的地方。本示例选择 Full access(完全访问) 以修改 DNS 记录。你也可以从 Read only(只读) 开始,或构建 Custom(自定义) 权限集。将授权范围限定到单个账户,然后审阅你正在授予的内容。
在授权之前,请了解两点。Full access(完全访问) 允许 Agent 创建和删除真实资源,因此这应放在演示账户上。你可以随时在仪表板的 My Profile(我的个人资料) > Access Management(访问管理) > Connected Applications(已连接的应用程序) 下撤销授权;如果重新授权行为异常,也应访问该页面。
-
验证权限并授权
审阅权限列表,然后选择 Authorize(授权),以允许 Cloudflare API 与你的账户交互。


-
打开 Copilot Chat
如果 Copilot 已最小化,可通过 View(查看) > Chat 打开它。

-
确认服务器正在运行
服务器现在显示为正在运行。CodeLens 显示 Running | 3 tools(正在运行 | 3 个工具)。三个工具是正确的,并不是安装损坏:该服务器使用搜索并执行的模式,而不是注册成千上万个独立端点。

-
列出你的 Zone
在 Copilot Chat 中,将模式设置为 Agent,然后请它列出你的 Zone。Agent 会在运行调用前请求你的批准,并返回账户中每个域名的实时列表。
List zones in my accountRan Cloudflare API Code Executor - Zones returned: 1 - Zone: cloudflaredemo.net — id: <ZONE_ID> — status: active -
创建 DNS 记录
请 Agent 创建一条 DNS AAAA 记录并开启 Cloudflare 代理。本示例将
test.cloudflaredemo.net指向100::,这是来自 IPv6 discard 前缀0100::/64(RFC 6666 ↗)的保留占位地址。由于该记录已代理,Cloudflare 会在请求到达此地址之前拦截它们。批准工具调用(Always Allow(始终允许)),Agent 会报告记录已创建。
Create a AAAA record for test.cloudflaredemo.net pointing to 100:: and enable the proxy.Ran Cloudflare API Code Executor - Record created: test.cloudflaredemo.net - Type: AAAA - Value: 100:: - Proxied: true - Record ID: <RECORD_ID>不要只依赖 Agent 的报告。打开仪表板并检查该 Zone。

-
验证 DNS 传播
请 Cloudflare MCP 服务器验证该记录是否已传播。
Verify DNS propagation for test.cloudflaredemo.netRan: dig @1.1.1.1 test.cloudflaredemo.net AAAA +short - Result: DNS resolves to Cloudflare IPv6 addresses (proxy active). - Resolvers returning AAAA: 1.1.1.1, 8.8.8.8, 9.9.9.9 - 2606:4700::6812:2f3 - 2606:4700::6812:3f3 -
删除 DNS 记录
删除记录与创建记录一样容易。
Delete test.cloudflaredemo.netRan Cloudflare API Code Executor Deleted the DNS record for test.cloudflaredemo.net.
你现在拥有一个对账户中 Cloudflare 服务具有读写访问权限的 AI Agent,完全由 Visual Studio Code 驱动。
- Visual Studio Code 快速入门 — 精简设置、技巧、常见问题与故障排查。
- Cloudflare MCP 服务器 ↗ — 针对特定领域的 MCP 服务器。
- Cloudflare API — 完整 REST API 参考。