---
title: "Connect Mailercloud to your AI app (Claude, ChatGPT, Perplexity, Cursor and more)"
description: "How to add the official Mailercloud MCP server to Claude, ChatGPT, Perplexity, Cursor, VS Code, Claude Code, Gemini CLI and Microsoft Copilot Studio, plus fixes for common problems."
url: https://help.mailercloud.com/en/articles/233-connect-mailercloud-to-your-ai-app-claude-chatgpt-perplexity-cursor-and-more
collection: "Mailercloud MCP"
updated: 2026-10-26
language: en
---

# Connect Mailercloud to your AI app (Claude, ChatGPT, Perplexity, Cursor and more)

How to add the official Mailercloud MCP server to Claude, ChatGPT, Perplexity, Cursor, VS Code, Claude Code, Gemini CLI and Microsoft Copilot Studio, plus fixes for common problems.

To connect Mailercloud to any AI app, add the official Mailercloud MCP server, `https://mcp.mailercloud.com/mcp`, as a custom connector and sign in with a Mailercloud API key. It works with Claude, ChatGPT, Perplexity, Cursor, VS Code with GitHub Copilot, Claude Code, Gemini CLI, Microsoft Copilot Studio and any other app that supports remote MCP servers.

_Last updated: 26 October 2026_

## How do I connect Mailercloud to an AI app?

1.  **Create an API key.** In Mailercloud, go to Settings > API Keys, create a key named after the app (for example "Claude") and copy it. You only see it once.
    
2.  **Add the connector.** In your AI app, add a custom connector (also called an MCP server or app) named Mailercloud with the URL https://mcp.mailercloud.com/mcp.
    
3.  **Sign in.** Click Connect, paste your API key on the Mailercloud sign-in page and click Connect. Then ask: "What can you do with my Mailercloud account?"
    

## Step-by-step guide for each app

