Documentación

MCP remoto

Conectá AdsBolt a Claude, Cursor, VS Code, Windsurf o ChatGPT. El agente usa las campañas y el Studio de tu marca: no hace falta clonar el repo ni pegar tokens de Meta.

1. Creá una clave

  1. Entrá a Dashboard → API y MCP.
  2. Elegí la marca y pulsá Crear.
  3. Copiá la clave ab_live_…. Se muestra una sola vez. Si se pierde, revocala y generá otra.

La clave identifica la marca. Las tools de Meta usan la cuenta conectada en Ajustes. Las generaciones descuentan créditos del dueño de esa marca.

2. Endpoint

POST https://www.adsbolt.ai/api/mcp
Authorization: Bearer ab_live_…
Content-Type: application/json

Transporte: MCP Streamable HTTP, sin sesión persistente. Descubrimiento: /.well-known/mcp.json.

3. Clientes

Cursor

En .cursor/mcp.json (o Settings → MCP):

{
  "mcpServers": {
    "adsbolt": {
      "url": "https://www.adsbolt.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer ab_live_…"
      }
    }
  }
}

Claude Desktop / Claude Code

{
  "mcpServers": {
    "adsbolt": {
      "type": "http",
      "url": "https://www.adsbolt.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer ab_live_…"
      }
    }
  }
}

VS Code / Windsurf

{
  "servers": {
    "adsbolt": {
      "type": "http",
      "url": "https://www.adsbolt.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer ab_live_…"
      }
    }
  }
}

ChatGPT u otro backend

Si el conector admite MCP remoto, usá la misma URL y el Bearer. Si no, usá la API REST /api/v1.

4. Tools

  • adsbolt_whoami — marca y permisos
  • meta_list_campaigns, meta_campaign_insights, meta_list_ads
  • meta_pause_campaign, meta_activate_campaign, meta_set_campaign_budget, meta_rename_campaign, meta_set_ad_status
  • adsbolt_ad_copy, studio_generate_image, studio_generate_video

Ninguna tool pide un access token de Meta. Si la clave no tiene el scope, la tool responde error.

5. Conversiones de la tienda

Los eventos de compra van por la Conversions API con una clave distinta (ab_capi_…), no con la clave de desarrollador. Guía: /docs/api#capi.