Connect an AI client with MCP

Open your account Settings and choose MCP clients. The page lists the AI apps you have connected. If you have none yet, it shows “No clients connected”.

Click Add client. In the Add an MCP client dialog:

• Client: pick your AI app. The choices are Claude Code, Claude Desktop / claude.ai, Codex CLI, Cursor (desktop), Cursor (web / cloud agents), VS Code / Copilot and Other client. A hint under the list tells you what that app needs.
• Name: a name to help you recognize this client later, for example “Claude Code on my laptop”. It starts as the app’s name. Use up to 60 characters.
• Sign-in port (Claude Code only): the port Claude Code listens on during sign-in. The default is 8791. You pass the same port to Claude Code in the next step.
• Sign-in return URL (Other client only): the exact address your app returns to after sign-in. Check your app’s documentation for it.

If you use Cursor both on your computer and on the web, add a client for each.

Click Add client.

The dialog now says your client is ready. It shows two things:

• Client ID: the ID your app uses to sign in. There is no secret key. The client ID is all your app needs.
• Setup: the exact instructions for your app, with your server address and client ID already filled in.

Click Copy to copy the setup, then click Done. You can find the client ID again later on the client’s own page.

What you do with the setup depends on your app. The server address always ends in /api/mcp, for example https://mail.example.com/api/mcp.

claude mcp add --transport http \
  --client-id YOUR-CLIENT-ID \
  --callback-port 8791 \
  metis-suite https://mail.example.com/api/mcp

codex mcp add metis-suite \
  --url https://mail.example.com/api/mcp \
  --oauth-client-id YOUR-CLIENT-ID

{
  "mcpServers": {
    "metis-suite": {
      "url": "https://mail.example.com/api/mcp",
      "auth": { "CLIENT_ID": "YOUR-CLIENT-ID" }
    }
  }
}

{
  "servers": {
    "metis-suite": {
      "type": "http",
      "url": "https://mail.example.com/api/mcp",
      "oauth": { "clientId": "YOUR-CLIENT-ID" }
    }
  }
}

When your app first connects, it opens a Metis Suite page in your browser. Sign in to Metis Suite if it asks you to. The page shows your app’s name and the words “wants access to your mail, calendars and drives”.

Read the two lists on the page:

• What it will never get: your password or any way to sign in as you, workspaces you hide from it and any workspace with AI turned off, mailboxes, calendars and drives that have AI turned off, and permission to change your AI settings, sharing or this app’s own access.
• It will be able to: which workspaces it can reach, which tools it can use, see your name and email address, and stay connected so you do not need to approve it each time.

Type your code in Two-factor code and click Approve. The app stays connected even after you sign out of Metis Suite. If you do not want to connect after all, click Deny.

Go back to your app and ask it something, for example “What needs my attention in my inbox?”. Each request runs inside one workspace, so the app first finds your workspaces and then works in the one you mean.

Back on the MCP clients page, your client now shows when it was last used.