-   [How to connect Mailercloud to Claude](https://help.mailercloud.com/en/articles/236-how-to-connect-mailercloud-to-claude.md) (claude.ai, desktop, mobile, Team and Enterprise)
    
-   [How to connect Mailercloud to ChatGPT](https://help.mailercloud.com/en/articles/237-how-to-connect-mailercloud-to-chatgpt.md)
    
-   [How to connect Mailercloud to Perplexity](https://help.mailercloud.com/en/articles/238-how-to-connect-mailercloud-to-perplexity.md)
    
-   [How to connect Mailercloud to Cursor, VS Code, Claude Code and Gemini CLI](https://help.mailercloud.com/en/articles/239-how-to-connect-mailercloud-to-cursor-vs-code-claude-code-and-gemini-cli.md)
    
-   [How to connect Mailercloud to Microsoft Copilot Studio](https://help.mailercloud.com/en/articles/240-how-to-connect-mailercloud-to-microsoft-copilot-studio.md)
    

## Where do I add Mailercloud in each app?

<table style="min-width: 75px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><td colspan="1" rowspan="1"><p><strong>App</strong></p></td><td colspan="1" rowspan="1"><p><strong>Where to add it</strong></p></td><td colspan="1" rowspan="1"><p><strong>Plans</strong></p></td></tr><tr><td colspan="1" rowspan="1"><p>Claude (web, desktop, mobile)</p></td><td colspan="1" rowspan="1"><p>Customize &gt; Connectors &gt; + Add &gt; Add custom connector. Team/Enterprise owners: Organization settings &gt; Connectors.</p></td><td colspan="1" rowspan="1"><p>Free (1 custom connector), Pro, Max, Team, Enterprise</p></td></tr><tr><td colspan="1" rowspan="1"><p>ChatGPT (web)</p></td><td colspan="1" rowspan="1"><p>Apps or connectors settings &gt; add a custom MCP server (some plans: switch on Developer mode first). Use it via + or @Mailercloud.</p></td><td colspan="1" rowspan="1"><p>Paid plans; some read-only; admins may need to allow it</p></td></tr><tr><td colspan="1" rowspan="1"><p>Perplexity</p></td><td colspan="1" rowspan="1"><p>Connectors or plugins area &gt; add a custom connector, choose OAuth.</p></td><td colspan="1" rowspan="1"><p>May need a paid plan</p></td></tr><tr><td colspan="1" rowspan="1"><p>Cursor</p></td><td colspan="1" rowspan="1"><p>Add to ~/.cursor/mcp.json: <code>{"mcpServers": {"mailercloud": {"url": "https://mcp.mailercloud.com/mcp"}}}</code></p></td><td colspan="1" rowspan="1"><p>Use in Agent mode</p></td></tr><tr><td colspan="1" rowspan="1"><p>VS Code (GitHub Copilot)</p></td><td colspan="1" rowspan="1"><p>Command Palette &gt; MCP: Add Server &gt; HTTP &gt; enter the URL.</p></td><td colspan="1" rowspan="1"><p>Copilot with agent mode</p></td></tr><tr><td colspan="1" rowspan="1"><p>Claude Code</p></td><td colspan="1" rowspan="1"><p><code>claude mcp add --transport http mailercloud https://mcp.mailercloud.com/mcp</code>, then /mcp to sign in.</p></td><td colspan="1" rowspan="1"><p>Any Claude Code plan</p></td></tr><tr><td colspan="1" rowspan="1"><p>Gemini CLI</p></td><td colspan="1" rowspan="1"><p><code>gemini mcp add --transport http mailercloud https://mcp.mailercloud.com/mcp</code>, then /mcp auth mailercloud.</p></td><td colspan="1" rowspan="1"><p>Needs a browser to sign in</p></td></tr><tr><td colspan="1" rowspan="1"><p>Microsoft Copilot Studio</p></td><td colspan="1" rowspan="1"><p>Agent &gt; Tools &gt; Add a tool &gt; New tool &gt; Model Context Protocol; API key or OAuth.</p></td><td colspan="1" rowspan="1"><p>Copilot Studio licence</p></td></tr></tbody></table>

AI apps change their menus often. If a step doesn't match what you see, follow the app's own guide: [Claude](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp), [ChatGPT](https://developers.openai.com/apps-sdk/deploy/connect-chatgpt), [Perplexity](https://www.perplexity.ai/help-center/en/articles/11502712-local-and-remote-mcps-for-perplexity), [Cursor](https://cursor.com/docs/context/mcp), [VS Code](https://code.visualstudio.com/docs/copilot/customization/mcp-servers), [Gemini CLI](https://geminicli.com/docs/tools/mcp-server), [Copilot Studio](https://learn.microsoft.com/en-us/microsoft-copilot-studio/mcp-add-existing-server-to-agent).

## Can I sign in with an API key header instead of OAuth?

Yes. Tools that let you set headers can send the Mailercloud API key directly in the Authorization header (or X-API-Key). For example, in Cursor: `{"mcpServers": {"mailercloud": {"url": "https://mcp.mailercloud.com/mcp", "headers": {"Authorization": "YOUR_API_KEY"}}}}`. Keep the key out of shared or committed files.

## Mailercloud isn't connecting. What should I check?

<table style="min-width: 50px;"><colgroup><col style="min-width: 25px;"><col style="min-width: 25px;"></colgroup><tbody><tr><td colspan="1" rowspan="1"><p><strong>What you see</strong></p></td><td colspan="1" rowspan="1"><p><strong>What to do</strong></p></td></tr><tr><td colspan="1" rowspan="1"><p>The sign-in page doesn't open</p></td><td colspan="1" rowspan="1"><p>Allow pop-ups for your AI app's website and click Connect again.</p></td></tr><tr><td colspan="1" rowspan="1"><p>"Invalid API key" or the connection fails</p></td><td colspan="1" rowspan="1"><p>Create a new key under Settings &gt; API Keys and connect again. Check the URL is exactly https://mcp.mailercloud.com/mcp, including /mcp at the end.</p></td></tr><tr><td colspan="1" rowspan="1"><p>The assistant doesn't use Mailercloud</p></td><td colspan="1" rowspan="1"><p>Switch the connector on in this chat, or start your message with "Using Mailercloud, ...".</p></td></tr><tr><td colspan="1" rowspan="1"><p>It worked before and suddenly stops</p></td><td colspan="1" rowspan="1"><p>The API key may have been deleted. Create a new key and connect again.</p></td></tr><tr><td colspan="1" rowspan="1"><p>Wrong Mailercloud account</p></td><td colspan="1" rowspan="1"><p>The connector uses the account the API key belongs to. Reconnect with a key from the right account.</p></td></tr><tr><td colspan="1" rowspan="1"><p>Cursor: "too many tools"</p></td><td colspan="1" rowspan="1"><p>Switch off the Mailercloud tools you don't need in Cursor's MCP settings.</p></td></tr></tbody></table>

## How do I disconnect Mailercloud?

Remove the connector in your AI app, then delete the API key under Settings > API Keys in Mailercloud. Deleting the key stops all access through it immediately.

More: [Mailercloud MCP server: the official guide](https://help.mailercloud.com/en/articles/232-mailercloud-mcp-server-official-guide-for-claude-chatgpt-and-other-ai-assistants.md) · [Everyday prompts](https://help.mailercloud.com/en/articles/234-everyday-ways-to-use-mailercloud-with-ai.md) · [Tool reference](https://help.mailercloud.com/en/articles/170-mailercloud-mcp-tool-reference-all-77-tools.md) · Help: [support@mailercloud.com](mailto:support@mailercloud.com)