返回博客列表

为什么和为谁构建 Claude 插件:MCP Connector、Skills 与目录发布全指南

2026-09-25T18:30:00+08:00
Claude插件PluginMCPSkillsAnthropicAgent

为什么和为谁构建 Claude 插件:MCP Connector、Skills 与目录发布全指南

Anthropic 把"给 Claude 做扩展"这件事,产品化成了一条流水线。

Claude 的插件体系最近完成了一次升级:不再只是 Claude Code 终端里的插件,而是一套覆盖 claude.ai、桌面端、移动端、Cowork 和 Claude Code 的全平台扩展机制。官方文档开篇就给出了插件的定义:

插件(plugin)是一个包,人们添加一次,就能在 claude.ai、桌面和移动应用、Cowork 以及 Claude Code 中使用。 插件打包你的集成所需的一切,以任意组合:MCP connector、Skills、可选的 MCP Apps UI,以及 Commands 和 agents。

这篇文章基于 claude.com/docs/build/overview 官方文档,讲清楚三个问题:Claude 插件是什么、为什么值得构建、以及从零到发布的具体步骤。

本文提纲

  1. 插件是什么:一次添加、全平台使用
  2. 插件的四个组成部分
  3. 为什么构建插件:把产品带进 Claude
  4. 构建与发布的七个步骤
  5. 官方工具链:Claude Code 帮你构建和检查
  6. 从哪开始:文档地图

插件是什么:一次添加、全平台使用

先理解插件的定位。Claude 生态里,扩展机制分散在不同地方:MCP server 连接外部工具、Skills 教 Claude 工作流、Commands 提供快捷动作。插件把这些打包成一个整体,用户添加一次,就能在所有 Claude 表面上使用。

关键点:"一次添加,处处可用"。过去你可能要在 Claude Code 里配 MCP、在 claude.ai 里装技能、在桌面上单独折腾——插件把这一切统一了。用户不需要理解底层是 MCP 还是 Skill,只需要在目录里点一下"添加"。

这背后是 Anthropic 的生态战略:把第三方扩展从"开发者自娱自乐"变成"可发现、可安装、可审核的应用市场"。

插件的四个组成部分

一个插件可以包含以下任意组合:

组件 作用 何时需要
MCP connector 指向你构建和托管的 MCP server,让 Claude 访问你的产品或数据 Claude 需要连接你的产品/数据时
Skills 教 Claude 你的工作流——步骤顺序、默认值、好的输出长什么样 你有特定的工作流要教
MCP Apps 让 connector 在对话中显示交互式 UI 需要交互界面时(可选)
Commands 和 agents 命名动作,或 Claude 可以委派任务的专家 提供快捷操作或专项能力

这个设计的精妙之处:"插件需要 MCP server 吗"不再是一个技术问题,而是一个产品问题。 官方文档专门有一页叫 "Decide what to include in your plugin"(决定你的插件包含什么)——先想清楚你要给 Claude 提供什么,再选组件,而不是反过来。

为什么构建插件:把产品带进 Claude

官方文档第一句话就是定位:"Build a plugin people use inside Claude"——构建一个人们在 Claude 内部使用的插件。这回答了"为什么":

把你的产品或工作流,变成 Claude 生态的一部分。

具体来说有几种动机:

  • 你的产品有 API/数据:通过 MCP connector,Claude 用户可以直接在你的产品里查询、操作——你的产品成为 Claude 的一个"能力"。
  • 你有独特的工作流:比如一套特定的内容生产流程、代码规范、分析模板。写成 Skill,任何 Claude 用户都能复用。
  • 你想触达 Claude 的付费用户:插件提交到 Anthropic 的目录(claude.ai/directory)后,任何付费计划的用户都能添加。这是现成的分发渠道。

对开发者来说,最实在的一点是:Claude 有上亿用户,插件目录是触达他们的入口。 而且 Anthropic 会审核每个提交——这既是门槛,也是信任背书。

