Cómo conectar Braze a Cursor vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Braze, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Braze + Cursor

Deja que tu IA trabaje con Braze: revisa campañas, Canvases y sus resultados, consulta segmentos, usuarios activos diarios e ingresos, busca perfiles de usuario y suscripciones, registra atributos y eventos y, cuando lo confirmes, lanza campañas API.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

BRAZE_REST_ENDPOINT, BRAZE_REST_API_KEY

Paso 1 — Obtener credenciales

1. En Braze abre Settings → APIs and Identifiers → API Keys y haz clic en Create API Key. Una clave pertenece a un solo workspace.
2. Ponle un nombre y marca los permisos que necesitan las herramientas. Para leer: campaigns.list, campaigns.details, campaigns.data_series, sends.data_series, canvas.list, canvas.details, canvas.data_summary, segments.list, segments.details, segments.data_series, kpi.dau.data_series, kpi.mau.data_series, kpi.new_users.data_series, kpi.uninstalls.data_series, events.list, events.data_series, purchases.product_list, purchases.quantity_series, purchases.revenue_series, subscription.status.get, subscription.groups.get, users.export.ids. Para escribir añade users.track, campaigns.trigger.send, canvas.trigger.send, y users.delete solo si vas a activar la herramienta de borrado. Los permisos de una clave no se pueden cambiar después: en su lugar, crea una clave nueva.
3. Copia la clave en BRAZE_REST_API_KEY, sin el prefijo Bearer.
4. Copia el REST endpoint que aparece en la misma página en BRAZE_REST_ENDPOINT. Depende de tu instancia de Braze y coincide con la dirección de tu dashboard: dashboard-01.braze.com usa https://rest.iad-01.braze.com, dashboard-01.braze.eu usa https://rest.fra-01.braze.eu, y así sucesivamente. Las instancias de EE. UU. funcionan en rest.iad-01 a rest.iad-08 y en rest.us-10 (.braze.com), las de la UE en rest.fra-01 y rest.fra-02 (.braze.eu), y las demás en rest.au-01, rest.id-01, rest.jp-01 y rest.kr-01 (.braze.com). Una clave solo funciona en su propia instancia.
5. Instala el conector. La comprobación de conexión lista tus campañas, así que la clave necesita campaigns.list.

Quién ve qué: la clave actúa para todo el workspace, no para una persona. Quien use el conector ve todo lo que la clave puede leer, incluidos los perfiles de usuario. Comparte el servidor MCP solo con personas autorizadas a verlo.

Qué lee: campañas y Canvases con su configuración, mensajes y resultados diarios (envíos, entregas, aperturas, clics, conversiones, ingresos), los resultados de un envío concreto lanzado por API (se guardan 14 días), segmentos con su tamaño estimado (en segmentos con analytics tracking), usuarios activos diarios y mensuales, usuarios nuevos y desinstalaciones, eventos personalizados, compras e ingresos, perfiles de usuario por external id, alias, braze_id, email o teléfono, y el estado de los subscription groups. Las series cubren de 1 a 100 días, los resúmenes de Canvas de 1 a 14.

Confirmar antes: braze_track_users registra atributos, eventos personalizados y compras, hasta 75 por llamada, y puede meter usuarios en segmentos e iniciar Canvases, así que la IA te muestra los cambios y espera tu confirmación. braze_send_campaign y braze_send_canvas lanzan campañas y Canvases API que envían mensajes reales a personas reales: la IA te muestra la campaña o el Canvas, el canal y exactamente quién lo recibirá, y para un broadcast o más de un destinatario espera un "sí, envía" explícito. braze_delete_users viene desactivada al instalar.

Límites: la mayoría de los endpoints permiten 250.000 peticiones por hora. La lectura de perfiles de usuario permite 250 llamadas por minuto en los workspaces dados de alta desde agosto de 2024 (2.500 antes), las listas de eventos personalizados y de productos comparten 1.000 por hora, y los endpoints de envío permiten 250 llamadas broadcast por minuto y 10 por minuto por audiencia. Cuando se alcanza un límite, Braze responde 429.

Errores comunes: 401 "Invalid API key": la clave es incorrecta o pertenece a otra instancia; comprueba que el REST endpoint coincide con tu dashboard. 403 "Access Denied": a la clave le falta el permiso para este endpoint, así que crea una clave que lo tenga. 400: falta un parámetro o no es válido, por ejemplo una duración fuera de rango o un id de campaña desconocido. 429: se alcanzó un límite de peticiones; espera y vuelve a intentarlo una vez.

El conector no cubre content blocks y plantillas, catálogos, listas de email y hard bounces, mensajes programados, preference centers, SCIM, los endpoints de user alias e identify, las exportaciones de segmentos a almacenamiento en la nube ni Currents.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Cursor

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Cursor lee los servidores MCP de ~/.cursor/mcp.json. Añade esta entrada:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia Cursor.
3. Abre Cursor → Settings → MCP y comprueba que anythingmcp aparece en la lista y está conectado.
4. Empieza a chatear: el agente ya puede usar las herramientas de Braze.

Herramientas disponibles

Ejemplos de prompts

• "¿Qué campañas enviamos en los últimos 30 días, y cuál tuvo las mejores tasas de apertura y de clics?"
• "¿Cuántos usuarios entraron en nuestro Canvas de onboarding la semana pasada, y cuántos convirtieron en cada paso?"
• "Muéstrame los usuarios activos diarios y los usuarios nuevos de los últimos 60 días."
• "Registra el evento personalizado webinar_attended para el usuario con external_id 4821 y muéstrame antes lo que vas a escribir."

FAQ

¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT