先逐项测试插件的功能,再测试安装后的完整插件。如果插件包含 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 服务器时,须遵守账号和工作空间的策略。
- 前往 ChatGPT 插件页面。
- 选择加号按钮,然后选择添加自定义 MCP 服务器。
- 输入向用户显示的名称和描述。
- 在连接下选择连接方式:
- 如果使用公共端点,请输入 MCP 服务器的 URL,其中应包含
/mcp路径。 - 如果使用安全 MCP 隧道,请选择隧道,然后选择一个可用的隧道或输入其
tunnel_id。
- 如果使用公共端点,请输入 MCP 服务器的 URL,其中应包含
- 配置身份验证,阅读风险提示,然后选择我已了解并希望继续。
- 选择创建为插件。
- 检查从服务器发现的工具和元数据。
如果 ChatGPT 无法连接,请使用 MCP Inspector 验证公共 HTTPS 端点,或检查隧道与工作空间的关联以及 tunnel-client 的状态。请先解决传输、初始化、模式或身份验证错误,再继续操作。
检查工具选择
安装刚创建的插件,然后开始新对话。在提示词输入框中输入 @ 并选择插件。创建评估集,涵盖以下情况:
- 应调用特定工具的直接请求。
- 间接表达相同目标的请求。
- 复用先前结果中标识符的后续请求。
- 需要授权或确认的写入操作。
- 不受支持且不应调用工具的请求。
针对每个请求,记录所选工具、调用参数、结果、错误以及确认流程。每次更改工具名称、描述、模式或注解后,都要重新运行这组测试。
如果服务器返回可选的界面,请同时测试界面组件和模型可读取的结果。
通过 API Playground 测试
要查看原始请求和响应日志,请打开 API Playground:
- 依次选择工具 → 添加 → MCP 服务器。
- 输入 HTTPS 端点并建立连接。
- 运行测试提示词,检查请求和响应数据。
刷新元数据
更改工具名称、描述、模式、注解、身份验证配置或界面资源后,请按以下步骤操作:
- 部署或重启 MCP 服务器。
- 在 ChatGPT 插件页面打开相应的连接。
- 选择刷新。
- 确认服务器提供的元数据已更新。
- 开始新对话,重新运行受影响的测试。
此刷新流程适用于直接在 ChatGPT 中连接的自定义 MCP 服务器。已发布插件的工具更新采用持续审核流程。如果更改已提交的插件信息或已导入的技能,仍须创建新版本,提交审核并发布。
打包插件前,请确认以下各项:
- 工具列表与文档所述功能一致。
- 结构化结果符合各工具声明的输出模式。
- 身份验证失败时会返回有助于排查问题的错误信息。
- 对于应调用工具的提示词,会选中预期工具。对于不应调用工具的提示词,则不会选中工具。
- 可选界面能正常渲染,控制台没有报错,界面状态也能正确恢复。
测试完整插件
确认 MCP 服务器正常工作后,请打包完整插件,并从本地来源安装。如果插件只包含技能,可以直接执行以下步骤:
- 打包插件时,请包含技能、清单以及 MCP 服务器连接(如适用)。
- 将插件添加到本地插件市场,然后从插件目录安装。
- 启用插件并开始新对话。
- 从插件的用例列表中选取有代表性的请求并运行。
创建评估集,涵盖以下情况:
- 应使用某项技能的直接请求。
- 间接表达相同目标的请求。
- 依赖先前结果的后续请求。
- 不应使用插件的反例请求。
- 插件在设计上明确不支持的边界情况。
针对每个请求,检查插件是否遵循技能指令、使用预期资源、完成所有必要步骤并给出有用的结果。记录任何步骤遗漏、不必要的触发或结果不一致的情况。
如果插件包含 MCP 服务器,还要确认技能能调用正确的工具,工具结果能返回到工作流中,安装后身份验证能正常工作,并且用户能从头到尾完成每个结合技能与工具的工作流。
提交前,请确认以下各项:
- 每项技能都能在收到预期请求时触发。
- 措辞相近的请求会产生一致的行为。
- 不受支持的请求不会触发插件。
- 安装后能找到随插件打包的文件,并能正确解析引用。
- 插件提供的入门提示词对应的是插件能够完成的工作流。
- 如果插件包含 MCP 服务器,随插件打包的技能和工具能够按预期配合使用。