发布时间：2026-08-10 | 最后更新：2026-08-10

署名：落子AI·电气工程师

2026年8月6日，OpenAI、微软、谷歌、亚马逊、Cursor、Vercel六方联合发布Agent Plugins 1.0.0开放规范，统一了AI智能体插件的打包格式。本文从技术实践角度解析该标准的核心内容、与MCP协议的层级关系，以及MCP从有状态到无状态的迁移要点。核心结论：Agent Plugins不替代MCP或Agent Skills，而是将两者打包为跨客户端可移植的统一插件格式；MCP 2026-07-28规范已将协议改为完全无状态，部署门槛大幅降低。作为AI工具推荐系列的第5篇，本文提供完整的适配步骤和对比分析。

一、Agent Plugins 1.0.0是什么

1.1 解决"第二个客户端"问题

在Agent Plugins 1.0.0发布之前，AI智能体生态面临一个实际痛点：同一个插件组件（比如一个数据库查询Skill或一个MCP服务器配置），要适配不同客户端（Cursor、VS Code、ChatGPT等），需要为每个客户端重新排列文件、改写manifest、调整MCP配置。维护成本随客户端数量线性增长，组件副本之间逐渐偏离。

Agent Plugins 1.0.0由Vercel发起，AWS、Anysphere（Cursor）、GitHub、Microsoft、OpenAI协作开发完成，规范于2026年7月24日发布至仓库，8月6日由Vercel正式公开宣布（据Vercel官方博客，2026-08-06）。Google于同日加入技术指导委员会成为第六位核心维护者，由Google DeepMind高级工程师Kevin Hou代表（据Virtualization Review报道，2026-08-06）。

1.2 六巨头治理结构

技术指导委员会（TSC）核心维护者共六位：

代表方	维护者	角色
AWS	Clare Liguori	Core Maintainer
Cursor (Anysphere)	Roshan Sadanani	Core Maintainer
Microsoft	Harald Kirschner	Core Maintainer
OpenAI	Gav Verma	Core Maintainer
Vercel	Jonathan Hefner	Lead Maintainer
Google	Kevin Hou (Google DeepMind)	Core Maintainer（8/6加入）

项目章程规定，任何单一厂商不得占据多数席位。规范采用CC-BY-4.0许可，代码采用Apache 2.0许可。值得注意的是，Anthropic虽然发明了MCP和Agent Skills，但未参与Agent Plugins 1.0.0的核心维护者行列，Claude Code也未列入首发兼容客户端名单（据IT之家报道，2026-08-07）。

1.3 首发兼容客户端

客户端	Agent Skills支持	MCP支持
ChatGPT / Codex	✅	✅
Cursor	✅	✅
GitHub Copilot	✅	✅
Kiro (AWS)	✅	✅
VS Code	✅	✅

Google旗下Agents CLI和Data Agent Kit（支持BigQuery、Spanner、Cloud SQL）也已支持该格式（据Google官方公告，2026-08-06）。

二、Agent Plugins与MCP的关系：更高层级的抽象

2.1 三层架构定位

理解Agent Plugins的关键在于认清它在AI智能体互操作栈中的位置：

层级	职责	标准	解决的问题
打包层	将可复用组件打包为可移植插件	Agent Plugins 1.0.0	跨客户端的文件结构和manifest统一
连接层	运行时连接外部工具和数据	MCP (2026-07-28)	Agent如何调用API、数据库等服务
知识层	可复用的指令和资源	Agent Skills (SKILL.md)	Agent如何执行特定领域任务

Agent Plugins不替代MCP或Agent Skills，而是将两者打包到一个可预测的目录结构中。一个插件可以包含Skills、MCP服务器配置，或两者兼有。

2.2 插件目录结构

一个标准的Agent Plugin就是一个目录：

