将 VS Code 连接到 Nodary

开始之前

• 安装了 GitHub Copilot 的 VS Code。在 Copilot Free、Pro、Pro+ 和 Max 中，MCP 服务器不受组织策略约束。
• 在 Copilot Business 和 Enterprise 中，必须开启组织的 MCP servers in Copilot 策略；该策略默认关闭。企业的允许列表也可能限制你能添加的服务器。
• 一个 Nodary 账号。所有套餐都包含 MCP 服务器；在 Free 套餐中，只要工作区不超出套餐限额即可使用：1 个项目、10 个文档和文件夹、2 名成员。Copilot 不消耗彗星：它使用自己的模型。

添加 Nodary

1. 打开命令面板（Ctrl+Shift+P，Mac 上为 Cmd+Shift+P），运行 MCP: Add Server。
2. 选择 HTTP (HTTP or Server-Sent Events)，并输入服务器地址：

   https://nodary.ai/api/mcp

   复制
3. 输入 nodary 作为服务器 ID。
4. 选择 Global，再选择 Copilot Global，即可在所有工作区中使用 Nodary。VS Code 会把它写入 ~/.copilot/mcp-config.json：

   {
     "mcpServers": {
       "nodary": {
         "type": "http",
         "url": "https://nodary.ai/api/mcp",
         "tools": [
           "*"
         ]
       }
     }
   }

   复制
5. 服务器启动时，接受信任和登录提示：Nodary 的授权页面会在浏览器中打开。

旧配置： VS Code 仍会读取 .vscode/mcp.json 和用户配置文件中的 mcp.json，它们使用 servers 而不是 mcpServers，并被标记为已弃用。

登录并选择工作区

Nodary 的授权页面会显示发起请求的应用，以及它将被送回的地址。如尚未登录请先登录，然后选择 Copilot 可以访问的工作区：只有一个工作区时直接选中它；有多个工作区时，默认一个都不勾选，请逐个勾选允许 Copilot 使用的工作区。如果你登录已超过 10 分钟，Nodary 会再次要求输入密码。批准后，浏览器会带你回到 Copilot。

此后 Copilot 以你的身份操作：只能在你勾选的工作区里查看和更改你的角色允许的内容。每次访问有效 60 分钟，Copilot 会自动续期。

在 Copilot Chat 中使用 Nodary

在 Copilot Chat 中确认 Nodary 的工具已开启（Configure Tools，或 Chat: Open Customizations 再选 Tools），然后用平常的话提出请求。可以先试试这些请求：

• 阅读 Nodary 中的 API 设计文档，对照检查这个接口。
• 为迁移到 Postgres 写一份决策记录，放进“架构”文件夹，并链接到规格说明。
• Backend 项目里还有哪些文档是草稿？分别由谁负责？

改用 API 密钥

把请求头加入 ~/.copilot/mcp-config.json，这是你主目录中的文件，切勿提交到代码仓库：

{
  "mcpServers": {
    "nodary": {
      "type": "http",
      "url": "https://nodary.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer gdc_..."
      },
      "tools": [
        "*"
      ]
    }
  }
}

明文保存： VS Code 不会从此文件读取需要用户输入的变量，因此密钥会按原样保存在其中。请为该密钥设置 30 或 90 天的有效期，电脑丢失时请在 Nodary 中撤销。

在 Nodary 的“个人资料 > API 密钥与 MCP”中创建密钥。密钥以 gdc_ 开头，只显示一次，以你的权限操作，可限定于单个项目，并按你的选择在 30、90 或 365 天后过期，或永不过期。

遇到问题时

• VS Code 提示企业限制阻止了该服务器：请向管理员询问 MCP servers in Copilot 策略和企业允许列表。
• 没有出现登录：运行 MCP: List Servers，重启 nodary 并接受提示。如果仍无法完成登录，请改用 API 密钥。
• 首次请求收到 401 响应属于正常：它告诉客户端去哪里登录。
• quota_locked：试用结束后工作区超出 Free 套餐，在所有者订阅之前处于锁定状态。订阅后立即恢复正常。
• billing_locked：一笔付款失败，工作区在所有者于工作区账单设置中完成付款之前处于锁定状态。付款成功后立即恢复正常。
• workspace_suspended：Nodary 已暂停该工作区，任何访问都无法到达，包括代理。所有者可以发邮件至 support@nodary.ai。
• workspace_required：该连接可访问多个工作区，请指明要在哪个工作区操作，或重新连接并只勾选一个。

常见问题

延伸阅读