跳到主要内容

ARC 开发者文档

接入你的工具

把 blocklet 添加到 Claude Code 或 Codex CLI,需要读取公开内容以外的东西时再登录。

把你的工具指向 https://<host>/mcp<host> 就是该 blocklet 对外服务的域名。添加不需要任何凭证;登录只需在浏览器点一次,而且只有当你要越过 blocklet 公开发布的内容时才需要。

Claude Code

添加:

bash
claude mcp add --transport http arc https://<host>/mcp

确认:

bash
claude mcp list
text
arc: https://<host>/mcp (HTTP) - ✔ Connected

此时读工具已经可用。要再往前,登录:

bash
claude mcp login arc

浏览器会打开一个同意页,上面写明是哪个工具在请求、它来自哪个已验证域名、将以哪个账户身份操作、以及凭证会被送到本机的哪个端口。选一个访问级别,点 Authorize,命令会自己完成。

请在真实终端里运行。在管道或 CI 里它会停在 stdin isn't a terminal

claude mcp logout arc 清除凭证,claude mcp remove arc 移除该服务器。

Codex CLI

一条命令完成添加和登录:

bash
codex mcp add arc --url https://<host>/mcp

它会打印授权 URL、在浏览器打开同一个同意页,然后结束:

text
Successfully logged in.

确认:

bash
codex mcp list
text
Name  Url                       Bearer Token Env Var  Status   Auth
arc   https://<host>/mcp        -                     enabled  OAuth

codex mcp login arc 可以稍后重新登录,codex mcp logout arc 清除凭证。

grok

暂不支持。grok mcp add arc -t http https://<host>/mcp 会写入配置,但连接在握手阶段失败:

text
✗ handshake failed (… Auth error: OAuth authorization required, when send initialize request)

grok 在那次「本来会告诉它不需要授权」的握手之前就要求授权,而 grok mcp 没有 login 命令可以完成授权。请改用下面的 header 方式。

其他工具

只要你的工具能发自定义头,就可以在没有浏览器的情况下取得凭证,然后直接带上:

bash
claude mcp add --transport http arc https://<host>/mcp \
  --header "Authorization: Bearer blocklet-…"

任何支持自定义头的客户端都适用,这也是在没有浏览器的服务器或 CI 上接入的方式。

连上之后

  • 登录提高的是你能请求什么,它本身不会打开写入权限:一条路径必须由 blocklet 先向网络客户端发布,别人才写得进去。见访问分档
  • 你能看到哪些工具取决于该 blocklet,与你的凭证无关。见工具
  • 一份凭证只属于一个 blocklet。连第二个就要再登录一次。