deployment-assistant/
├── plugin.json          # 必需：清单文件
├── skills/              # Agent Skills目录
│   └── deploy-service/
│       ├── SKILL.md     # 技能定义
│       ├── scripts/     # 可执行脚本
│       └── references/  # 参考文档
├── mcp.json             # MCP服务器配置
└── com.example.client/  # 客户端特定扩展（反向域名命名空间）
    └── hooks/

2.3 最小清单文件

plugin.json只需两个必填字段：

// json
{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "deployment-assistant"
}

可选字段包括：version、description、author、homepage、repository、license、keywords。schema是封闭的——可移植的顶层字段仅限于规范定义的那些，客户端特定数据应放在extensions对象中（据AAIF官方博客，2026-08-06）。

2.4 故障隔离机制

规范定义了严格的故障隔离规则：

• 缺少的可选组件目录不是错误

• 单个Skill无效时，客户端应跳过该Skill并继续加载其他组件

• 单个MCP服务器无法启动/连接/认证时，不应阻止其余Skills或服务器加载

这意味着一个包含5个Skills和3个MCP服务器的插件，即使其中2个组件有问题，其余6个仍可正常工作。

三、MCP 2026-07-28：从有状态到无状态

3.1 核心变更

MCP 2026-07-28规范于7月28日发布，这是MCP协议自发布以来最重大的更新。Cloudflare于8月6日验证确认，MCP现在是完全无状态协议（据Cloudflare官方博客，2026-08-06）。

主要变化：

维度	旧版MCP（2025-11-25及之前）	新版MCP（2026-07-28）
握手	必须initialize/initialized交换	移除强制握手
会话	Mcp-Session-Id维持会话	移除会话，每次请求独立
服务器发现	初始化时完成	可选调用server/discover
基础设施	需要有状态服务器（如Durable Objects）	普通HTTP Worker即可
弹性请求	依赖打开的流	Multi Round-Trip Requests (MRTR)
HTTP头	信息仅在JSON体内	新增Mcp-Method和Mcp-Name头

3.2 无状态带来的实际收益

无状态化最直接的影响是部署简化：

• 消除粘性会话：autoscaling不再需要保持会话亲和性

• 简化部署：兼容Vercel、Cloudflare Workers、AWS Lambda等不支持持久连接的云平台

• 降低成本：请求处理完毕即释放资源，适合高并发场景

• 优雅部署更新：无需drain或迁移活跃会话

据Cloudflare介绍，其Code Mode MCP服务器已使用无状态模式服务每秒数千请求、累计数十亿次工具调用（据Cloudflare官方博客，2026-08-06）。

3.3 新增HTTP头：让基础设施理解MCP

新版规范要求Streamable HTTP请求携带Mcp-Method和Mcp-Name头：

POST /mcp HTTP/1.1
MCP-Protocol-Version: 2026-07-28
Mcp-Method: tools/call
Mcp-Name: search
Content-Type: application/json

