扩展、MCP 与连接器
技能、子智能体、命令、MCP 服务器,以及你自己的 HTTP API —— 集中在一处,密钥交给操作系统保管。
⇧⌘X 打开扩展:Claude Code 与 Codex 的技能、子智能体、命令、插件和 MCP 服务器集中在一个列表中,并显示每台服务器的实时连接状态。
在这里可以一键添加官方 MCP 服务器,或把其中任何一个插入并运行在当前活动的智能体中。智能体窗格的状态栏会显示该智能体实际拥有的技能、子智能体和 MCP 服务器。
插件作为工具#
安装在 Agentty 中的插件可以为 Agentty 中运行的 AI 智能体 (Claude Code、Codex) 提供工具。通过 Agentty 自带的 MCP 服务器(agentty-plugins MCP 服务器)工作。当至少有一个启用的插件声明了 mcp.tools 权限并在 contributes.tools 下列出工具时,智能体会自动获得服务器。
提供工具的每个插件的权限标签页上都有**"允许 MCP 连接"**开关,默认为 ON。用户将其关闭时,智能体就不能再列出或调用该插件的工具。
要编写提供工具的插件,参见清单参考中的 contributes.tools 结构,以及 Node.js SDK 中的 plugin.tool() 处理器。
MCP 服务器#
Agentty 不做中转,而是把服务器注册给智能体 CLI:服务器被加入项目或智能体自身的配置,智能体直接与它通信。
当服务器 URL 或参数中的某个值看起来像密钥时,显示时会被遮蔽。
API 连接器#
连接器把任意 HTTP API 变成智能体可用的 MCP 服务器。你只需描述一次端点 —— 方法、路径、各参数的含义 —— 智能体就获得了可以调用的工具。
- 定义存放在
~/.agentty/connectors.json。 - 密钥不会进入该文件。 它们保存在操作系统的凭据存储中:macOS 是钥匙串,Windows 是凭据管理器,Linux 是 Secret Service;若都不存在,则使用仅你的账号可读的私有文件。
- 可能含密钥的值,在任何显示位置都会被遮蔽。
- API 密钥只会发送到输入它时所填的主机。 Agentty 会把该主机与密钥一起记住。向其他主机的调用会被拒绝,直到你为它重新输入密钥;更换主机而不提供新密钥就保存连接器也会被拒绝(同一主机上换路径没问题)。旧版本保存的密钥会自动绑定到其连接器的主机。导入备份时,每个密钥会绑定到文件中为它指定的主机。
智能体登录#
设置 → 账号决定新的智能体标签页如何登录,面向那些无法使用 CLI 自身登录的机器:
| 智能体 | 方式 |
|---|---|
| Claude Code | API 密钥、网关令牌、claude setup-token 的 OAuth 令牌、Amazon Bedrock、Google Vertex AI |
| Codex | API 密钥,或导入的 auth.json |
方式与非密钥值保存在 ~/.agentty/agent-auth.json,密钥和令牌进入凭据存储。测试会用提供方自己的端点验证密钥。
凭据只到达智能体进程。智能体退出后留下的 shell 不会保留它们,属于其他登录方式的变量会在智能体环境中被移除,因此你在 shell 配置里 export 的密钥无法覆盖你选定的方式。
如果保存的方式无法使用(例如密钥已从凭据存储中删除),窗格会说明情况,智能体回退到自身的登录。
智能体 harness#
如果项目声明了 harness,进入它时会出现以 harness 开始:选一个入口(例如 /implement),粘贴工单号或链接,智能体就以此开始。
满足下列任一条件即视为 harness:.harness 文件、harness.json / .yaml / HARNESS.md、名为 harness 或 harness-* 的项目技能、agentty.json 中的 harness 列表,以及你在设置 → 项目中添加的模式。
项目可以自定义入口:
{
"harness": [
{ "label": "Start a ticket", "command": "/implement", "input": "Ticket key or URL" },
{ "label": "Fix a bug", "prompt": "Reproduce and fix {input}", "agent": "codex" }
]
}command 会把输入追加在后面;在 prompt 中,{input} 会被替换为输入。