其他语言: English, Español, Português, 日本語, Deutsch, Français, 한국어, Italiano, हिन्दी · 全部中文指南
声明:Carbon Forge 由我们 100monkeys.ai 开发,因此请把这篇指南当作开发方的说明来读。它由我们的一个 AI 智能体根据公开文档(英文)起草,主要是 Reading a public cortex without an account (R#64944) 和 MCP tokens (R#61824),并经公司审阅;这个简体中文版是英文原版指南的译文。命令、示例调用和引文都是文档自己的,引文保留英文原文,译文附在旁边;写作本指南时没有运行其中任何一条。文档没有回答的问题,最后一节会说明。
为什么不用账号就读
Carbon Forge 上的公开工作区,人在浏览器里读,智能体通过 MCP 读,用的是同一台服务器。匿名接口让智能体在任何人注册或生成密钥之前,就能使用公开的知识库,例如 Carbon Forge 文档本身。文档用一句话说明了规则:没有 token 的客户端 "can read what a browser visitor can read."(可以读浏览器访客能读的内容。)
找到端点
每个公开实例都通过 Streamable HTTP 提供 MCP。carbonforge.dev 的端点是 https://carbonforge.dev/api/mcp。匿名读取只在公开开关打开的实例上存在;开关关闭的实例 "asks you to sign in, exactly as it always has."(会像一直以来那样要求你登录。)
不带 Authorization 头接入
把端点加入你的客户端,不发送 Authorization 头。文档给 Claude Code 的命令:
claude mcp add --transport http cortex-public https://carbonforge.dev/api/mcp任何支持 Streamable HTTP 的客户端都用同一个 URL。宁可完全不发这个头,也不要发一个空的或旧的:"A wrong, expired or revoked token is refused outright rather than quietly treated as anonymous, so a client can never be reading less than it thinks it is."(错误、过期或已撤销的 token 会被直接拒绝,而不是悄悄当作匿名处理,所以客户端读到的内容永远不会比它以为的少。)
先做 grounding
initialize 握手会返回实例的 grounding 文档、它的公开工作区和你可以调用的工具。"No session id is issued; you do not need one."(不会签发会话 id;你也不需要。)调用 cortex.ground 来定位:它是对你开放的工具之一,它列出的工作区就是你在下一步可以指定的工作区。
每次调用都写明工作区
token 带有一个当前工作区指针。没有 token 就没有指针,所以每个在工作区内执行的调用都要传 workspace,用 slug 或 UUID。文档的示例读取文档首页:
{ "name": "pages.read", "arguments": { "workspace": "docs", "pathOrId": "home" } }省略 workspace,调用会提示你提供它。要读另一个公开实例,加上它的 slug 作为 instance。
阅读、搜索并跟随链接
文档列出二十二个只读工具,其中包括:列出和解析公开工作区,列出和读取页面与 atom,按混合匹配和精确子串搜索,浏览和搜索发现目录,跟随交叉链接和语义邻居,读取评论串和媒体元数据,以及面向代码的 files.list 和 trees.get。其中有两个与其他不同:两个搜索工具 "search across every public instance whatever you pass"(无论你传什么,都会搜索所有公开实例),结果信封里也会这样说明。要留在一个工作区内,请用读取和列出,而不是搜索。
阅读页面的历史
修订历史和差异也在匿名读取之列。因此,引用公开页面的智能体可以写明它读的是哪个修订,并在之后检查此后改了什么,无需账号。这与登录的编辑者看到的是同一份记录,只限于公开内容。
到达限额时放慢
匿名请求按 IP 地址限流。到达限额时,回答是带 Retry-After 头的 429,消息会说明要等多少秒,请你放慢,并指向注册。请在客户端里遵守 Retry-After,不要立刻重试。
知道什么时候需要 token
"Everything else answers as though it did not exist."(其他一切都当作不存在来回答。)私有页面、私有工作区和不存在的页面都回答 "not found"(未找到),和浏览器里一样,所以匿名客户端无法得知它看不到什么。你需要 token 才能 "to write, to read private content, or to lift the anonymous limit"(写入、读取私有内容,或解除匿名限额);token 有它自己独立的限流。每个账号都包含一个免费的私有工作区,公开工作区免费(见价格)。MCP tokens 页面会带你走完 token 表单:工作区、角色上限、工具范围、名称,以及只显示一次的密钥。
要给 Claude Code 一个范围窄的 token,并把记忆写进你自己的工作区,请读我们的指南通过 MCP 把 Claude Code 连接到 Carbon Forge。
文档没有回答的问题
- 限额本身。文档说请求按 IP 地址限流并描述了 429,但没有给出数字或时间窗口。
- 二十二个工具的名称列表。页面按组描述它们,只点名了
cortex.ground、files.list和trees.get。 - 不是 Claude Code 的客户端如何配置。只给出了 Claude Code 的命令。
- 匿名读取能否看到 lane、cut 或 changeset。页面列出了代码树和文件,但没有提到 lane、cut 或 changeset。