IMMA AI Docs
MCP reference

Connect ChatGPT

Add the IMMA AI MCP server to ChatGPT as a custom connector and log in with OAuth.

Preview

Preview: the API and MCP server are in private beta; details may change. This is how connecting is planned to work; exact screens may shift before general availability.

Custom MCP apps in ChatGPT need Developer mode, and Developer mode is available to Pro, Plus, Business, Enterprise and Education accounts on the web; ChatGPT Free cannot add a custom connector. A custom connector's authentication can be OAuth, No Authentication, or Mixed, and ChatGPT cannot present custom API keys, so a pasted key or a custom Authorization header is not an option. IMMA AI's MCP server supports OAuth 2.1 for this reason: turn on Developer mode, add IMMA AI as a custom connector with the MCP URL, then sign in with OAuth, no key copying involved.

Prerequisites

  • A ChatGPT plan that supports Developer mode: Pro, Plus, Business, Enterprise or Education, on the web. ChatGPT Free does not have Developer mode.
  • An IMMA AI account with access to the workspace you want to connect.

Menu labels can change; if yours differ, follow the linked official guide.

Steps

  1. Turn on Developer mode: open Settings > Security and login, then toggle Developer mode on.
  2. Create the app: go to ChatGPT Plugins, click the + button, and create a developer-mode app for a remote MCP server:
    • URL: https://api.getimma.com/mcp
    • Authentication: OAuth
    • Supported transports are SSE and streaming HTTP.
  3. The app appears under Drafts in your app settings, where you can toggle and refresh its tools. Click Connect to sign in; you are redirected to IMMA AI's OAuth consent screen, which shows the workspace, your profile and the scopes being requested, then back to ChatGPT.
  4. To use it in a chat, open the + (Plus) menu in the composer, choose Developer mode, and select the IMMA AI app.

Verify it worked

Once connected, ask ChatGPT:

Call list_accounts and tell me which social accounts are connected.

Common errors

SymptomCauseFix
Connector added but no tools appearRequested scopes on the OAuth grant do not cover any toolRe-authorize and confirm the requested scopes match what the connector needs
Authorization loop or redirect failsBrowser blocked a redirect, or popups are disabledAllow popups for chatgpt.com and retry
Consent denied or canceledYou closed the consent screen or clicked denyClick Connect again and complete the login
Wrong workspace connectedChose the wrong workspace on IMMA AI's consent screenDisconnect the connector and reconnect, picking the right workspace this time

Official docs

On this page