Connect Claude Code
Add the MCP server to Claude Code or Codex with a minted token, or install the plugin.
Claude Code and Codex connect with a bearer token. Mint one in the app, then add the server.
Mint a token
For a single account, open Account → Settings → MCP and generate a project-scoped token. For every account, use Workspace → Settings → MCP for an org-scoped one. Copy the secret — it's shown once.
Add the server
export AI_GOOGLE_ADS_MCP_TOKEN="gads_…"
claude mcp add --transport http ai-google-ads \
https://your-app-origin/api/mcp \
--header "Authorization: Bearer $AI_GOOGLE_ADS_MCP_TOKEN"The tools appear with the gads_ prefix. With an org token, call gads_list_ad_accounts first, then pass a
projectId to account-scoped tools.
Or install the plugin
The plugin bundles the golden-path playbooks and slash commands (/ai-google-ads:setup, :audit, :optimize,
:report, :approvals) alongside the server:
claude --plugin-url https://your-app-origin/api/mcp/plugin.zipVerify the connection
List my ad accounts, then give me the account overview for the first one.If nothing's connected yet, start with Set up over MCP.
Replace your-app-origin with your deployment's origin. Never commit the token — keep it in an environment
variable.