功能

MCP 与技能

Mac 上的 MCP 客户端与 AI 技能扩展

Atd 可以连接 MCP 服务器、加载技能、把工作委派给子代理,并运行你保存的命令,让 Mac 上的智能体用上你的工具,按你的方式做事。每一项都可以自己添加,也可以在对话里让 Atd 帮你配置。

“个人”扩展页列出五个 MCP 服务器:github、filesystem 和 docs-search 已就绪,sqlite 需要允许,calendar 已停用,旁边是命令、技能、子代理和记忆标签。

连接 MCP 服务器

Atd 是一个 MCP 客户端:在“设置 › 扩展”中添加 Model Context Protocol 服务器后,任务就能使用它提供的工具、资源和提示。本地服务器以命令形式在 Mac 上启动(stdio),远程服务器则通过 Streamable HTTP 或 HTTP + SSE 连接。

远程服务器可以在浏览器中通过 OAuth 登录,也可以使用 Bearer 令牌,由 Atd 从你指定的环境变量中读取。MCP 凭据保存在 Mac 的钥匙串中;本地服务器要先经你在系统对话框中允许才能运行,对话框会列出将要运行的具体内容。

  • 在输入框中输入 @ 并选择服务器,让智能体优先使用它的工具。
  • 工具较多的服务器可以按需加载工具,不必每次请求都附带全部工具。
  • 可以决定是否允许智能体读取服务器以资源形式共享的文件和数据。
  • 也可以直接让 Atd 添加:它会按服务器文档确定启动命令或 URL,保存前请你确认。

为重复的工作添加技能

技能是一个包含 SKILL.md 文件的文件夹,告诉智能体如何完成某一类工作,比如团队的发布说明写法或代码审查清单。每个任务都会按名称和描述列出你的技能,任务对得上时再加载技能的具体说明。

个人技能保存在 ~/.atd/skills,~/.agents/skills 中的技能则与其他代理工具共用。在输入框中输入 / 可以手动选择技能,也可以把技能设为只在你选择时才启用。

Atd 还自带内置技能,其中包括它在你提出需求时用来创建技能、子代理、MCP、命令、自动化和应用的技能。内置技能可以修改,之后也能恢复为应用自带的版本。

把工作委派给子代理

子代理是智能体可以把某一类工作交给它的专门助手,定义在 ~/.atd/agents 中的一个 Markdown 文件里:何时委派给它、它能用哪些工具,以及它的指令。每次委派都从零开始,只带着这些指令和交给它的工作;运行过程会显示在对话中。

子代理使用发起委派的任务所用的模型,只能在任务文件夹内写入文件。在“设置 › 扩展”中可以限制子代理的工具,或给它比任务更严格的批准方式;它的权限永远不会超出任务本身。

已保存的命令与斜杠命令

命令是可复用的提示词,可以带参数。你可以在面板中运行它,用它自己的全局快捷键运行,在其他应用中选中文字后从选区工具栏运行,对截图里选取的文字运行,或从截图工具栏运行。

在输入框中输入 / 可以使用 /new、/model、/compact 等斜杠命令并选择技能;输入 @ 则可以把已保存的命令、子代理、MCP 服务器、文件或以前的对话加入消息。

每个命令都可以设定读取什么(输入的文字、选中的文字、剪贴板或截图),以及回答去往哪里。命令还可以加载技能、允许调用子代理、建议使用某个 MCP 服务器的工具,或引用另一段对话的摘录。

  • 在对话中显示回答,或在运行命令的应用上方用卡片显示。
  • 替换选中的文字、插入到选中文字之后,或插入到光标处。
  • 拷贝到剪贴板,或在截图里选取的文字上做标注。
  • 写入前先确认回答,并用你挑选的调整建议重新生成。
  • 每个命令最多 8 个快捷键,各自可以固定参数值或回答去向。

安装插件包

插件把命令、技能、子代理和 MCP 打包在一起。可以从本地文件夹、锁定到具体提交的 Git 仓库,或经注册表完整性校验的 npm 软件包安装。Atd 支持多种常见的插件结构,包括开放的 Agent Plugins 和 Agent Skills 格式。

安装前,Atd 会列出插件包含的内容、可在这台 Mac 上运行的程序以及会连接的服务器。安装过程不会运行任何代码,插件默认关闭;其中的项目为只读,复制到“个人”后才能修改。插件没有签名,请只安装来自可信来源的插件。

常见问题

Atd 支持哪些 MCP 传输方式?

Atd 支持以命令形式在 Mac 上启动、通过 stdio 通信的本地 MCP 服务器,以及通过 Streamable HTTP 或较早的 HTTP + SSE 连接的远程服务器。远程服务器可以不做身份验证,也可以使用从环境变量读取的 Bearer 令牌,或在浏览器中通过 OAuth 登录。

MCP 服务器和工具能访问我的文件吗?

工具和 MCP 服务器能访问哪些文件和外部服务,取决于它们自身的配置和当前任务的权限。本地 MCP 服务器要经你允许才能运行,插件在安装前也会列出全部内容供你查看。请只添加你信任的服务器,并在“设置 › 扩展”中查看每个服务器提供的能力。

技能、子代理和命令有什么区别?

技能是一套做事方法,工作与它的描述对得上时,智能体会把它加载到当前任务中;子代理是独立的专门助手,智能体会把部分工作交给它,它有自己的指令和工具;命令是你自己运行的提示词,可以从面板、快捷键、选区工具栏或截图工具栏启动。

能用我为其他代理工具准备的技能吗?

可以。~/.agents/skills 中的技能会在 Atd 中显示为“共享技能”;符合 Agent Skills 格式的文件夹也可以作为插件,从本地文件夹、Git 或 npm 安装。

需要自己编写配置文件吗?

不需要。在对话中让 Atd 添加 MCP 服务器、创建技能或子代理、保存命令即可:它只会询问影响结果的选择,保存服务器、子代理或命令前会请你确认将要保存的内容。你也可以在设置中逐项手动添加。

相关功能

更新日志