API & MCP setup

Connect your AI agent to Ovaideu.

Ovaideu runs a Model Context Protocol (MCP) server, so an AI agent such as Claude, ChatGPT, Codex or Gemini can run your Google Ads, GA4, Search Console, Tag Manager, Business Profile and Meta Ads work in plain language — inside the same tenant-scoped, user-bound access as the dashboard. Add one connector URL, authenticate with your own API key, and you are set.

Start free trial ChatGPT connector guide Book a call

MCP connector URL

https://ovaideu.com/api/mcp

Also reachable at https://ovaideu.com/mcp — same server.

Protocol: Model Context Protocol (MCP), JSON-RPC 2.0 over HTTPS

Authentication: Authorization: Bearer <your Ovaideu API key>

Where to get a key: Dashboard → MCP Management → MCP keys

What the connection does

One connector, your whole marketing stack.

Once connected, your agent can read from and make authorized changes across the accounts you authorize — nothing wider. Every write is scoped to your key, logged, and read back after it runs.

Google Ads — build, edit and optimize real campaigns

Google Analytics 4 — key events and conversions

Google Search Console — queries and top pages

Google Tag Manager — tags and triggers

Google Business Profile — profile and locations

Meta Ads — campaigns, ad sets and reporting

Connection details

The three things every client needs.

Whatever client you use, the connection is always the same URL, the same header, and a key you create yourself. Get these right first — the per-client steps below just plug them in.

1. The endpoint

Point your client at the MCP server below. It speaks the Model Context Protocol over HTTPS (JSON-RPC 2.0), protocol version 2025-06-18.

https://ovaideu.com/api/mcp

2. Authentication

Send your Ovaideu API key as a Bearer token. Web connectors and the desktop bridge do this for you; for direct API calls, add the header yourself.

Authorization: Bearer YOUR_OVAIDEU_API_KEY

3. Your MCP key

Sign in to Ovaideu, activate your own MCP access, and create a user-bound key in the dashboard. Workspace admins can also manage internal users from the same page.

Open MCP keys

Web clients

Claude and ChatGPT on the web — no install.

Claude and ChatGPT can connect to the remote MCP server directly. Add it once as a custom connector and authorize your own Google or Meta account in your browser.

Claude

Add Ovaideu in Claude

On a Claude Pro, Max, Team or Enterprise plan, open Settings → Connectors.
Click Add custom connector and paste the MCP connector URL.
When prompted, authenticate with your Ovaideu API key (Bearer) or complete the guided sign-in.
Start a chat and ask Ovaideu to build, review or optimize a campaign in plain language.

ChatGPT

Add Ovaideu in ChatGPT

Open Settings → Connectors → Add custom connector.
Paste the MCP connector URL.
Authenticate with your Ovaideu API key (Bearer), then complete the Google or Meta sign-in in your own browser.
Ask ChatGPT to run your ads work — it calls Ovaideu behind the scenes.

Connector URL

Paste this into either client:

https://ovaideu.com/api/mcp

Start connector setup Book a call WhatsApp

ChatGPT connector

Connect ChatGPT to the full OVAIDEU workspace.

Use one connector for the full read, create, update, delete and optimize lifecycle across every OVAIDEU surface already available to your account: Paid Media, GA4, GTM, Search Console, Business Profile, Merchant Center, Meta, Shopify, WordPress, CRM, social posting, email, reports, billing, support and orchestration.

Open ChatGPT settings

Go to Settings, open Connectors or Plugins, then choose Add custom connector.

Paste OVAIDEU

Use https://ovaideu.com/api/mcp as the MCP server URL. Remove any old api.ovaideu.com connector first.

Sign in

Click Sign in with OVAIDEU, use your own OVAIDEU account, then approve connector access.

Connect providers

Inside OVAIDEU, connect the Google, Meta, Shopify, WordPress, social, email or CRM providers you want this user to manage.

Refresh actions

Open the OVAIDEU connector settings, refresh actions, and set permissions to allow all actions when you want ChatGPT to execute user-approved work directly.

Run a read check

Ask ChatGPT to list connected Google Ads accounts, GA4 properties, and active campaigns. No account changes are made.

Run real work

Ask for the change in normal language. OVAIDEU can read, create, edit, update, delete and optimize through the same full MCP toolset when that user, plan, role and provider permission allow it.

Live connector URLs

Use the public hosts only. Do not use localhost for ChatGPT web.

