将 Claude Code 连接到 Nodary

开始之前

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

添加 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 密钥

通过请求头发送密钥：

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

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

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

常见问题

延伸阅读