构建与发布的七个步骤

官方文档给出了从零到发布的完整流程,按顺序执行:

1. 布局插件(Lay out the plugin) 创建插件文件夹和 manifest(清单),引用它用到的 MCP server。如果你是第一次做,从 "Build your first plugin" 开始;要看完整结构,读 "Plugin structure and testing"。

⚠️ 重要提醒:Chat、Cowork 和 Claude Code 会加载插件的不同部分。动手设计前,先查 "Plugin feature support across platforms"(各平台对插件功能的支持),避免设计了一个只有部分平台能用的插件。

2. 写 Skills 在插件的 SKILL.md 文件里教 Claude 你的工作流。这一步覆盖 frontmatter(元数据)、指令(instructions)、参考文件(reference files)和脚本(scripts)。

3. 构建 MCP server 如果插件需要访问你的产品或数据,实现 server,处理好针对 Claude 客户端的认证,并对照 Claude 测试。第一次写 MCP server 可以从 "Build your first MCP server" 开始。本地 server 也可以打包成桌面扩展。

4. 加交互 UI(可选) 想让 server 在对话中显示交互组件,用 MCP Apps 构建。这步可选。

5. 测试 发布前在 Claude 里试插件。"Test the plugin on each surface" 覆盖 claude.ai、Cowork 和 Claude Code;"Test your MCP server" 覆盖把 server 添加为自定义 connector。

6. 发布 把插件提交到目录,把它的 MCP server 作为 connector 提交,并维护 listing(列表信息)。从 "Publish to the directory" 开始。

7. 测量 用户用上之后,看他们是否真的在用——"Measure usage"(测量使用情况)。

官方工具链:Claude Code 帮你构建和检查

构建插件的大部分工具都在 Claude Code(Anthropic 的命令行编码工具)里。用插件不需要 Claude Code,但构建插件建议用它——它能校验插件文件夹、跑 eval、从本地文件夹加载插件。

需要先安装 Claude Code,然后认识这些工具:

# 校验插件:检查 manifest 和组件文件,推送前先跑
claude plugin validate

# 从本地文件夹加载插件启动 Claude Code,发布前先试 skills 和 commands
claude --plugin-dir /path/to/your/plugin

# 跑你写的 eval 用例,对比有无插件时 Claude 的结果
# 注意:每次运行都是真实模型调用,会计入你的套餐用量或 API 账单
claude plugin eval

还有一个 /skill-doctor 命令(在 Claude Code 里用的斜杠命令),帮助诊断 skill 的问题。

这套工具链的设计很聪明:把"插件开发"变成了"有校验、有测试、有反馈"的工程流程,而不是手写一堆文件靠猜。claude plugin validate 相当于插件世界的 linter,claude plugin eval 相当于单元测试。

从哪开始:文档地图

官方文档为不同场景准备了不同的入口:

  • 第一次做插件:→ "Build your first plugin"
  • 只想连接一个工具/给自己装插件:→ "Customize Claude"(这是使用文档,不是开发文档)
  • 不确定插件是否需要 MCP server:→ "Decide what to include in your plugin"
  • 只在组织内部分发:→ "Roll out a plugin to your whole organization"
  • 只面向 Claude Code 终端/IDE 用户:→ Claude Code 插件文档(那个表面单独支持的功能)

如果你想系统学,官方还提供完整的文档索引(/docs/llms.txt),可以用这个文件发现所有页面。

参考链接

你会把什么产品做成 Claude 插件?评论区聊聊你的想法,觉得有用点个赞让更多人看到。


作者: itech001 来源: 公众号:AI人工智能时代(the-ai-era) 网站: https://www.theaiera.top/ 关注每日最新AI新闻和技术博客,主页有更多的文章的AI 技术参考:https://www.theaiera.top

本文首发于 AI人工智能时代,转载请注明出处。

分享给朋友