https://ovaideu.com/mcphttps://ovaideu.com/api/mcp

How account selection works

OVAIDEU lists every provider account visible to the signed-in user's own Google, Meta or connected-provider OAuth, inside that user's tenant, role and plan boundary. If one account is visible, ChatGPT can use it directly. If many accounts are visible, ChatGPT shows the names and IDs and asks which one to use. Client mapping is useful for reporting and multi-channel organization, but it is not a blocker when the user's own OAuth already proves account access.

Mapping is optional contextAgents can ask, confirm, then attachView setup hyperframe

Desktop & local agents

Codex, Claude Desktop, Cursor and local agents.

Clients that speak MCP over stdio reach the server through the bundled Node bridge. It forwards each call to the same URL with your key as a Bearer token — you never paste a secret into a web form.

Create your MCP key

Sign in to the dashboard, open MCP Management, activate your MCP access, and create one scoped key bound to your own user email.

Install the bridge

Download the installer zip, run the numbered Windows or Mac installer, and let it place the bridge on your computer.

Add the config

Paste the Claude JSON or Codex TOML below into your client and set the bridge path. Requires Node.js on the machine.

Paste your own key

Paste the MCP key created from your signed-in OVAIDEU account. The key carries your workspace, role, subscription, client map and provider permissions.

Claude Desktop config

{
  "mcpServers": {
    "ovaideu": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/ovaideu-desktop-mcp-bridge.mjs"],
      "env": {
        "OVAIDEU_MCP_URL": "https://ovaideu.com/api/mcp",
        "OVAIDEU_MCP_ORIGIN": "https://claude.ai",
        "OVAIDEU_MCP_TOKEN": "PASTE_YOUR_OWN_OVAIDEU_MCP_KEY_HERE"
      }
    }
  }
}

Codex config (config.toml)

[mcp_servers.ovaideu]
command = "node"
args = ["/ABSOLUTE/PATH/TO/ovaideu-desktop-mcp-bridge.mjs"]

[mcp_servers.ovaideu.env]
OVAIDEU_MCP_URL = "https://ovaideu.com/api/mcp"
OVAIDEU_MCP_ORIGIN = "https://chatgpt.com"
OVAIDEU_MCP_TOKEN = "PASTE_YOUR_OWN_OVAIDEU_MCP_KEY_HERE"

Get setup help Book a call WhatsApp

Verify & direct API

Test the connection from a terminal.

The same endpoint answers direct HTTP calls. Run a tools/list request with your key to confirm access before wiring up a client. A valid key returns the tools it is allowed to see.

Connection test

curl -s https://ovaideu.com/api/mcp \
  -H "Authorization: Bearer YOUR_OVAIDEU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

A 401 means the key is missing or wrong; a 403 means your signed-in user does not have active MCP access yet — open API & MCP and activate your access.

Downloads

Setup files for people and AI assistants.

Use View to inspect a file in the browser, or Download to save the package locally.

Ovaideu setup PDF

Give this PDF to your AI assistant. It includes the connector URL, the authentication step and the shortest path through account authorization.

View PDF Download PDF

Desktop installer zip

Recommended. One zip with numbered Windows and Mac double-click installers.

View Download

PDF setup guide

Start here. A short setup path for desktop MCP users and AI assistants.

View Download

Share JSON

Send the desktop MCP setup to another agent or teammate.

View Download

Bridge package

Bridge script, README, Claude JSON and Codex TOML in one package.

View Download

Claude config

Starter Claude Desktop MCP configuration.

View Download

Codex config

Starter Codex MCP configuration.

View Download

Get setup help Book a call WhatsApp

Works with

Any MCP-compatible AI client.

Ovaideu follows the open Model Context Protocol, so it works with any client that speaks MCP. Web clients use the connector URL directly; desktop and CLI clients use the bridge.

ClaudeChatGPTCodexGeminiCursorKimi

MCP

The primary surface. One remote server, user-bound scoped access, and the same tenant-scoped access as the dashboard.

API

The same endpoint answers direct HTTPS calls for authorized server-to-server workflows in your own workspace.

CLI

A public installer command is planned after MCP/API verification. Until then, use the bridge package and PDF.

Start free trial Book a call WhatsApp

Free during the opening period

Try the private control surface — free to start.

Ovaideu workspaces include scoped keys, MCP connectors, usage controls and audit logs after account setup.

Start free trial Book a call WhatsApp

No card required · White-label for agencies