How to Add a Custom MCP Server to ChatGPT
Custom MCP servers reach ChatGPT from the Plugins page on the web, and the current flow has no Developer Mode toggle. Which plans OpenAI documents for full MCP and which for read-only connections, the exact add path, Secure MCP Tunnel for private servers, and why saves can fail while lookups work.
Last verified November 15, 2026
How do I add a custom MCP server to ChatGPT?
On the web, open Plugins, select Add (the plus button), choose Add custom MCP server, paste the server's URL, set authentication to OAuth for a hosted server, accept the risk warning, and select Create as a plugin. Install the plugin, then @-mention it in a new chat. Two things decide what you get from it: your plan sets whether the server's write tools are available, and the whole flow is web only.
What plan you need, and what it gets you
As of November 2026, OpenAI's help centre article "Connecting custom MCP servers in ChatGPT" says:
- Business, Enterprise, and Edu: full MCP support, including write and modify actions. On Business, only admins and owners can create and publish plugins for custom MCP servers. On Enterprise and Edu, admins and owners create and test connections, role-based access control can grant selected members the Create plugins with MCPs permission, and only admins and owners publish.
- Pro: OpenAI's words are "Pro users can connect custom MCP servers with read/fetch permissions" and full MCP "is only available to Business and Enterprise/Edu users, currently."
- Plus: not mentioned in the article at all. OpenAI's pricing page lists Developer mode (beta) and Create & share Plugins as included on Plus and Pro, but neither row says what a custom MCP server can do there. If you see Add custom MCP server on a Plus account, try it. Treat lookups as the dependable part and saves as something to test.
- Free and Go: not mentioned either. The pricing page lists Developer mode (beta) as unavailable on both, and plugin creation as unavailable on Free.
So a connection where lookups work and saves do not run is usually OpenAI's plan permission, not a broken integration. There is one separate cause to rule out first: ChatGPT asks you to confirm write actions by default. OpenAI treats any tool without the readOnlyHint annotation as a write action, and you can choose to remember your approve or deny answer for a given tool for the rest of that conversation. A pending confirmation looks a lot like a save that silently failed.
Adding the server
- Log in to ChatGPT on the web
- Open Plugins from the sidebar (or go to
chatgpt.com/plugins) - Select Add (the plus button), then Add custom MCP server
- Enter a name and, optionally, a description
- Under Connection, enter your server's public HTTPS MCP endpoint URL, including the
/mcppath. For a server on a private network, select Tunnel instead and choose a Secure MCP Tunnel (see below) - Configure authentication for the server. OpenAI lists OAuth, no authentication, and a mixed "OAuth or no authentication" option. A hosted MCP server with accounts uses OAuth
- Review the risk warning and select I understand and want to continue
- Select Create as a plugin, then review the tools and metadata ChatGPT discovered from the server
Don't see Add custom MCP server? Work down this list before concluding the feature is missing:
- Confirm you are on ChatGPT web, not the mobile app.
- In a Business workspace, only admins and owners can create plugins for custom MCP servers. On Enterprise and Edu, you need the Create plugins with MCPs permission, which an admin grants through role-based access control.
- Check your plan against the list above. Pro is documented for read and fetch connections; Plus is not documented either way.
- OpenAI's pricing page still lists a Developer mode (beta) feature on Plus and Pro. Earlier in 2026 OpenAI documented its toggle under Settings → Security and login; the current setup docs don't require it, so look there only if the Add menu lacks the option.
- OpenAI's Lockdown security setting and workspace policies also apply to adding and using custom MCP servers.
The older path is now "legacy". OpenAI's help centre still describes a legacy custom app configuration: Workspace settings → Apps → Create (or Settings → Apps → Create for authorized users), provide the endpoint, pick authentication, select Scan Tools, complete the OAuth prompt, then Create. A legacy draft appears under Workspace Settings → Apps → Drafts, or under Settings → Apps → Enabled Apps with a Dev label. Admins reach those apps from the Admin console under Plugins → Manage Legacy Apps. If your workspace still shows that path, it works, but the Plugins path above is the one OpenAI documents as current.
Authorization
With OAuth selected, ChatGPT prompts you to authenticate: a browser window opens with the server's authorization page, you sign in if prompted, review the permissions, and approve. You are redirected back to ChatGPT with the connection active.
One thing OpenAI calls out for server builders: if the OAuth provider doesn't issue refresh tokens (the offline_access scope for OpenID Connect providers), ChatGPT may lose access once the original authorization expires, and you would need to reauthenticate. If a connection that worked stops working after a while, reconnect it under Settings → Plugins.
Using it in a conversation
- Install the resulting plugin. OpenAI says to find it in your personal plugins, or in the workspace where you created it
- Start a new conversation
- Type @ in the prompt box and select the plugin, or select + and choose it from the menu. Some interfaces put additional options under More
Selecting the plugin applies to the message you send with it, and you don't need to reselect it to discuss results already in the chat. @-mention it again when a follow-up needs new data or another action. Deep research can use custom servers for read and fetch actions only, not writes, and company knowledge only includes servers with search and fetch tools.
Search and fetch tools are no longer required for a connected server. Any tool the server exposes, including write actions, is available, subject to your plan's permissions and the confirmation settings above.
Secure MCP Tunnel, for private or local servers
ChatGPT connects to remote servers only, so it can't reach localhost directly. For a server on a private network, on-premises, or on a developer machine, OpenAI's answer is Secure MCP Tunnel: an outbound-only connection from a host inside your network to an OpenAI-hosted endpoint, run by a tunnel-client process. In the add flow, choose Tunnel under Connection and select the tunnel. OpenAI notes that tunnels support private connections and testing, not public plugin submission. A hosted server with a public HTTPS endpoint doesn't need one.
What usually goes wrong
| Problem | Fix |
|---|---|
| Add custom MCP server is missing from the Add menu | Confirm you are on ChatGPT web. On Business, only admins and owners can create; on Enterprise and Edu, an admin grants the Create plugins with MCPs permission. Check the plan list above, and look for a Developer mode toggle under Settings → Security and login only as a last resort. |
| Saves don't run, lookups work | Usually the plan permission: full MCP including writes is documented for Business, Enterprise, and Edu, Pro is documented for read and fetch, and Plus is not documented either way. Also check for a pending write confirmation, which ChatGPT asks for by default. |
| The server is missing in deep research | OpenAI documents deep research as read and fetch only for custom servers. Use a normal chat for the full tool set. |
| Tools are stale after the server changed | In a workspace, ChatGPT uses a frozen snapshot of the server's tools until an admin refreshes the tool list and publishes the update. For a plugin you created yourself, open the connection at chatgpt.com/plugins and select Refresh. |
| Authorization doesn't complete, or access lapses later | Retry the sign-in from the plugin's settings. If access lapses after a while, reconnect under Settings → Plugins; OpenAI ties that to OAuth providers that don't issue refresh tokens. |
| Plugin not showing in chat | Install it first, start a new conversation, and type @ to select it. |
| Local server won't connect | ChatGPT can't reach localhost. Use a Secure MCP Tunnel, or a public HTTPS endpoint. |
A worked example
With a real server — Tempreon, a hosted MCP server that carries your context across every AI tool you connect:
Add it from Plugins with that URL, authentication set to OAuth, approve in the browser, install the plugin, and @-mention it in a new chat. The point of connecting a portable memory server here specifically is cross-provider reach: knowledge stored in a Claude session is available in ChatGPT and vice versa, with no manual syncing.
The account-holder walkthrough is in the ChatGPT setup doc.
Sources
The dated claims on this page were checked against these vendor documents. Client UIs move constantly, so if one of these has changed since the date shown, trust the vendor over this page — and tell us.
- Connecting custom MCP servers in ChatGPT — OpenAI Help Center — read 2026-11-15
- Connect and test your plugin — OpenAI developer docs — read 2026-11-15
- Add custom MCP server — OpenAI developer docs — read 2026-11-15
- Plugins in ChatGPT — OpenAI Help Center — read 2026-11-15
- Plans and Pricing — ChatGPT — read 2026-11-15
Frequently asked questions
- Do I need Developer Mode to add a custom MCP server to ChatGPT?
- Not in the current flow. OpenAI's help centre says to add a custom MCP server directly from Plugins, by selecting the plus button and then Add custom MCP server, and that you don't need to turn on Developer Mode first. You review and acknowledge a risk warning for each server instead. OpenAI's pricing page still lists a Developer mode (beta) feature on Plus and Pro, but its current setup docs don't route through it.
- Lookups work in ChatGPT but saves don't. Why?
- Usually the plan-level permission OpenAI documents. Full MCP support, including write actions, is documented for Business, Enterprise, and Edu workspaces. Pro accounts can connect custom MCP servers with read and fetch permissions. OpenAI's current article doesn't mention Plus, so treat saves there as something to test. ChatGPT also asks you to confirm write actions by default, so check for a pending confirmation before assuming a plan gate.
- Can I add a custom MCP server in the ChatGPT mobile app?
- No. OpenAI's help centre answers that custom MCP servers are web only. Add the server on chatgpt.com from a computer. OpenAI says to find the plugin you create in your personal plugins, or in the workspace where you created it, and to install it before using it in a chat.