How to connect GoMarble MCP

Connect GoMarble to your AI assistant to work with your ad and analytics accounts from there. Every assistant uses the same server address. You sign in with your GoMarble account, so there's no API key to copy.

Server URL: https://apps.gomarble.ai/mcp-api/mcp

If you connected before using the older address ending in /mcp-api/sse, it still works in most assistants. We recommend switching to the address above. Codex only works with the new address.

Before you start

• Connect your ad and analytics platforms in GoMarble under Settings → Integrations. You can do this later, and the assistant will send you a link when it needs one.

• When your assistant opens the GoMarble sign-in page, use the same email as your GoMarble account.

• On team and company plans, an admin may need to add or allow GoMarble first. Each section below says when.

Quick reference

Claude (claude.ai, Claude Desktop and mobile)

1. Open claude.ai/customize/connectors. In Claude Desktop, click Customize in the sidebar, then Connectors.

2. Click +, then Add custom connector.

3. Name: GoMarble. URL: https://apps.gomarble.ai/mcp-api/mcp. Leave the advanced OAuth fields empty. If you're asked how to register, choose Register automatically.

4. Click Add, then Connect.

5. Sign in to GoMarble and choose what Claude can access (see below).

6. In a chat, click + → Connectors and make sure GoMarble is switched on.

Team and Enterprise: an owner first adds GoMarble under Organization settings → Connectors → Add → Custom → Web. Members then find GoMarble under Customize → Connectors and click Connect.

A connector you add on the web or desktop also shows up in the Claude mobile apps. The free plan allows one custom connector.

Claude Cowork

There's nothing extra to set up. Cowork uses the connectors switched on for your Claude account. Add GoMarble as described above and it's available in your Cowork tasks. Cowork needs a paid Claude plan.

Claude Code

Run this in your terminal:

claude mcp add --transport http --scope user gomarble https://apps.gomarble.ai/mcp-api/mcp

Then type /mcp in Claude Code, choose gomarble and sign in. You can also run claude mcp login gomarble from your terminal.

If you're signed in to Claude Code with the same account where you added GoMarble as a Claude connector, GoMarble already appears there. Don't add it twice, or you'll see every tool twice.

ChatGPT (Plus and Pro)

ChatGPT connects to GoMarble through developer mode, on the web only. ChatGPT is renaming Apps to Plugins, so you may see either name.

1. On chatgpt.com, open Settings → Security and login and turn on Developer mode. On some accounts it's under Settings → Apps → Advanced settings.

2. Open Plugins (or Apps) and click + or Create.

3. Name: GoMarble. Server URL: https://apps.gomarble.ai/mcp-api/mcp. Authentication: OAuth.

4. Create it, then sign in to GoMarble when asked.

5. In a chat, open the + menu, choose Developer mode and select GoMarble.

Depending on your plan, ChatGPT may only allow GoMarble's read tools. Full read and change support is on Business, Enterprise and Edu. ChatGPT asks you to confirm before GoMarble makes any change.

ChatGPT Business, Enterprise and Edu

Admin, one time:

1. Allow custom MCP apps for your workspace in Workspace settings → Permissions & roles. On Business, admins and owners can create apps. On Enterprise and Edu, grant the permission to the right roles.

2. Go to Workspace settings → Apps → Create. Enter GoMarble, the server URL above and OAuth.

3. Click Scan Tools, sign in to GoMarble, then click Create. The app is saved as a draft.

4. Test it in a chat, then publish it from Workspace settings → Apps → Drafts → Publish. On Enterprise and Edu you can choose which actions and groups it's available to before publishing.

Members: open Settings → Plugins (or Apps), select GoMarble, click Connect and sign in with your own GoMarble account.

ChatGPT keeps a snapshot of GoMarble's tools from when the app was published. When GoMarble adds or changes tools, an admin may need to refresh the app in workspace settings to pick them up.

Codex (CLI, IDE extension and ChatGPT desktop app)

CLI:

codex mcp add gomarble --url https://apps.gomarble.ai/mcp-api/mcp

Codex opens your browser to sign in to GoMarble. If it doesn't, run codex mcp login gomarble.

Or add it to ~/.codex/config.toml, then run codex mcp login gomarble:

[mcp_servers.gomarble]
url = "https://apps.gomarble.ai/mcp-api/mcp"

ChatGPT desktop app and IDE extension: open Settings (the gear menu in the IDE) → MCP servers → Add server. Enter gomarble, choose Streamable HTTP, paste the server URL and save. Restart when asked, then click Authenticate.

