连接自定义 MCP 服务器
将您的模型上下文协议(MCP)服务器作为插件连接到 ChatGPT。ChatGPT 支持服务器提供的读取和写入工具。
请仅连接您信任的 MCP 服务器。不可信的服务器可能会访问或窃取您在使用应用时共享的信息,也可能诱使 ChatGPT 以非预期的方式使用工具,例如更改或删除数据。连接服务器前,请先了解提示注入及其他风险。
使用方法
-
使用入口: 请在网页版 ChatGPT 中操作。添加和使用自定义 MCP 服务器时,均受工作空间权限和安全限制(包括锁定模式)的约束。
-
将 MCP 服务器添加为插件:
- 前往 ChatGPT 插件页面。
- 选择加号按钮,然后选择添加自定义 MCP 服务器。
- 输入名称,也可填写描述。在连接下输入您的服务器 URL,或选择隧道以使用安全 MCP 隧道。
- 为服务器配置身份验证。
- 阅读风险警告,然后选择我已了解并希望继续。
- 选择创建为插件。
- 支持的 MCP 协议包括 SSE 和流式 HTTP。
- 身份验证选项包括 OAuth、无需身份验证和 OAuth 或无需身份验证。
- 对于 OAuth,如果您提供了静态凭据,ChatGPT 就会使用这些凭据。否则,如果授权服务器声明支持客户端 ID 元数据文档(CIMD),且应用创建者选择了 CIMD,ChatGPT 就可以使用这类文档。CIMD 支持公共客户端令牌交换(
none),也支持使用已签名的客户端断言进行令牌交换(private_key_jwt)。如果配置了 DCR,ChatGPT 也可以使用 DCR。 - 混合身份验证同时支持 OAuth 和无需身份验证两种方式。初始化 API 和工具列表 API 无需身份验证,各工具则根据其元数据中设置的安全方案决定是否使用 OAuth。
- 对于 OAuth,如果您提供了静态凭据,ChatGPT 就会使用这些凭据。否则,如果授权服务器声明支持客户端 ID 元数据文档(CIMD),且应用创建者选择了 CIMD,ChatGPT 就可以使用这类文档。CIMD 支持公共客户端令牌交换(
- 您可以在个人插件列表或创建插件时所在的工作空间中找到该插件。请先安装插件,再在对话中使用。
-
管理工具: 在应用设置中,每个应用都有一个详情页。您可以在详情页启用或停用工具,也可以刷新应用,从 MCP 服务器获取新的工具、描述和服务器指令。
-
在对话中使用应用: 在提示词输入框中输入
@,然后选择您已安装的插件。在工作空间权限和安全限制允许的范围内,您可以将自定义 MCP 插件与其他应用搭配使用。您可能需要尝试不同的提示词写法,才能让 ChatGPT 调用正确的工具。例如:- 明确指定工具:
Use the "Acme CRM" app's "update_record" tool to …。必要时,请写明服务器标签和工具名称。 - 排除其他选项,避免歧义:“不要使用内置浏览功能或其他工具,只使用 Acme CRM 应用。”
- 区分相似的工具:“安排会议时优先使用
Calendar.create_event,不要使用Reminders.create_task安排日程。” - 指定输入格式和调用顺序:“先调用
Repo.read_file,传入{ path: "…" }。然后调用Repo.write_file,传入修改后的内容。不要调用其他工具。” - 如果多个应用的功能重叠,请在开头说明优先使用哪个应用,例如:“使用
CompanyDB获取权威数据。只有在CompanyDB未返回结果时,才使用其他来源。” - 自定义 MCP 服务器无需提供
search/fetch工具。您可以使用应用提供的所有工具(包括写入操作),具体取决于确认设置。 - 更多指导请参阅使用工具和编写提示词。
- 完善工具描述,帮助模型选择工具:在 MCP 服务器中,为工具编写能体现具体操作的名称和描述。用“在……时使用此工具”说明适用场景,注明禁止使用的情形和边界情况,并补充参数说明和枚举值。这样可以帮助模型在相似工具中选出合适的工具,并避免在不适合的场景中使用内置工具。
- 添加服务器指令,说明如何配合使用多个工具:使用 MCP 的
instructions字段提供适用于整个服务器的指引,例如必须遵循的工具调用顺序、工具共用的速率限制或工具之间的关系。请确保前 512 个字符单独阅读时也能表达完整的意思。
示例:
使用“Calendar.create_event”安排一次与 alice@example.com 和 bob@example.com 的会议, 时间定在太平洋时间明天下午 3 点,时长为 30 分钟。 不要使用任何其他日程安排工具。使用“GitHub.open_pull_request”创建一个从“feat-retry”分支合并到“main”分支的 pull request, 标题为“Add retry logic”,正文为“…”。 不要直接推送到 main 分支。 - 明确指定工具:
-
检查并确认工具调用:
- 检查工具调用的 JSON 数据,以验证调用是否正确并排查问题。展开每次工具调用的详情,即可查看工具输入和输出的完整 JSON 内容。
- 默认情况下,写入操作需要您确认。请仔细检查即将发送给写入工具的输入,确保操作符合您的预期。错误的写入操作可能会意外破坏、更改或共享数据!
- 识别只读工具:ChatGPT 会根据工具的
readOnlyHint注解判断工具是否为只读(请参阅 MCP 工具注解)。如果工具没有此注解,ChatGPT 会将其调用视为写入操作。 - 您可以让 ChatGPT 在当前对话中记住您对某个工具的批准或拒绝决定。本次对话中再次调用该工具时,ChatGPT 都会沿用这一决定。因此,只有在您了解并信任该工具所属的应用,愿意让它在无需您再次批准的情况下执行后续写入操作时,才应选择记住批准决定。开始新对话时,ChatGPT 会再次请求确认。刷新当前对话后,ChatGPT 也会在后续对话轮次中再次请求确认。