Skip to main content

Overview

ChatGPT connects to remote MCP servers as custom MCP servers, added from Plugins and saved as a plugin. It registers itself with StackOne and runs the OAuth flow, so the URL is the whole configuration. Add the server in a browser at chatgpt.com/plugins. What you create belongs to your ChatGPT account or workspace, and the desktop app picks it up from there once it exists.
Adding a custom MCP server no longer requires Developer mode. Account and workspace policies still apply, so in a Business, Enterprise, or Edu workspace an admin may need to allow custom MCP servers first. The menu labels change often, so see OpenAI’s Connect and test your plugin guide for the current flow.

Prerequisites

  • A StackOne project you are a member of.
  • A connector profile in the project for each provider the client should reach, with the actions you want exposed enabled.
  • (Optional) A linked account for each provider. Accounts can also be linked during the consent flow.

Setup

1

Add the custom MCP server

  1. Go to ChatGPT Plugins.
  2. Select +, then Add custom MCP server.
  3. Enter a name and description, for example StackOne.
  4. Under Connection, enter the MCP server URL:
  5. Set authentication to OAuth. ChatGPT discovers the endpoints and registers itself, so leave the client ID and secret empty. No mcp-remote wrapper needed.
  6. Review the risk warning and select I understand and want to continue.
  7. Select Create as a plugin.
If Add custom MCP server is missing from the menu, a policy on your account or workspace is blocking it. In a Business, Enterprise, or Edu workspace, ask a workspace admin or owner to allow custom MCP servers for your role. On a personal plan, check OpenAI’s Connect and test your plugin guide for current availability.
2

Approve the consent screen

ChatGPT opens StackOne in your browser.Sign in, pick the project and the linked accounts the connector should reach, then Authorize.
Back in ChatGPT, review the tools it discovered, then install the plugin.
3

Share it with your workspace

The plugin is yours as soon as it is installed. Sharing it with everyone else depends on your plan.
Not applicable. A personal account has no workspace to publish to. Skip to the next step.
4

Use it in a chat

Start a new chat, type @, select the StackOne plugin, and try:
The plugin works in the ChatGPT desktop app as well as the browser. It is not available on mobile.
OpenAI asks you to confirm that an OAuth provider issues refresh tokens. StackOne advertises offline_access in its discovery metadata and issues them, so ChatGPT renews access on its own. Nothing to configure.

Keeping the tool list current

ChatGPT works from a snapshot of the tools StackOne exposed when the server was added. Changing what StackOne exposes, by authorizing another linked account or enabling more actions on a connector profile, does not reach ChatGPT until the snapshot is refreshed:
  • A server you added yourself. Open it at ChatGPT Plugins and select Refresh.
  • An app an admin published to a workspace. Enterprise and Edu admins refresh from the ellipsis menu next to the app under Workspace Settings → Apps. Business plans cannot refresh a published app, so it has to be created and published again.
Advanced Tool Search sidesteps most of this. It replaces the per-action tool list with two stable tools, Search and Execute, so the snapshot holds however the underlying grant changes. To change which accounts or actions ChatGPT can reach, re-run the OAuth flow. To revoke it, use Connected Apps in the StackOne dashboard.
A session token URL carries its own credential, so it covers the cases OAuth can’t: a shared server, a scheduled job, or anywhere nobody is present to approve a consent screen. For a comparison of each connection method, see Choosing a connection method.From the StackOne dashboard, go to Connectors, open a connector, then click Use in Agent.
  1. Pick a linked account.
  2. Set the expiry (one year by default).
  3. Select HTTPS MCP and copy the URL. It should be in the format of:
This URL covers one linked account, and anyone holding it has that access until it expires, so treat it like a password.To enable Advanced Tool Search, add the tool-mode query parameter to the URL:
Paste the token URL as the MCP server URL and set authentication to No Authentication. One server then covers one linked account.

Optimize and secure

With your agent connected, use StackOne’s platform features to optimize performance and secure every call.

Advanced Tool Search

Reduce context and save tokens.

Deep Query

Search synced records for a fraction of the tokens.

Defender

Block prompt injections before they reach your agent.