跳到正文

插件:让 Agent 获得需要的能力

分清 Plugin、Skill 与 MCP,安装并连接所需能力,再用一次真实读取验证连接。

约 7 分钟

读完,你会做到

完成一次插件能力验证,读到能对照来源核对的真实数据。

你已经能让 Agent 写页面、整理文件。下一步可能是读取外部服务里的真实数据。插件解决“Agent 可以怎样做、能连接什么”。

先从一个明确需求开始,例如“读取项目服务里最近的工作项”。不要为将来可能用到的能力安装一长串插件;你需要知道每项能力会在当前任务中发挥什么作用。

三个名字,各自负责什么

名称可以怎样理解使用时要确认
Plugin(插件)按场景组织的一包能力,可以包含 Skill 和 MCP包里有什么、适合什么工作
Skill告诉 Agent 如何完成一类工作的说明与资源是否适合当前目标与输入
MCP Server向 Agent 提供外部工具或数据的连接方式是否已配置、已登录、支持当前 Agent harness

因此,有 Skill 不等于已经获得外部账号访问权;装了包含 MCP 的插件,也可能还需要连接服务。Agent harness 是执行任务的入口,Model 是你选用的模型,两者与插件是不同选择。

方法、工具连接与授权
  1. Skill可以重复使用的做事方法
  2. MCP 连接调用外部服务的工具
  3. 账号授权决定连接能读写什么
Plugin 将能力组合起来;连接仍需相应的支持、配置和授权。

插件把工作方法和工具组织起来,Agent 用它们完成任务;连接能读写什么,由外部服务的账号授权决定。

安装后,再确认连接

先进入目标工作空间,从侧栏直接打开“插件”。主页面分为“已安装”和“发现插件”,可以按名称、场景或 Skill 搜索。打开插件详情,阅读“适合这样用”和“插件内容”,再安装需要的那一个。拥有者和编辑者可以安装、更新或卸载;查看者看不到相同的管理操作。

安装完成后回到“已安装”。如果插件含外部连接,查看详情中的“连接”状态:它可能无需连接、需要设置、需要 OAuth 登录,或者只支持某个 Agent harness。点对应的“连接 …”,按服务的登录流程完成授权,再回来确认状态。

权限分成两层理解更清楚:工作空间角色决定你能否管理插件,外部服务的账号与授权决定这个连接能读写什么。登录时核对服务、账号和请求的访问范围;共享工作空间里的插件操作应按团队已经约定的用途进行。

工具托盘内放着操作手册和连接插头,连线通过钥匙孔通向外部数据。
Plugin 组织能力,Skill 提供做法,MCP 连接工具或数据;安装与外部服务授权是两回事。

可以用一次小而具体的读取验证:

请使用刚连接的项目服务,读取我指定项目最近五条工作项,列出标题、状态和来源链接。只读取,不修改。若当前 Agent harness 不支持这个连接,或缺少授权,请明确说明,不要用示例数据替代。

验收重点是数据可追溯,而不是回答看起来像真的。打开其中一条来源链接,核对标题和状态;没有成功读取之前,不要让后续工作依赖这份结果。

高级入口适合已有明确来源时使用

“插件”页右上角的“高级”提供 Skills、MCP Servers、Agent Plugins 三类资源。独立 Skill 可以从支持的链接、文件夹或压缩包等入口导入;远程 MCP 使用 HTTPS 服务地址并按表单配置;Agent Plugin 支持文件夹、ZIP 或公开 GitHub 仓库。

这些入口适合已经拿到服务方说明或团队确认资源的人。普通用户优先从“发现插件”选择完整插件,更容易看清它包含什么。不要把普通网页链接当作 MCP 服务地址,也不要把仅有名称的插件当成已经安装。

看到“更新”或“全部更新”时,按需要显式更新;插件不是自动升级的承诺。卸载会从此工作空间移除插件,但不会撤销第三方账号授权。若还要停止第三方访问,需要在相应服务的授权管理中处理。

上面的步骤是在 Macshop 工作空间里管理能力。如果是要让外部 Claude Code 客户端连接工具,请参考 Claude Code MCP 配置指南;客户端配置和授权是另一条流程。

让团队随时看到结果

如果读到的结果需要团队随时查看,可以请 Agent 把它做成网页并发布:只有工作空间成员能打开,30 天没人打开的网页会被删除,除非开启了“长期保留”。要定期刷新,就新建一个定时任务,在提示词里写明重新生成并发布,网页地址保持不变。

出问题时,沿链路往回找

插件未出现,先确认工作空间与“已安装”列表;连接不可用,检查配置、OAuth 状态与 Agent harness 支持;读到的数据不对,打开来源链接核对,再检查授权的账号和访问范围。

完成本章的标准是:一次真实能力调用成功,返回的数据能对照来源链接核对。