Skip to content

MCP setup

Connect Claude Code, Cursor, Windsurf and other MCP clients to MyAd.

1. Create an API key

Open Dashboard → Settings → API and create a key. Scope it to specific accounts and to read-only or read-write. Copy it once — it is not shown again.

2. Add the server

Claude Code — .mcp.json

{
  "mcpServers": {
    "myad": {
      "type": "http",
      "url": "https://myad.si/api/v1/mcp",
      "headers": { "Authorization": "Bearer YOUR_MYAD_API_KEY" }
    }
  }
}

Claude Desktop — claude_desktop_config.json

{
  "mcpServers": {
    "myad": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://myad.si/api/v1/mcp",
        "--header", "Authorization: Bearer YOUR_MYAD_API_KEY"]
    }
  }
}

Cursor — .cursor/mcp.json

{
  "mcpServers": {
    "myad": {
      "url": "https://myad.si/api/v1/mcp",
      "headers": { "Authorization": "Bearer YOUR_MYAD_API_KEY" }
    }
  }
}

3. Verify

Ask your client to list tools. You should see the full tool list, starting with list_accounts. Then try:

“List my ad accounts and their health scores.”

4. Common issues

Symptom Fix
401 Unauthorized Key is wrong, revoked or missing the Bearer prefix.
No tools listed Restart the MCP client after editing the config.
Tool call hangs Check the account has finished connecting in the MyAd dashboard.