OpenAI MCP Extensions 教程:让 MCP 插件在 ChatGPT 里像原生功能

📌 项目地址:github.com/openai/mcp-extensions | 星数:695+ | 出品:OpenAI 官方 | SDK:@openai/mcp-extensions(TypeScript)

📋 项目简介

标准 MCP 插件在 ChatGPT 里只是「能被调用」,谈不上原生体验。OpenAI MCP Extensions 是官方给出的增量规范:给 MCP 协议加四类 ChatGPT 特有能力,让你的插件拥有侧边栏入口、文件查看器、输入框资源提及和富表单交互。所有示例都用官方演示插件 Bits & Bolts 演示。MCP 生态的配套工具见 GitHub官方MCP教程 与 FastMCP教程。

✨ 四大能力

能力体验
侧边栏入口 Sidebar entrypoints用户从 ChatGPT 侧边栏直接进入你的应用
文件扩展名处理器用户打开支持的文件类型时渲染自定义查看器
Composer 提及输入框里搜索你的插件资源,引用进消息发送
扩展表单 Form elicitation用户用缩略图选择等富交互完成参数填写

🚀 上手三步

# ① 体验标杆:装官方演示插件
#    ChatGPT 插件目录 → Bits & Bolts Remote
#    侧边栏打开 Parts Library 感受完整交互

# ② 创建自己的插件
#    文档:developers.openai.com/codex/build-plugins

# ③ 给 MCP 服务器加 SDK
#    TypeScript: @openai/mcp-extensions
#    (仓库含 typescript/README 安装指引)

💡 使用建议

📚 常见问题

OpenAI MCP Extensions 是什么?

OpenAI 官方开源的规范与 SDK(695 星):给 MCP 协议加上 ChatGPT 特有能力,让开发者的插件感觉像原生的一等功能。四大能力:侧边栏入口(用户从侧边栏直接打开你的应用)、文件扩展名处理器(打开支持的文件类型时渲染自定义查看器)、composer 提及(用户在输入框搜索你的插件资源并引用到消息)、扩展表单(用缩略图选择做 elicitation)。

怎么上手?

三步:① 先在 ChatGPT 插件目录安装官方演示插件 Bits & Bolts Remote,从侧边栏打开 Parts Library 感受完整体验;② 按 developers.openai.com/codex/build-plugins 文档创建自己的插件;③ 给 MCP 服务器加上官方 SDK——TypeScript 装 @openai/mcp-extensions。

和标准 MCP 什么关系?

完全向后兼容:MCP 服务器加 SDK 即可增量启用这些 ChatGPT 特有能力,不装 SDK 仍然是标准 MCP 服务器。这是 OpenAI 把自家客户端的插件体验需求反哺给 MCP 生态的规范——意味着一份服务器代码可以同时服务 Claude/ChatGPT 等 MCP 宿主,只是 ChatGPT 里体验更原生。