文档接入 Agent
编辑器插件
适用于 Cursor 和 Codex 的 Acahti 插件，打包了 skill、MCP 连接以及 Git 身份和 CI 规则。
Acahti 插件把编辑器 Agent 需要的一切打包成一次安装：skill、MCP 服务器配置，以及只对 Acahti 远程仓库生效的规则。它本身不提供工具；编辑器中的操作通过 MCP 访问实例。CLI 继续用于 shell 和 Benchyard 任务。
| 宿主 | 包 | 需要设置 |
|---|---|---|
| Cursor | cursor/ |
ACAHTI_ROOT_URL，即你的实例地址，末尾不带斜杠。MCP 地址为 ${ACAHTI_ROOT_URL}/mcp |
| Codex | codex/ |
MCP 端点：先 codex mcp add acahti --url <instance>/mcp，再 codex mcp login acahti，或使用 --bearer-token-env-var ACAHTI_TOKEN |
安装#
Cursor：在 Agent 输入框中运行：
/add-plugin acahti@https://github.com/acahti-ai/acahti-plugin
然后在 Customize → Acahti → Configure 中设置 ACAHTI_ROOT_URL（末尾不带斜杠）。也可以直接复制包：
cp -R cursor ~/.cursor/plugins/local/acahti
Codex：从仓库的 marketplace 安装（或用 curl 把 skill 下载到 ~/.codex/skills/acahti），然后添加 MCP 服务器并完成认证。无需安装 CLI：
codex mcp add acahti --url https://acahti.example.com/mcp
codex mcp login acahti
# or: codex mcp add acahti --url https://acahti.example.com/mcp --bearer-token-env-var ACAHTI_TOKEN
工作区包已经内置了连接：运行它的 setup skill 并完成 OAuth 即可。在 Benchyard 的 shell 任务中，把 ACAHTI_ROOT_URL 和 ACAHTI_TOKEN 放进 Secrets 并配合 CLI 使用，不需要浏览器回调。不要再把 acahti 加到编辑器自己的 MCP 配置文件中；每个实例只保留一个连接。
插件提供的内容#
- Skill：一个小型引导程序，调用
whoami并按whoami.skill_url加载，因此完整的 skill 始终来自本站。 - 规则：对推送到 Acahti 的提交检查 Git 作者，以及受保护分支和推送后查看 CI 的习惯。其他远程仓库不受影响。
- Codex hooks（可选）：仅作提醒；从不阻止 Git 操作，也不修改 Git 配置。
验证#
安装后运行 setup。Agent 会引导你完成 OAuth（原生插件）或配置 Secrets（Benchyard shell），然后通过 MCP 或 CLI 调用 whoami 和 inbox。仅登录网站并不会连接 MCP。
面向组织#
工作区构建可以内置固定的实例地址，成员只需授权内置的 OAuth 连接。构建中绝不包含凭据。参见插件仓库中的分发指南。