# 将 Claude Code 连接到 Nodary

Claude Code 可以在终端里读取团队保存在 Nodary 中的文档，并把决策和笔记写回去，全程使用你的权限。

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

## 开始之前

- 已用 Pro、Max、Team、Enterprise 或 Console 账号登录的 Claude Code，或通过 Amazon Bedrock 等云服务商使用的 Claude Code。claude.ai 的免费套餐不包含 Claude Code。
- 一个 Nodary 账号。所有套餐都包含 MCP 服务器；在 Free 套餐中，只要工作区不超出套餐限额即可使用：1 个项目、10 个文档和文件夹、2 名成员。Claude Code 不消耗彗星：它使用自己的模型。

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

## 添加 Nodary

1. 在终端中运行以下命令：

   ```
   claude mcp add --transport http nodary https://nodary.ai/api/mcp
   ```
2. 如果想在所有项目中使用 Nodary，请改为添加到用户范围：

   ```
   claude mcp add --transport http --scope user nodary https://nodary.ai/api/mcp
   ```
3. 在 Claude Code 中输入 /mcp，选择 nodary 并登录：Nodary 的授权页面会在浏览器中打开。如果没有打开，请复制 Claude Code 显示的地址，或运行：

   ```
   claude mcp login nodary
   ```

**范围：** 默认的 local 只在当前项目中对你可用；user 在你的所有项目中可用；project 会在项目根目录写入 .mcp.json，供整个团队共享。

## 登录并选择工作区

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

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

## 在终端中使用 Nodary

用平常的话提出请求。请求需要时，Claude Code 会调用 Nodary 的工具；除非你已允许，否则使用前会先询问。可以先试试这些请求：

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

## 改用 API 密钥

通过请求头发送密钥：

```sh
claude mcp add --transport http nodary https://nodary.ai/api/mcp \
  --header "Authorization: Bearer gdc_..."
```

若要在 .mcp.json 中共享服务器而不共享密钥，请从环境变量读取密钥：Claude Code 会替换服务器请求头中的 ${NODARY_API_KEY}。

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

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

## 遇到问题时

- claude mcp add 不会检查密钥：错误的密钥会在 /mcp 中显示为连接失败的服务器。
- 如需重新登录，请在 /mcp 菜单中选择 Clear authentication，或运行 claude mcp logout nodary，然后再登录。
- 长文档返回时被截断：工具输出超过 10,000 个 token 时 Claude Code 会发出警告，默认在 25,000 个 token 处截止。可以用环境变量 MAX_MCP_OUTPUT_TOKENS 提高上限，或只请求某一节。
- 登录无法完成：请改用上面介绍的 API 密钥连接。
- 首次请求收到 401 响应属于正常：它告诉客户端去哪里登录。
- quota_locked：试用结束后工作区超出 Free 套餐，在所有者订阅之前处于锁定状态。订阅后立即恢复正常。
- billing_locked：一笔付款失败，工作区在所有者于工作区账单设置中完成付款之前处于锁定状态。付款成功后立即恢复正常。
- workspace_suspended：Nodary 已暂停该工作区，任何访问都无法到达，包括代理。所有者可以发邮件至 support@nodary.ai。
- workspace_required：该连接可访问多个工作区，请指明要在哪个工作区操作，或重新连接并只勾选一个。

## 常见问题

### 连接 Claude Code 需要付费吗？

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

### 这和网页版 Claude 是同一个连接吗？

可以是：用 claude.ai 账号登录 Claude Code 时，你在 claude.ai 中添加的连接器（包括 Nodary）会出现在 Claude Code 中。如果用 Console 密钥或云服务商登录，请用上面的命令添加 Nodary。

### 团队可以共享这份配置吗？

可以：用 --scope project 添加 Nodary，并提交 .mcp.json。Claude Code 在使用项目中的服务器前会询问每个人，每个人都用自己的 Nodary 账号登录。

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

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

### 如何断开连接？

在 Nodary 中打开“个人资料 > 安全 > 已连接的应用”并断开：访问会立即停止。在 Claude Code 中，claude mcp remove nodary 会删除该服务器及其保存的登录信息。密钥可在“个人资料 > API 密钥与 MCP”中撤销，所有者和管理员也可以在工作区设置的 MCP 部分撤销该工作区的任何密钥。

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

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

## 延伸阅读

- [将 Claude 连接到 Nodary](https://nodary.ai/zh/docs/mcp/claude): 把 Nodary 作为自定义连接器添加到 claude.ai 和 Claude Desktop，通过 OAuth 登录。
- [将 Cursor 连接到 Nodary](https://nodary.ai/zh/docs/mcp/cursor): 把 Nodary 加入 Cursor 的 mcp.json，然后在 Cursor 中登录。
- [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.
- [Context window](https://nodary.ai/glossary/context-window) (英文): A context window is how much text, counted in tokens, a language model takes into account at once, instructions and documents included.

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