{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search","arguments":{"q":"otters"}}}

网关、限流器、WAF无需解析JSON body即可基于HTTP头做路由决策和工具级指标记录。

3.4 特性生命周期管理

MCP 2026-07-28引入正式的特性生命周期：Active、Deprecated、Removed。被废弃的特性必须至少保留12个月才能移除。本次废弃的特性包括：Roots、Sampling、Logging、Dynamic Client Registration（DCR）、传统HTTP+SSE传输。DCR计划在2027年夏季后移除（据Cloudflare官方博客，2026-08-06）。

四、实战HowTo：如何适配Agent Plugins标准

步骤一：创建插件目录结构

为你的AI工具推荐插件建立标准目录：

// bash
mkdir -p my-plugin/skills/my-skill/scripts
mkdir -p my-plugin/skills/my-skill/references

步骤二：编写plugin.json清单

// json
{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "my-data-assistant",
  "version": "1.0.0",
  "description": "数据查询与分析助手插件",
  "author": "your-name",
  "license": "Apache-2.0",
  "keywords": ["data", "analysis", "sql"]
}

步骤三：编写Agent Skill

在skills/my-skill/SKILL.md中定义技能：

// markdown
---
name: data-query
description: 执行SQL查询并格式化结果。当用户需要查询数据库、生成报表或分析数据时使用。
license: Apache-2.0
---

# 数据查询技能

## 查询流程
1. 接收用户自然语言查询需求
2. 转换为SQL语句
3. 通过MCP服务器执行查询
4. 格式化返回结果

## 输出规范
结果以Markdown表格呈现，包含列名和数据类型标注。

步骤四：配置MCP服务器（mcp.json）

// json
{
  "mcpServers": {
    "database": {
      "type": "streamable-http",
      "url": "https://your-server.example.com/mcp",
      "headers": {
        "Authorization": "Bearer ${MCP_TOKEN}"
      }
    }
  }
}

每个MCP服务器必须声明显式传输类型：stdio、streamable-http或传统http+sse。

步骤五：迁移MCP服务器到无状态（如适用）

如果你的MCP服务器仍使用有状态模式，参考以下迁移路径：

1. 升级MCP TypeScript SDK到最新版本

2. 将McpAgent替换为createMcpHandler

3. 在/mcp端点同时提供新旧协议支持（向后兼容）

4. 逐步将功能从有状态路由迁移到无状态路由

5. 在废弃期内（12个月以上）让旧会话自然排空

6. 移除旧的有状态路由

最小化无状态MCP服务器代码示例：

// typescript
import { McpServer } from "@modelcontextprotocol/server";
import { createMcpHandler } from "agents/mcp/server";
import { z } from "zod";

function createServer() {
  const server = new McpServer({ name: "my-server", version: "1.0.0" });
  server.registerTool("query", {
    description: "查询数据",
    inputSchema: { sql: z.string() },
  }, async ({ sql }) => ({
    content: [{ type: "text", text: `执行查询: ${sql}` }],
  }));
  return server;
}

export default {
  fetch(request, env, ctx) {
    return createMcpHandler(createServer)(request, env, ctx);
  },
};

步骤六：验证与测试

在不同客户端中加载插件，确认：

• Skills出现在技能菜单中

• MCP服务器出现在服务器列表中

• 故障隔离生效（故意放一个无效Skill，确认其他组件不受影响）

五、三大标准对比：Agent Plugins vs MCP vs 传统API

维度	Agent Plugins 1.0.0	MCP (2026-07-28)	传统REST API
定位	打包与发现标准	运行时连接协议	数据传输协议
核心能力	统一插件目录格式	Agent连接外部工具	系统间数据交换
状态管理	不涉及（打包层）	完全无状态	通常无状态
跨客户端	一次打包，多客户端通用	需Agent Plugins包装才能跨客户端	需各自集成
传输方式	不涉及	stdio/Streamable HTTP	HTTP/HTTPS
治理	六方TSC，CC-BY-4.0	AAIF，开放治理	各自私有
适用场景	发布可复用Agent扩展	Agent运行时连接服务	传统系统集成

据法国竞争管理局2026年5月评估，OpenAI、Google和Anthropic三家公司合计占据AI Agent市场约84%的份额，并警告不同Agent之间的切换在实际中并不顺畅（据法国竞争管理局报告，2026-05）。Agent Plugins的出现从技术层面缓解了这一锁定问题——自建插件不再绑定单一客户端。

六、常见问题

Q1：Agent Plugins会替代MCP吗？

不会。Agent Plugins定义的是"如何打包"，MCP定义的是"如何连接"。两者是互补关系：Agent Plugins将Skills和MCP服务器配置打包到一个可移植目录中，但不改变它们各自的行为规范。据AAIF官方博客（2026-08-06），Agent Plugins是独立治理的开放规范，不属于AAIF项目。

Q2：Anthropic为什么没有参与Agent Plugins？

Anthropic发明了MCP和Agent Skills，但未加入Agent Plugins 1.0.0的核心维护者行列。Claude Code有自己的插件系统（.claude-plugin/plugin.json），且其插件目录截至7月中旬已有256个条目。VS Code同时支持Agent Plugins和Claude格式。是否最终收敛仍是开放问题（据The University Network报道，2026-08-07）。

Q3：现有的MCP服务器需要立即迁移到无状态吗？

不急。MCP 2026-07-28规范的/mcp端点同时接受新协议和2025 Streamable HTTP客户端的无状态请求，大多数客户端无需配置变更即可重连。仅当服务器依赖旧的有状态会话、服务端到客户端请求或独立流时，才需要按迁移指南逐步迁移。废弃特性有至少12个月的迁移窗口。

Q4：作为AI工具推荐开发者，我该优先支持哪个客户端？

建议优先支持VS Code和Cursor。两者都是Agent Plugins首发兼容客户端，且开发者基数大。打包一次，两个客户端同时可用。如果目标用户偏向ChatGPT生态，ChatGPT和Codex也已在首发名单中。

Q5：Agent Skills的SKILL.md有什么格式要求？

SKILL.md由YAML frontmatter和Markdown正文组成。必填字段：name（小写字母+数字+连字符，最长64字符）和description（最长1024字符，需包含任务关键词）。建议正文不超过500行，详细参考资料放到references/目录。Agent Skills采用渐进式披露机制：先广播名称和描述（约100 token），匹配时再加载完整指令（据Microsoft Agent Framework文档，2026-07-10）。

Q6：plugin.json的name字段有什么命名规则？

name字段必须是kebab-case格式（仅小写字母、数字和连字符），最长64字符，不能以连字符开头或结尾，不能包含连续连字符。不能使用斜杠、冒号或命名空间前缀。

Q7：插件可以包含客户端特定功能吗？

可以。Agent Plugins提供反向域名命名空间机制（如com.example.client/），客户端可以在其中放置hooks、commands等非可移植扩展。其他客户端会忽略不属于自己命名空间的目录。这确保客户端特定能力不会污染共享格式，同时保留各客户端的创新空间。

参考文献

1. Vercel. "Introducing Agent Plugins." (2026-08-06). https://vercel.com/blog/introducing-agent-plugins

2. AAIF Blog. "From Skills and Tools to Portable Agent Plugins." (2026-08-06). https://aaif.io/blog/from-skills-and-tools-to-portable-agent-plugins

3. Cloudflare Blog. "The next generation of MCP." (2026-08-06). https://blog.cloudflare.com/mcp-v2/

4. Virtualization Review. "Cloud Giants Back 'Agent Plugins' for Cross-Client AI." (2026-08-06). https://virtualizationreview.com/articles/2026/08/06/cloud-giants-back-agent-plugins-for-cross-client-ai.aspx

5. IT之家. "OpenAI面向AI智能体推出Agent Plugins规范." (2026-08-07). https://m.ithome.com/html/986816.htm

6. The University Network. "Google Joins Agent Plugins 1.0 as a Core Maintainer." (2026-08-07). https://www.tun.com/home/google-joins-agent-plugins-1-0-as-a-core-maintainer/

7. Microsoft Learn. "Agent Skills." (2026-07-10). https://learn.microsoft.com/en-nz/agent-framework/agents/skills

落子AI·电气工程师

知乎：https://www.zhihu.com/people/luoziai

头条号：https://www.toutiao.com/c/user/token/Ciy5Z6FHqZmgJzdfRlmdRHCV3ZDX6Ga04sRsUegv_LAVFBhzmSYJIdTeBapRhhpJCjwAAAAAAAAAAAAAUML2CYovPPpg7VxHcpJ6fXkCnCpmFPdC0jR1PeMhowq6M4Ky21s-TtwJCjjZOwubdeQQl4iZDhjDxYPqBCIBA2YaT6M=/?

本文部分内容由AI辅助生成，经人工审核校验后发布。所有引用数据来源已标注。