如需查看完整的文档索引,请参阅 llms.txt。在文档页面的 URL 末尾加上 .md 即可查看该页面的 Markdown 版本。
主导航
主题
概览 智能体访问 ChatGPT 与 Codex 用户文档 使用场景

连接并测试插件

如果插件包含 MCP 服务器,请先测试服务器,再打包并评估完整插件。

先逐项测试插件的功能,再测试安装后的完整插件。如果插件包含 MCP 服务器,请先在 ChatGPT 中连接并评估服务器,然后将插件及其技能一起打包,测试完整的使用流程。如果插件只包含技能,可以跳过第一节。

在整个开发过程中,请保留评估用的提示词和结果,以便比较不同版本的表现。

测试 MCP 服务器(可选)

准备端点

请确认以下各项:

  • 可以通过公共 HTTPS 端点或安全 MCP 隧道访问 MCP 服务器。
  • 如果使用公共端点,该端点支持流式 HTTP,路径通常为 /mcp。如果使用隧道,隧道能够访问为其配置的 stdio 或 HTTP MCP 服务器。
  • 工具的名称、描述、模式和注解齐全。
  • 对于需要账号的工具,身份验证发现机制可以正常工作。

通过安全 MCP 隧道,您可以在 ChatGPT 中连接私有 MCP 服务器,无需将服务器暴露在公网上。您也可以使用开发隧道或其他 HTTPS 转发服务,为本地测试提供端点。提交插件时仍须提供公共 HTTPS 端点,这些测试方式不能替代该端点。

检查 MCP 服务器

使用 MCP Inspector 直接列出并调用工具:

npx @modelcontextprotocol/inspector@latest

逐一测试每个工具,覆盖典型输入、边界情况、缺少标识符和结果为空的情况。检查模式校验、身份验证错误、注解、确认流程以及模型可读取的结果。

添加 MCP 服务器

添加和使用自定义 MCP 服务器时,须遵守账号和工作空间的策略。

  1. 前往 ChatGPT 插件页面。
  2. 选择加号按钮,然后选择添加自定义 MCP 服务器。
  3. 输入向用户显示的名称和描述。
  4. 在连接下选择连接方式:
    • 如果使用公共端点,请输入 MCP 服务器的 URL,其中应包含 /mcp 路径。
    • 如果使用安全 MCP 隧道,请选择隧道,然后选择一个可用的隧道或输入其 tunnel_id。
  5. 配置身份验证,阅读风险提示,然后选择我已了解并希望继续。
  6. 选择创建为插件。
  7. 检查从服务器发现的工具和元数据。

如果 ChatGPT 无法连接,请使用 MCP Inspector 验证公共 HTTPS 端点,或检查隧道与工作空间的关联以及 tunnel-client 的状态。请先解决传输、初始化、模式或身份验证错误,再继续操作。

检查工具选择

安装刚创建的插件,然后开始新对话。在提示词输入框中输入 @ 并选择插件。创建评估集,涵盖以下情况:

  • 应调用特定工具的直接请求。
  • 间接表达相同目标的请求。
  • 复用先前结果中标识符的后续请求。
  • 需要授权或确认的写入操作。
  • 不受支持且不应调用工具的请求。

针对每个请求,记录所选工具、调用参数、结果、错误以及确认流程。每次更改工具名称、描述、模式或注解后,都要重新运行这组测试。

如果服务器返回可选的界面,请同时测试界面组件和模型可读取的结果。

通过 API Playground 测试

要查看原始请求和响应日志,请打开 API Playground:

  1. 依次选择工具 → 添加 → MCP 服务器。
  2. 输入 HTTPS 端点并建立连接。
  3. 运行测试提示词,检查请求和响应数据。

刷新元数据

更改工具名称、描述、模式、注解、身份验证配置或界面资源后,请按以下步骤操作:

  1. 部署或重启 MCP 服务器。
  2. 在 ChatGPT 插件页面打开相应的连接。
  3. 选择刷新。
  4. 确认服务器提供的元数据已更新。
  5. 开始新对话,重新运行受影响的测试。

此刷新流程适用于直接在 ChatGPT 中连接的自定义 MCP 服务器。已发布插件的工具更新采用持续审核流程。如果更改已提交的插件信息或已导入的技能,仍须创建新版本,提交审核并发布。

打包插件前,请确认以下各项:

  • 工具列表与文档所述功能一致。
  • 结构化结果符合各工具声明的输出模式。
  • 身份验证失败时会返回有助于排查问题的错误信息。
  • 对于应调用工具的提示词,会选中预期工具。对于不应调用工具的提示词,则不会选中工具。
  • 可选界面能正常渲染,控制台没有报错,界面状态也能正确恢复。

测试完整插件

确认 MCP 服务器正常工作后,请打包完整插件,并从本地来源安装。如果插件只包含技能,可以直接执行以下步骤:

  1. 打包插件时,请包含技能、清单以及 MCP 服务器连接(如适用)。
  2. 将插件添加到本地插件市场,然后从插件目录安装。
  3. 启用插件并开始新对话。
  4. 从插件的用例列表中选取有代表性的请求并运行。

创建评估集,涵盖以下情况:

  • 应使用某项技能的直接请求。
  • 间接表达相同目标的请求。
  • 依赖先前结果的后续请求。
  • 不应使用插件的反例请求。
  • 插件在设计上明确不支持的边界情况。

针对每个请求,检查插件是否遵循技能指令、使用预期资源、完成所有必要步骤并给出有用的结果。记录任何步骤遗漏、不必要的触发或结果不一致的情况。

如果插件包含 MCP 服务器,还要确认技能能调用正确的工具,工具结果能返回到工作流中,安装后身份验证能正常工作,并且用户能从头到尾完成每个结合技能与工具的工作流。

提交前,请确认以下各项:

  • 每项技能都能在收到预期请求时触发。
  • 措辞相近的请求会产生一致的行为。
  • 不受支持的请求不会触发插件。
  • 安装后能找到随插件打包的文件,并能正确解析引用。
  • 插件提供的入门提示词对应的是插件能够完成的工作流。
  • 如果插件包含 MCP 服务器,随插件打包的技能和工具能够按预期配合使用。