跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

Visual Studio Code 详细演练

最后更新 查看 MarkdownAgent 设置

本演练使用 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 连接到 Cloudflare API

  1. 确认 Visual Studio Code 版本

    打开 Visual Studio Code,选择 Help(帮助) > About(关于)。确认你使用的是当前版本。如果标题栏出现 Update(更新) 按钮,请选择它并让 Visual Studio Code 重启后再继续。

    Visual Studio Code 的 Help 菜单,显示用于确认已安装版本的 About 对话框
  2. 登录 Copilot

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

    Visual Studio Code 提示启用 AI 功能并使用 GitHub 登录
  3. 向 Copilot 进行身份验证

    按照浏览器页面完成 GitHub 身份验证。

    用于授权 GitHub Copilot 的 GitHub 登录页面
  4. 创建文件夹并打开它

    为此项目创建一个空文件夹,然后通过 File(文件) > Open Folder(打开文件夹) 在 Visual Studio Code 中打开它。例如 ~/cloudflare-api-mcp/。

    Visual Studio Code 的 Open Folder 对话框,正在选择一个空项目文件夹
  5. 创建配置文件

    在文件夹内创建单个文件:.vscode/mcp.json。在资源管理器中输入 .vscode/mcp.json 会同时创建文件夹和文件。

    Visual Studio Code 资源管理器正在创建 .vscode/mcp.json 配置文件

    将以下内容粘贴到文件中,然后保存:

    {
      "servers": {
        "cloudflare-api": {
          "type": "http",
          "url": "https://mcp.cloudflare.com/mcp"
        }
      }
    }
  6. 启动服务器

    保存文件后,cloudflare-api 服务器定义上会出现 Start(启动) 链接。它看起来像注释,但其实是一个按钮(CodeLens ↗)。选择它,然后允许身份验证提示。浏览器会打开 Cloudflare 授权页面。

    Visual Studio Code 在 mcp.json 中的 Cloudflare MCP 服务器定义上显示 Start CodeLens
  7. 选择访问模板

    授权页面是你决定 Agent 可以访问哪些内容的地方。本示例选择 Full access(完全访问) 以修改 DNS 记录。你也可以从 Read only(只读) 开始,或构建 Custom(自定义) 权限集。将授权范围限定到单个账户,然后审阅你正在授予的内容。

    Cloudflare MCP 授权页面,显示访问模板和账户范围选项

    在授权之前,请了解两点。Full access(完全访问) 允许 Agent 创建和删除真实资源,因此这应放在演示账户上。你可以随时在仪表板的 My Profile(我的个人资料) > Access Management(访问管理) > Connected Applications(已连接的应用程序) 下撤销授权;如果重新授权行为异常,也应访问该页面。

  8. 验证权限并授权

    审阅权限列表,然后选择 Authorize(授权),以允许 Cloudflare API 与你的账户交互。

    Cloudflare MCP 授权页面,在授权前列出所请求的权限组Visual Studio Code Copilot 提示允许在当前会话中使用 Cloudflare MCP 服务器
  9. 打开 Copilot Chat

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

    Visual Studio Code 的 View 菜单正在打开 Copilot Chat 面板
  10. 确认服务器正在运行

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

    Visual Studio Code CodeLens 显示 Cloudflare MCP 服务器正在运行且有三个工具
  11. 列出你的 Zone

    在 Copilot Chat 中,将模式设置为 Agent,然后请它列出你的 Zone。Agent 会在运行调用前请求你的批准,并返回账户中每个域名的实时列表。

    Copilot Chat 从账户返回 Cloudflare Zone 列表
    List zones in my account
    Ran Cloudflare API Code Executor
    
    - Zones returned: 1
    - Zone: cloudflaredemo.net — id: <ZONE_ID> — status: active
  12. 创建 DNS 记录

    请 Agent 创建一条 DNS AAAA 记录并开启 Cloudflare 代理。本示例将 test.cloudflaredemo.net 指向 100::,这是来自 IPv6 discard 前缀 0100::/64(RFC 6666 ↗)的保留占位地址。由于该记录已代理,Cloudflare 会在请求到达此地址之前拦截它们。批准工具调用(Always Allow(始终允许)),Agent 会报告记录已创建。

    Copilot Chat 通过 Cloudflare MCP 服务器创建已代理的 AAAA DNS 记录
    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。

    Cloudflare 仪表板 DNS 记录页面确认新的 AAAA 记录已存在
  13. 验证 DNS 传播

    请 Cloudflare MCP 服务器验证该记录是否已传播。

    Copilot Chat 跨公共解析器验证 DNS 传播
    Verify DNS propagation for test.cloudflaredemo.net
    Ran: 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
  14. 删除 DNS 记录

    删除记录与创建记录一样容易。

    Copilot Chat 通过 Cloudflare MCP 服务器删除测试 DNS 记录
    Delete test.cloudflaredemo.net
    Ran Cloudflare API Code Executor
    
    Deleted the DNS record for test.cloudflaredemo.net.

你现在拥有一个对账户中 Cloudflare 服务具有读写访问权限的 AI Agent,完全由 Visual Studio Code 驱动。

相关资源

这篇文档对您有帮助吗?