# 将 VS Code 连接到 Nodary

VS Code 中的 GitHub Copilot 智能体可以读取团队在 Nodary 中的规格和决策，并写回内容，全程使用你的权限。

已于 2026年10月22日对照各厂商文档核实。

## 开始之前

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

还没有工作区？先创建一个，再回来连接。 [免费创建工作区](https://nodary.ai/sign-up)

## 添加 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，这是你主目录中的文件，切勿提交到代码仓库：

```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 天后过期，或永不过期。

![Nodary 个人资料中的“API 密钥与 MCP”部分：可粘贴到 AI 客户端的 MCP 服务器地址，以及一个带有作用范围的智能体密钥。](https://nodary.ai/marketing/mcp-connect.webp)

## 遇到问题时

- 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：该连接可访问多个工作区，请指明要在哪个工作区操作，或重新连接并只勾选一个。

## 常见问题

### 连接 Copilot 需要付费吗？

Nodary 这边不收费。所有套餐都包含 MCP 服务器，Free 套餐在限额内同样可用，而且 Copilot 不消耗彗星：彗星只用于计算 Studio AI 的用量。能否添加服务器，取决于你的 Copilot 套餐。

### Copilot Business 提示 MCP 服务器已关闭，怎么办？

由组织或企业的管理员开启默认关闭的 MCP servers in Copilot 策略。Copilot Free、Pro、Pro+ 和 Max 不受该策略约束。

### 需要安装 Node.js 或其他软件吗？

不需要。Nodary 是远程服务器：VS Code 通过 HTTPS 与它通信，你的电脑上不运行任何东西。

### Copilot 会删除或覆盖我的文档吗？

只在你的角色允许的范围内操作，而且改动可以退回：每段最长十分钟的编辑会话形成一个版本，智能体的每次写入也各成一个版本。每份文档保留成员保存的最新 50 个版本和智能体写入的最新 50 个版本（智能体的版本绝不会挤掉成员的版本），你可以对比和恢复；删除的文档在 30 天内可以找回。分享链接、访问权限、成员、角色、密钥、账单以及删除项目，始终由人来决定：任何智能体都无法执行。

### 如何断开连接？

在 Nodary 中打开“个人资料 > 安全 > 已连接的应用”并断开：访问会立即停止。在 VS Code 中，可从 ~/.copilot/mcp-config.json 删除 nodary，或通过 MCP: List Servers 停止它。密钥可在“个人资料 > API 密钥与 MCP”中撤销，所有者和管理员也可以在工作区设置的 MCP 部分撤销该工作区的任何密钥。

### Nodary 会用我的文档训练 AI 吗？

不会。Nodary 不会使用工作区内容训练 AI 模型。Copilot 如何处理它读取的内容，由其开发商的条款决定。

## 延伸阅读

- [将 Cursor 连接到 Nodary](https://nodary.ai/zh/docs/mcp/cursor): 把 Nodary 加入 Cursor 的 mcp.json，然后在 Cursor 中登录。
- [将 Claude Code 连接到 Nodary](https://nodary.ai/zh/docs/mcp/claude-code): 一条命令把 Nodary 加入 Claude Code，再用 /mcp 登录。
- [Nodary MCP 服务器](https://nodary.ai/zh/docs/mcp): 服务器、登录、98 个工具、安全性，以及所有客户端的概览。
- [MCP (Model Context Protocol)](https://nodary.ai/glossary/model-context-protocol) (英文): The Model Context Protocol (MCP) is an open standard that connects AI applications to outside tools and data through one common interface.
- [OAuth](https://nodary.ai/glossary/oauth) (英文): OAuth is a standard that lets an app act for you in another service, with access you approve, without ever seeing your password.

https://nodary.ai/zh/docs/mcp/vs-code