AdCopilot docsby Atromx
Connect your assistant

Connect Claude Code and Codex

In Claude Code, install the AdCopilot plugin or add the connector with one command. Codex takes one command. Approve in your browser, then ask.

View as Markdown
Open inClaudePerplexity

Claude Code: the plugin

The AdCopilot plugin registers the connector for you, so there is no claude mcp add step. It also adds skills, /adcopilot: commands and an agent. In Claude Code:

/plugin marketplace add AtromxIntelligence/adcopilot-claude-plugin
/plugin install adcopilot@adcopilot-claude-plugin

Then run /mcp, choose adcopilot and authenticate. Your browser opens AdCopilot's page asking you to let Claude Code use your AdCopilot. Press Approve and go back to the terminal.

What the skills and commands do, and what to do if you already added the connector by hand: The Claude Code plugin.

Claude Code: by hand

Rather not install a plugin? Add the connector with one command instead:

claude mcp add --scope user --transport http adcopilot https://mcp.adcopilot.cloud/mcp

--scope user makes AdCopilot available in every folder. Without it, Claude Code adds it only to the folder you ran the command in.

Then start Claude Code, run /mcp, choose adcopilot and authenticate, as above.

Use the plugin or this command, not both. A copy added by hand hides the plugin's; see Already added the connector by hand?.

Codex

codex mcp add adcopilot --url https://mcp.adcopilot.cloud/mcp

Codex signs in through your browser the same way: approve AdCopilot on the page it opens.

Ask

Open Claude Code and type: Get me started with AdCopilot

Open Codex and type: Get me started with AdCopilot

It reads what your workspace has connected and says the next step. A Google product not connected yet is connected in your browser, on Google's own consent screen, from the link it gives you or from Connect Google Ads. Claude Code also lists the same start in its / menu: as /plugin:adcopilot:adcopilot:get-started (MCP) with the plugin, and as /adcopilot:get-started (MCP) when you added the connector by hand.

Picking up new tools

The tool list is loaded when the client connects. After an AdCopilot release adds tools:

  • Claude Code: run /mcp, choose adcopilot and reconnect. If you added it by hand rather than with the plugin, you can also remove it (claude mcp remove adcopilot) and add it again with the command above. If the remove says AdCopilot is in more than one scope, run claude mcp remove adcopilot -s user and, from the folder you added it in, claude mcp remove adcopilot -s local.
  • Codex: start a new session; if the tool is still missing, remove AdCopilot and add it again.

AdCopilot says so in the conversation when this is needed. Connecting another Google product needs nothing here, unless Connect your AI marks the client Re-authorization needed. See A tool is missing or out of date.

Schedule the morning check

Claude Code can save AdCopilot's read-only morning check as a routine that runs by itself every weekday. A routine runs in the cloud, where only the connectors added on claude.ai are available, so add AdCopilot at claude.ai/customize/connectors first: a routine cannot see the plugin's own connector. Routines run tools without asking, so keep the instructions read-only, exactly as written:

/schedule weekdays at 8:07am AdCopilot morning check, read-only. Call get_org_context first, with source "claude-scheduled" and task "AdCopilot morning check". Do not use any tool that changes my account, and do not ask me questions; if something is unknown, say so and carry on. For the Google Ads account I have switched on in AdCopilot:
1. Yesterday's spend, clicks, conversions and cost per conversion against my 7-day average.
2. This month's budget pacing: on track, over or under, and any campaign limited by budget.
3. The 5 search terms from the last 7 days that cost the most with no conversions, with their cost.
4. Any ad that is disapproved or limited, with Google's stated reason.
5. Any change made in the account in the last 24 hours, and by whom.
Start with one line: "All clear" or "Needs a look". End with the single most valuable fix, written as a yes/no question I can answer when I open this.

Then run it once and check it finishes without stopping to ask. The same check as a Claude scheduled task, and the Monday summary, are in The daily routine.

On this page