# 将 Cursor 连接到 Nodary

Cursor 的智能体在写代码时可以读取团队保存在 Nodary 中的规格、决策和计划，并把它了解到的内容写回去，全程使用你的权限。

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

## 开始之前

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

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

## 把 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}：

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

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

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

## 遇到问题时

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

## 常见问题

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

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

### 整个团队可以使用同一份配置吗？

可以。提交只包含地址的 .cursor/mcp.json：每个人用自己的 Nodary 账号登录，Cursor 便以各自的权限操作。密钥放在每个人自己的环境里，绝不要放进代码仓库。

### Cursor 会把我的代码发给 Nodary 吗？

只会发送它的智能体放进 Nodary 请求中的内容，例如它要写的文档或要搜索的段落。Nodary 只保存写入工作区的内容，不保存其他任何东西。

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

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

### 如何断开连接？

在 Nodary 中打开“个人资料 > 安全 > 已连接的应用”并断开：访问会立即停止。在 Cursor 中，可在 Customize 里关闭该服务器，或从 mcp.json 中删除。密钥可在“个人资料 > API 密钥与 MCP”中撤销，所有者和管理员也可以在工作区设置的 MCP 部分撤销该工作区的任何密钥。

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

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

## 延伸阅读

- [将 Claude Code 连接到 Nodary](https://nodary.ai/zh/docs/mcp/claude-code): 一条命令把 Nodary 加入 Claude Code，再用 /mcp 登录。
- [将 VS Code 连接到 Nodary](https://nodary.ai/zh/docs/mcp/vs-code): 在 VS Code 中运行 MCP: Add Server，然后为 GitHub Copilot 登录。
- [Nodary MCP 服务器](https://nodary.ai/zh/docs/mcp): 服务器、登录、98 个工具、安全性，以及所有客户端的概览。
- [MCP server](https://nodary.ai/glossary/mcp-server) (英文): An MCP server is a program that offers tools, resources and prompts to AI applications over the Model Context Protocol.
- [AI agent](https://nodary.ai/glossary/ai-agent) (英文): An AI agent is a language model that pursues a goal in steps, calling tools, reading their results and deciding what to do next.

https://nodary.ai/zh/docs/mcp/cursor