ChatGPT MCP:如何添加自定义 MCP 服务器(2026 年 10 月)
ChatGPT MCP 2026 年 10 月最新指南:把远程 MCP 服务器添加为插件,选择 OAuth 或无认证,处理写操作审批,连接私有服务器,并排查常见错误。
ChatGPT 支持 MCP 吗?
支持。截至 2026 年 10 月,ChatGPT 通过插件连接 MCP 服务器:在 chatgpt.com 打开 Plugins(插件),点击加号按钮,选择 Add custom MCP server(添加自定义 MCP 服务器),填入远程 HTTPS 地址和对应的认证方式,然后选择 Create as a plugin(创建为插件)并安装。ChatGPT 同时支持服务器提供的读工具和写工具,但它只能连接远程服务器(SSE 或 streamable HTTP)——本地 stdio 服务器需要借助隧道,或者使用 ChatGPT 桌面应用中的 Codex。
短短十八个月里,这个功能已经改了好几次名字——先是 connectors,后来是 apps 和"developer mode",现在叫 plugins——所以很多在"chatgpt mcp"关键词下排名靠前的教程,描述的菜单早已不存在。本指南以 OpenAI 当前的 Add custom MCP server 和 插件快速入门 文档为准。
ChatGPT 的 MCP 支持是如何演变的
| 时间 | 当时的名称 | 能做什么 |
|---|---|---|
| 2025 | Connectors | 主要是只读的 search 和 fetch,多用于深度研究 |
| 2025 年末 | Apps + Developer mode | 打开 Developer mode 开关后可使用完整的读写 MCP 工具;Apps SDK 增加了 UI 能力 |
| 2026 | Plugins | ChatGPT 与 Codex 共用一个插件目录;自定义 MCP 服务器会变成个人插件或工作区插件 |
有两点始终没变:ChatGPT 通过网络与 MCP 服务器通信,而且 OpenAI 不会审核你自行添加的自定义服务器。如今一个插件可以打包一个 MCP 服务器、skills(可复用的指令),或者两者兼有。你自己添加的 MCP 服务器会被转成一个只有你——或你的工作区——能看到的插件。
谁可以添加自定义 MCP 服务器?
OpenAI 开发者文档指出,添加自定义服务器需要在 ChatGPT 网页版中进行,并且会受到工作区权限和安全限制(包括 Lockdown)的约束。各套餐的规则是变化最频繁的部分,因此请把下表当作参考起点,并以你自己的 Plugins 页面为准:
| 账户类型 | 自定义 MCP 服务器 |
|---|---|
| Free | 通常不可用 |
| Plus / Pro | 可用性随套餐和灰度发布而变化;早期 Pro 仅限 read 和 fetch 工具 |
| Business | 可以——创建并发布到工作区仅限管理员和所有者 |
| Enterprise / Edu | 可以,受工作区角色(RBAC)和应用权限管控 |
在 Business、Enterprise 或 Edu 工作区中,管理员还可以把某个连接限制为只读操作或一组经过批准的操作,并决定 ChatGPT 在什么情况下必须先征求确认再使用它。如果你看不到 Add custom MCP server,通常是工作区策略所致,而不是 bug。
分步教程:向 ChatGPT 添加远程 MCP 服务器
你需要一个可以通过公网 HTTPS 地址访问的 MCP 服务器,地址通常以 /mcp 结尾。如果只是想体验一下流程,OpenAI 快速入门使用了一个公开的演示服务器,它提供一个只读的 roll_dice 工具,且无需认证:https://tinymcp.dev/api/moldy-aloof-zettabyte/mcp。
- 在 ChatGPT 网页版中进入 Plugins。
- 点击 plus(加号)按钮,然后选择 Add custom MCP server。
- 填写名称,描述可选。
- 在 Connection(连接)下,粘贴包含
/mcp路径的 Server URL(服务器地址)。如果是私有服务器,则改选 Tunnel(隧道)(见下文)。 - 选择 Authentication(认证):OAuth、No authentication(无认证),或"OAuth or no authentication"(混合模式)。
- 阅读风险提示,选择 I understand and want to continue(我已了解并希望继续)。
- 选择 Create as a plugin。ChatGPT 会建立连接,并列出它发现的工具。
- 打开你的个人插件,进入刚创建的插件,点击 plus 按钮将其安装。
- 新建一个对话,在输入框中键入 @ 并选择该插件。
OpenAI 快速入门是在 Work(工作)模式下测试插件的(即 ChatGPT 首页顶部的 Chat/Work 切换),但已安装的插件在 Chat 和 Work 中都可以使用。
认证选项
- No authentication ——适用于公开、只读的服务器,例如文档搜索或 DeepWiki。
- OAuth ——适用于任何涉及用户账户的服务器。如果你填写了静态客户端凭据,ChatGPT 会直接使用;否则,在你的授权服务器支持的情况下,它可以通过 Client ID Metadata Documents(CIMD)或 Dynamic Client Registration(DCR)自行注册。服务器开发者应遵循 MCP 授权规范。
- Mixed(混合)——
initialize和工具列表在无认证的情况下运行,之后每个工具按照其元数据中的安全方案使用 OAuth 或无认证。
这个流程中没有可以填写原始 API key 请求头的字段。如果某个服务器只接受静态 key,可以在它前面加一层 OAuth 或代理,或者改用支持 bearer token 的 Codex。
在对话中使用 MCP 工具
ChatGPT 根据工具的名称和描述来选择工具,因此当多个插件功能重叠时,明确的提示词效果最好:
- 指明插件和工具:使用 Acme CRM 插件的 update_record 工具来……
- 排除其他选项:不要使用网页搜索,只使用 Acme CRM。
- 给出执行顺序:先调用 read_file,再用修改后的内容调用 write_file。
写操作需要审批。 ChatGPT 遵循 MCP 的 readOnlyHint 注解;没有该注解的工具都会被视为写操作,默认会请求确认。在批准之前,你可以展开每次工具调用,查看完整的 JSON 输入和输出。"记住批准"只对当前对话有效。自 2026 年 6 月起,你还可以设置已连接应用何时请求权限——始终询问、在做出更改前询问,或仅在重要更改前询问——而 Business 和 Enterprise 的管理员可以设定工作区默认值。
刷新工具。 ChatGPT 会缓存工具列表。在服务器端修改工具名称、描述或 schema 之后,打开插件详情页并选择 Refresh(刷新),然后新建一个对话。在同一页面上,你还可以单独启用或停用某个工具。
连接本地或私有 MCP 服务器
ChatGPT 的服务器无法访问 localhost 或你的办公网络。你有三种选择:
- Secure MCP Tunnel —— OpenAI 官方支持的方式。在 Platform 设置中创建一个隧道,在你的网络内运行
tunnel-client(它只需要能出站访问api.openai.com:443的 HTTPS),然后在 Connection 下选择 Tunnel。它适用于防火墙后的 stdio 或 HTTP 服务器。详见 Secure MCP Tunnel。 - 临时 HTTPS 转发服务 ——适合开发测试,不适合任何需要分享给他人的场景。
- ChatGPT 桌面应用中的 Codex —— Codex 运行在你的本机上,可以直接通过
~/.codex/config.toml启动 Filesystem 或 Playwright 等本地 stdio 服务器。网页版的托管 ChatGPT 对话不会读取这个文件。参见我们的 Codex MCP 配置指南。
如果想把一整套本地服务器统一放在一个远程端点之后,常见做法是使用网关(例如我们 Docker MCP Gateway 指南中介绍的那种)再加上一个隧道。
值得在 ChatGPT 中尝试的远程服务器
| 服务器 | 认证 | 用途 |
|---|---|---|
| Notion | OAuth | 搜索和更新工作区页面 |
| Linear | OAuth | 在聊天中创建和分类 issue |
| Sentry | OAuth | 把错误详情拉进调试对话 |
| Zapier | 按账户 | 触发数千种应用操作 |
| DeepWiki | 无 | 针对公开 GitHub 仓库提问 |
在添加任何一个之前,先看看 Plugins 目录里是否已经有官方插件。官方插件经过 OpenAI 审核,通常还会在服务器之外附带 skills。
自己动手构建:Apps SDK 现在叫"Plugins"
如果你是要构建而不是连接,原来的 Apps SDK 文档现在位于 Plugins 下。核心依然是一个基于 streamable HTTP 的 MCP 服务器。自 2026 年 2 月起,ChatGPT 完全兼容开放的 MCP Apps 规范来提供可选 UI,因此服务器返回的交互组件也能在其他 MCP Apps 宿主中使用。ChatGPT 还会在初始化时读取 MCP 的 instructions 字段——请确保前 512 个字符可以独立成立、自成一体。
如果想在 ChatGPT 之外快速测试,可以用 MCP Inspector 列出并调用工具,或者使用 Responses API,它可以把任意远程服务器作为工具接入:
curl https://api.openai.com/v1/responses \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-d '{
"model": "gpt-6-astra",
"tools": [{
"type": "mcp",
"server_label": "openai_docs",
"server_url": "https://developers.openai.com/mcp",
"require_approval": "never"
}],
"input": "Search the OpenAI docs for Responses API streaming."
}'
公开分发需要通过插件提交门户,并且需要一个稳定的公网 HTTPS 端点。带有本地 stdio 服务器的插件会被标记为 Desktop only(仅限桌面端),只能在 ChatGPT 桌面应用中安装,目前仅向经过批准的合作伙伴开放。
限制与故障排查
- 没有"Add custom MCP server"按钮。 你的套餐或工作区策略不允许。请联系工作区管理员,或确认你当前处于个人账户还是工作区账户。
- 创建时提示"Couldn't connect"。 用 MCP Inspector 验证 URL,确认
/mcp路径无误,并确保你的代理或 CDN 不会缓冲流式响应。 - 没有列出任何工具。 服务器可以访问,但
tools/list没有返回任何内容;请检查服务器日志和 schema 错误。 - 401 循环。 返回一个指向你的
/.well-known/oauth-protected-resource元数据的WWW-Authenticate响应头,让 ChatGPT 知道需要重新发起 OAuth。 - 新工具没有出现。 在插件上选择 Refresh,然后新建一个对话。
- 选错了工具。 用"Use this when…"(在……时使用)式的指引重写工具描述,并拆分功能重叠的工具——参见 MCP 工具发现的工作原理。
- 安全。 自定义服务器未经 OpenAI 验证。恶意服务器可能窃取聊天数据或注入指令,因此请阅读 MCP 安全最佳实践,并保持写操作审批开启。
下一步
浏览 MCP 服务器目录,寻找提供远程 HTTPS 端点的服务器;按 分类 筛选;并比较其他 MCP 客户端 是如何连接这些服务器的。
常见问题
可以把本地 MCP 服务器连接到 ChatGPT 吗?
- 不能直接连接。ChatGPT 只通过 HTTPS 连接远程 MCP 服务器,本地服务器需要借助 OpenAI 的 Secure MCP Tunnel 或其他 HTTPS 转发服务。ChatGPT 桌面应用里的 Codex 则可以直接从 ~/.codex/config.toml 启动本地 stdio 服务器。
在 ChatGPT 中添加 MCP 服务器还需要开启开发者模式吗?
- OpenAI 当前文档描述的流程是在 Plugins 页点击加号,选择 Add custom MCP server,没有单独开启开发者模式的步骤。但这个选项是否出现,仍取决于你的套餐和工作区策略。
哪些 ChatGPT 套餐支持自定义 MCP 服务器?
- Business、Enterprise 和 Edu 工作区支持自定义 MCP 服务器,由管理员和工作区角色控制。Free 账号一般无法添加,Plus 和 Pro 的可用性曾多次变化,请以你自己 Plugins 页面显示的为准。
ChatGPT 的 MCP 工具能修改数据,而不只是读取吗?
- 可以。ChatGPT 支持自定义 MCP 服务器的读写工具。没有 readOnlyHint 注解的工具会被视为写操作,执行前会请求你确认。