How to Add Your Own MCP Server to ChatGPT

by Alexey Bogomolov

ChatGPT can talk to any remote MCP server you point it at. You do not need to publish anything or pass a review: you add the server by URL, and it becomes a private plugin that only you (or your workspace) can use. This guide shows where to add it, how to sign in, and how to use it in a chat.

OpenAI has renamed this feature several times (connectors, apps, plugins, "developer mode"), so the button labels may differ slightly from what you see. The flow stays the same. I wrote this from OpenAI's documentation and have not run every step in my own ChatGPT account, so tell me if a label has changed.

Before you start

  • A remote MCP server on public HTTPS. ChatGPT supports streaming HTTP and the older SSE transport. A server that only runs on your laptop is not reachable; OpenAI offers a Secure MCP Tunnel option for private servers.

  • To know the sign-in method. ChatGPT supports OAuth and no authentication.

  • Permission in your workspace. On Business, Enterprise and Education plans, an admin controls who may add custom servers. If you do not see the option, ask your admin. OpenAI's guide does not list which plans include custom servers, so check the help center for the current limits.

  • Trust. A custom server is not verified by OpenAI. Do not connect servers you do not trust: they can receive data from your chats and trigger actions.

Step by step

  1. Open chatgpt.com/plugins (ChatGPT on the web).

  2. Click the plus button and choose Add custom MCP server.

  3. Enter a name and, optionally, a description. The description helps ChatGPT decide when to use the server.

  4. Under Connection, enter the Server URL (or choose Tunnel for a private server behind a tunnel).

  5. Choose the authentication: OAuth, No authentication, or OAuth or no authentication (listing tools needs no sign-in, each tool then uses what its metadata declares).

  6. Read the risk warning and confirm with I understand and want to continue.

  7. Click Create as a plugin, then install it. It appears in your personal plugins or in the workspace where you created it, and it will not work in chats until it is installed.

If you chose OAuth, ChatGPT sends you through the server's sign-in. It uses static client credentials if you provide them; otherwise it can use Client ID Metadata Documents or Dynamic Client Registration, depending on what the server supports.

Use it in a chat

Open a new chat and type @, then pick your installed plugin from the list. Name the app and the tool you want, and say what not to use if there are alternatives:

Use the allclicks app. Which of my sites lost the most clicks in the last 28 days?

Custom servers can be used together with other apps in the same chat, subject to your workspace's permissions.

Read tools and write tools

ChatGPT looks at each tool's readOnlyHint annotation:

  • A tool marked read-only runs without a prompt.

  • A tool without the hint is treated as a write action, and ChatGPT asks for confirmation. You can approve or deny it for the rest of that conversation; a new conversation asks again.

So if you build a server, mark your read-only tools with readOnlyHint: true, and mark destructive ones with destructiveHint. It makes ChatGPT's prompts accurate and the app pleasant to use. Always read a write tool's input before approving.

You can turn individual tools on or off on the app's details page in settings.

Updating tools

ChatGPT remembers the tool list from when you added the server. After you change tool names, descriptions or the server's instructions, open the app's details page in settings and refresh it, then start a new chat. OpenAI recommends keeping the first 512 characters of the server's instructions self-contained.

When it fails

  • The server cannot be reached. It must be public HTTPS answering MCP at that exact URL. Test it with an MCP inspector first.

  • Sign-in fails. Check that your OAuth metadata is public, PKCE is on, and the server supports Dynamic Client Registration or Client ID Metadata Documents.

  • The option is missing. On workspace plans an admin has to allow custom servers; on others it depends on the plan.

  • ChatGPT never picks your app. Mention it with @ and name the tool. Short, descriptive tool names and descriptions help too.

  • Old tools in the list. Refresh the app.

Example: connecting allclicks

allclicks is a Search Console dashboard whose MCP server lives at https://app.allclicks.net/mcp. Add it as a custom MCP server with OAuth, sign in with Google and allow access, then type @allclicks in a chat. Ask for the sites that dropped this week, the queries that grew on one site, or whether a page is indexed. The full setup page is on allclicks.net.

For Claude, which has its own dialog and options, see how to add a custom connector to Claude.

More articles