Skip to main content

Opteo MCP

Connect Opteo to Claude, ChatGPT, and other AI assistants using the Opteo MCP server

Written by Shaquira Jeyasingh

The Opteo MCP server lets AI assistants like Claude and ChatGPT connect straight to your Opteo account, so they can read your connected ad account data and take actions in Opteo for you, all from an ordinary chat.

MCP (Model Context Protocol) is an open standard for plugging AI assistants into outside tools and data. You don't need to be technical to set it up: you add one web address to your AI assistant, sign in to Opteo once, and you're connected.

This is different from the Opteo API and the Zapier integration, which are for building your own automations. The MCP is for working with Opteo conversationally inside an AI assistant.

Before you start

You need an active Opteo account (the same login you use at opteo.com). There's nothing to install. The Opteo MCP is a remote server, which means it runs on Opteo's side and your AI assistant connects to it over the web.

The server address

This is the only detail you need:

The first time an assistant connects, a browser window opens for you to sign in to Opteo and approve access. This uses OAuth, the same sign-in approval you have seen on other apps, so you never copy or paste a password or key. Once you have approved it, the assistant reconnects on its own from then on.

Claude (claude.ai and the desktop apps)

  1. Open Claude, go to Settings, then Connectors.

  2. Click the + sign at the top

  3. Then click Add custom connector.

  4. Enter a name (Opteo) and the URL https://api.opteo.com/mcp.

  5. Click Save.

  6. Claude opens the Opteo sign-in page. Sign in and approve access.

  7. In a new chat, open the tools menu and turn on Opteo for that conversation.

Claude Code (command line)

Run this once in your terminal:

claude mcp add --transport http opteo https://api.opteo.com/mcp

The next time you start Claude Code it asks you to approve Opteo in your browser.

Check it worked with:

claude mcp list

Cursor

  1. Open Cursor, go to Settings, then MCP (or edit the file ~/.cursor/mcp.json yourself).

  2. Add this entry:

{
"mcpServers": {
"opteo": {
"url": "https://api.opteo.com/mcp"
}
}
}
  1. Save the file. Cursor picks up the new server and opens a browser tab for you to sign in to Opteo.

ChatGPT and other AI assistants

Any assistant that supports remote MCP servers can connect. Add a new connector or server using:

  • Transport: Streamable HTTP (sometimes shown as HTTP or Remote MCP). This just means the assistant talks to the server over the web.

  • Authentication: OAuth. The assistant handles the browser sign-in for you, so there is no API key, client ID, or secret to enter.

In ChatGPT, custom connectors are under Settings, then Connectors, then Create.

They need developer mode switched on, and a Plus, Pro, or Business plan. Free plans cannot add custom connectors yet.

Disconnecting

To stop an assistant from reaching your Opteo account, remove the Opteo connector inside that assistant:

  • Claude: Settings, Connectors, remove Opteo.

  • Claude Code: run claude mcp remove opteo

  • Cursor: delete the opteo entry from ~/.cursor/mcp.json

If you also need access revoked on Opteo's side (for example, the assistant was on a device you no longer have), email [email protected] and we'll revoke it for you.

Troubleshooting

Did this answer your question?