The CLI, IDE extension and desktop app share the same settings, so you only add GoMarble once. Use the /mcp-api/mcp address: Codex doesn't support the older /sse address.

Cursor

Add GoMarble to ~/.cursor/mcp.json for all projects, or to .cursor/mcp.json for one project:

{
  "mcpServers": {
    "gomarble": {
      "url": "https://apps.gomarble.ai/mcp-api/mcp"
    }
  }
}

Or open this link on a computer with Cursor installed:

cursor://anysphere.cursor-deeplink/mcp/install?name=gomarble&config=eyJ1cmwiOiJodHRwczovL2FwcHMuZ29tYXJibGUuYWkvbWNwLWFwaS9tY3AifQ==

Follow Cursor's prompt to sign in to GoMarble. You can manage the server from Customize → MCPs. In the Cursor CLI, run agent mcp login gomarble.

On Cursor for teams, if your admin uses an MCP allowlist, they need to add the GoMarble server URL to it.

Hermes Agent

hermes mcp add gomarble --url https://apps.gomarble.ai/mcp-api/mcp --auth oauth
hermes mcp login gomarble

Run the login from a new terminal window, not from inside a running Hermes session. Then type /reload-mcp in your session. In Hermes Desktop you can click Authorize instead.

Or add it to ~/.hermes/config.yaml:

mcp_servers:
  gomarble:
    url: "https://apps.gomarble.ai/mcp-api/mcp"
    auth: oauth

To choose which GoMarble tools Hermes can use, run hermes mcp configure gomarble.

OpenClaw

openclaw mcp add gomarble --url https://apps.gomarble.ai/mcp-api/mcp --transport streamable-http --auth oauth
openclaw mcp login gomarble

Always include --transport streamable-http. Without it OpenClaw uses the older SSE connection, and the address above won't work.

In the OpenClaw Control UI, go to Settings → MCP → Add server, choose Streamable HTTP, paste the URL, then click Sign in on the server.

By default, everyone using your OpenClaw gateway shares the GoMarble account that signed in. If each person should use their own GoMarble account, set OpenClaw's MCP sign-in to per user. See OpenClaw's MCP documentation.

Other assistants

VS Code (GitHub Copilot): run MCP: Add Server from the Command Palette, or add this to your mcp.json. VS Code opens your browser to sign in the first time.

{
  "servers": {
    "gomarble": {
      "type": "http",
      "url": "https://apps.gomarble.ai/mcp-api/mcp"
    }
  }
}

On Copilot Business and Enterprise, an admin must allow MCP servers in Copilot first.

Windsurf / Devin Desktop:

devin mcp add -s user gomarble https://apps.gomarble.ai/mcp-api/mcp
devin mcp login gomarble

Gemini CLI:

gemini mcp add --transport http --scope user gomarble https://apps.gomarble.ai/mcp-api/mcp

Then type /mcp auth gomarble in Gemini CLI to sign in.

Perplexity (Pro, Max, Enterprise): go to Account settings → Connectors → + Custom connector → Remote. Enter the name and server URL, choose OAuth and Streamable HTTP, then click Add. Click the GoMarble card to sign in. On Enterprise, an admin must allow members to add custom connectors.

Mistral (Le Chat / Vibe): go to Connectors → + Add Connector → Custom MCP Connector. Name it GoMarble (no spaces), paste the server URL and click Connect.

Any other assistant: if it supports remote MCP servers with sign-in (OAuth), add a remote server with the URL above and sign in to GoMarble when asked. GoMarble doesn't offer API keys, so assistants that only accept a key or token can't connect.

Choosing what the assistant can access

When you connect, GoMarble shows an access screen:

• Read access for each platform: Meta Ads, Google Ads, TikTok Ads, LinkedIn Ads, Microsoft Ads (Bing), Klaviyo, Shopify, Google Analytics, Google Search Console, Facebook Pages, Instagram, Snowflake, Ads Library and impact.com.

• Change access for Meta Ads and Google Ads.

Everything is selected by default. Untick anything you don't want the assistant to use. You can add access later. If the assistant needs something you left out, it shares a link to add it. You can also disconnect and reconnect GoMarble in your assistant's settings.

Change access lets the assistant propose changes. Every change is still shown to you and applied only after you confirm. See GoMarble MCP - Overview.

Your GoMarble sign-in lasts 30 days. After that, your assistant asks you to sign in again.

Try it

Once connected, ask something like:

• "List my GoMarble ad accounts."

• "How did my Meta campaigns do last week compared to the week before?"

• "Which Google Ads search terms spent the most without converting in the last 30 days?"

For everything the assistant can do, see GoMarble MCP - Overview.

Messages you might see