跳到主要内容
AI教程

使用 OpenAI MCP 扩展构建原生体验般的 ChatGPT 插件

了解 OpenAI MCP 扩展如何通过专为 ChatGPT 打造的体验增强 MCP 插件。本教程涵盖可用功能、TypeScript 和 Python SDK 的配置、Bits & Bolts 示例、实用开发流程，以及选择和实现扩展的技巧。

AI我搜编辑部阅读约 6 分钟
使用 OpenAI MCP 扩展构建原生体验般的 ChatGPT 插件

OpenAI MCP Extensions 的功能

OpenAI MCP Extensions 为模型上下文协议（MCP）添加了专属于 ChatGPT 的功能。它面向已经拥有插件或正准备创建插件的开发者，帮助插件更接近原生 ChatGPT 功能的使用体验。

该项目提供 SDK，用于将受支持的扩展集成到 MCP 服务器中。TypeScript 软件包可与 MCP 服务器和 Apps 配合使用，而 Python 软件包面向 MCP 服务器。

主要功能

侧边栏入口

侧边栏入口允许用户直接从 ChatGPT 侧边栏打开你的应用。这为访问零件库等体验提供了持久且易于发现的方式。

从侧边栏打开的 Bits and Bolts 零件库

文件扩展处理器

文件扩展入口允许插件在用户打开受支持的文件类型时渲染自定义查看器。该仓库通过在专用查看器中打开 CAD 文件演示了这一功能。

Composer 提及

Composer 提及允许用户搜索插件提供的资源，并将这些资源的引用添加到消息中。在演示中，用户可以从 Composer 中搜索 CAD 零件。

扩展表单

OpenAI 表单引导支持更丰富的选择体验。Bits & Bolts 示例使用缩略图选项，让用户可以直观地选择 CAD 零件。

前置条件

在添加这些扩展之前，请按照 OpenAI 插件文档创建插件。OpenAI MCP Extensions 用于增强现有插件和 MCP 服务器，而不是替代初始插件设置。

你还需要 TypeScript 或 Python 开发环境，具体取决于所选 SDK。

试用参考插件

了解预期用户体验的最快方式，是试用 Bits & Bolts Remote，也就是整个仓库中使用的示例插件。

  1. 打开 Bits & Bolts Remote 插件目录页面并安装插件。

  2. 在 ChatGPT 侧边栏中选择 Bits & Bolts Remote。

  3. 打开 Parts Library，了解插件如何以侧边栏体验呈现。

  4. 参考演示，了解自定义文件查看、Composer 资源搜索和可视化表单选择。

安装 SDK

TypeScript

构建 TypeScript MCP 服务器或 Apps 时，请使用 @openai/mcp-extensions。使用你偏好的 JavaScript 软件包管理器安装：

npm install @openai/mcp-extensions

有关当前软件包安装说明和 SDK 特定细节，请参阅仓库中的 TypeScript 安装文档。

Python

对于 Python MCP 服务器，请安装 openai-mcp-extensions：

pip install openai-mcp-extensions

有关最新设置指南，请参阅 Python 安装文档。

README 说明，TypeScript 支持 MCP 服务器和 Apps，而 Python 支持 MCP 服务器。请根据扩展逻辑的运行位置选择 SDK。

基本开发流程

  1. 创建插件。 在集成这些扩展之前，完成标准插件设置。

  2. 添加适用的 SDK。 服务器或 Apps 使用 TypeScript 软件包，服务器端集成使用 Python 软件包。

  3. 选择扩展。 确定用户应通过侧边栏发现应用、在自定义查看器中打开受支持的文件、在 Composer 中提及插件资源，还是与扩展表单交互。

  4. 实现扩展契约。 按照权威的 OpenAI MCP Extensions 规范实现必需字段和行为。

  5. 测试完整交互流程。 确认插件入口或资源出现在预期的 ChatGPT 界面中，并确认最终体验按预期运行。

功能方案示例

构建侧边栏库

如果插件包含用户可能希望独立于对话打开的界面，请使用 MCP App 入口。Bits & Bolts Parts Library 展示了这种模式：用户在侧边栏中选择插件，然后浏览其应用体验。

显示专用文件格式

如果插件能够识别特定文件类型并提供更合适的查看器，请使用文件扩展入口。该演示以 CAD 内容为例。请根据规范定义支持范围，不要假设所有文件都应由插件处理。

让资源可在 Composer 中使用

如果用户需要查找插件资源并将引用附加到消息中，请使用 Composer 提及。例如，面向目录的插件可以公开可搜索的项目，例如 Bits & Bolts 展示的 CAD 零件。

提供可视化选项

当纯文本选项无法提供足够背景信息时，请使用 OpenAI 表单引导来帮助用户进行选择。当选项更容易通过视觉识别时，缩略图选项尤其有用，CAD 零件选择器就是一个很好的示例。

高级技巧

  • 从用户入口开始。选择与任务匹配的 ChatGPT 界面。直接访问应用时使用侧边栏，处理受支持的文档时使用文件处理器，引用消息时使用编写器中的提及功能，需要结构化选择时使用扩展表单。

  • 将 Bits & Bolts 作为行为参考。在实现自己的扩展之前先研究该示例，了解这些功能如何融入用户工作流。

  • 开发时保持规范文档处于打开状态。顶层 README 概述了相关功能，但规范文档包含实现所需的详细扩展契约。

  • 查看特定语言的文档。TypeScript 和 Python SDK 的安装与集成细节可能有所不同。

  • 围绕一个连贯的工作流组合功能。该展示示例说明了侧边栏访问、文件查看、编写器资源和丰富表单如何支持同一零件导向体验的不同阶段。

结论

OpenAI MCP Extensions 帮助开发者超越基础的 MCP 集成，创建能够自然融入 ChatGPT 的插件。请从标准插件开始，安装适用于所用语言的 SDK，选择合适的入口或交互方式，并根据项目规范完成实现。该代码仓库采用 Apache License 2.0 许可。