将 Cursor 连接到 Nodary

开始之前

• Cursor 桌面应用。我们核对时，Cursor 的价格页没有说明哪些套餐包含 MCP 服务器；在 Enterprise 中，管理员可以控制 MCP 访问，团队也可以维护允许使用的服务器列表。
• 一个 Nodary 账号。所有套餐都包含 MCP 服务器；在 Free 套餐中，只要工作区不超出套餐限额即可使用：1 个项目、10 个文档和文件夹、2 名成员。Cursor 不消耗彗星：它使用自己的模型。

把 Nodary 加入 mcp.json

1. 打开主目录中的 ~/.cursor/mcp.json（在所有项目中使用 Nodary），或项目中的 .cursor/mcp.json（仅该项目），添加服务器：

   {
     "mcpServers": {
       "nodary": {
         "url": "https://nodary.ai/api/mcp"
       }
     }
   }

   复制
2. 在 Cursor 侧栏打开 Customize，在 MCP 服务器中找到 nodary，打开它，并在 Cursor 提示时登录：Nodary 的授权页面会在浏览器中打开。
3. 批准访问。之后 Cursor 会把 Nodary 的工具显示为可用。

共享该文件： 把 .cursor/mcp.json 提交到代码仓库，整个团队就会使用同一个服务器；每个人仍用自己的账号登录。切勿提交 API 密钥。

登录并选择工作区

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

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

通过智能体使用 Nodary

用平常的话向智能体提出请求。请求需要时，Cursor 会调用 Nodary 的工具，并默认在运行每个工具前征求你的同意。可以先试试这些请求：

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

改用 API 密钥

把密钥放进环境变量 NODARY_API_KEY，并通过请求头发送；Cursor 会从你的环境中读取 ${env:NODARY_API_KEY}：

{
  "mcpServers": {
    "nodary": {
      "url": "https://nodary.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:NODARY_API_KEY}"
      }
    }
  }
}

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

遇到问题时

• 看不到 Nodary 的工具：打开 Customize，确认 nodary 已开启，然后在 Output 面板的 MCP Logs 中查看错误。
• 登录无法完成：请改用上面介绍的 API 密钥连接。
• 首次请求收到 401 响应属于正常：它告诉客户端去哪里登录。
• quota_locked：试用结束后工作区超出 Free 套餐，在所有者订阅之前处于锁定状态。订阅后立即恢复正常。
• billing_locked：一笔付款失败，工作区在所有者于工作区账单设置中完成付款之前处于锁定状态。付款成功后立即恢复正常。
• workspace_suspended：Nodary 已暂停该工作区，任何访问都无法到达，包括代理。所有者可以发邮件至 support@nodary.ai。
• workspace_required：该连接可访问多个工作区，请指明要在哪个工作区操作，或重新连接并只勾选一个。

常见问题

延伸阅读