Resumen
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.
Configuración guiada
Conecta Braze a Microsoft Copilot en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta Braze con la configuración guiada y añade tu URL MCP a Microsoft Copilot. Sin código y sin servidores que mantener.
Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible
Prueba a pedir
Prompts de ejemplo para Braze
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿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 + Microsoft Copilot
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
- En Braze abre Settings → APIs and Identifiers → API Keys y haz clic en Create API Key. Una clave pertenece a un solo workspace.
- 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ñadeusers.track,campaigns.trigger.send,canvas.trigger.send, yusers.deletesolo 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. - Copia la clave en
BRAZE_REST_API_KEY, sin el prefijo Bearer. - 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.comusahttps://rest.iad-01.braze.com,dashboard-01.braze.euusahttps://rest.fra-01.braze.eu, y así sucesivamente. Las instancias de EE. UU. funcionan enrest.iad-01arest.iad-08y enrest.us-10(.braze.com), las de la UE enrest.fra-01yrest.fra-02(.braze.eu), y las demás enrest.au-01,rest.id-01,rest.jp-01yrest.kr-01(.braze.com). Una clave solo funciona en su propia instancia. - 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 Microsoft Copilot
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 muestraYOUR_SERVER_ID.
Microsoft Copilot usa servidores MCP a través de agentes creados en Copilot Studio: añades AnythingMCP a un agente como herramienta y luego publicas el agente en Microsoft 365 Copilot y Teams. Copilot Studio se conecta desde la nube de Microsoft por Streamable HTTP, que AnythingMCP admite.
- En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
- Escribe un Server name (por ejemplo
AnythingMCP), una Server description que diga qué hace el conector y la Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor. - En la autenticación, elige API key, pon Type en Header y
X-API-Keycomo nombre de la cabecera, y selecciona Create. - En Add tool, elige Create a new connection, pega una clave de API MCP de AnythingMCP (MCP Servers → tu servidor → API keys) y selecciona Add to agent.
- Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de
Braze. - Selecciona Publish y luego Channels → Microsoft 365 and Microsoft Teams, deja marcada Make agent available in Microsoft Copilot y elige Add channel. See agent in Teams lo instala para ti; en Microsoft 365 Copilot, escribe @ y elige el agente.
¿Prefieres que cada persona inicie sesión? En lugar de la clave de API elige OAuth 2.0 → Dynamic discovery: cada usuario inicia sesión en AnythingMCP la primera vez que el agente lo llama.
¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Copilot Studio se conecta desde la nube de Microsoft, así que localhost no funciona.
Herramientas disponibles
| Tool | What it does |
|---|---|
braze_list_campaigns | List the campaigns of the Braze workspace, 100 per page: id (campaign API identifier), name, whether it is an API campaign, tags and last… |
braze_get_campaign | Get the details of one Braze campaign: name, description, enabled, archived and draft flags, schedule type, channels, first and last sent… |
braze_get_campaign_data_series | Get a daily series of a Braze campaign's results: unique recipients, conversions, revenue and, per channel and variation, sends… |
braze_get_send_data_series | Get the daily results of one send of an API campaign (a send_id groups the messages of one trigger call): per channel and variation sends… |
braze_list_canvases | List the Canvases (multi-step journeys) of the Braze workspace, 100 per page: id (Canvas API identifier), name, tags and last edit time |
braze_get_canvas | Get the details of one Braze Canvas: name, description, enabled, archived and draft flags, schedule type, first and last entry, channels… |
braze_get_canvas_data_summary | Get the totals of a Braze Canvas for a period: entries, conversions, revenue and, on request, the same per variant and per step with… |
braze_list_segments | List the segments of the Braze workspace, 100 per page: id (segment API identifier), name, whether analytics tracking is enabled, and tags |
braze_get_segment | Get the details of one Braze segment: name, description of its filters, created and updated time, and tags |
braze_get_segment_size_series | Get the estimated size of a Braze segment per day |
braze_get_kpi_series | Get a daily series of a Braze key metric for the workspace or one app: dau (daily active users), mau (monthly active users, rolling 30… |
braze_list_custom_events | List the names of the custom events recorded in the Braze workspace, 250 per page, in alphabetical order |
braze_get_custom_event_series | Get how often a Braze custom event occurred per day or per hour, for the workspace, one app or one analytics-enabled segment |
braze_list_products | List the product ids of the purchases recorded in Braze, page by page |
braze_get_purchase_quantity_series | Get the number of items purchased per day or per hour in Braze, for all products or one, for the workspace or one app |
braze_get_revenue_series | Get the revenue per day or per hour recorded from purchases in Braze, for all products or one, for the workspace or one app |
braze_get_subscription_group_status | Get whether a user is subscribed to one Braze subscription group (SMS, WhatsApp or email), identified by external_id, email or phone |
braze_list_user_subscription_groups | List the subscription groups a Braze user belongs to and their state, identified by external_id, email or phone |
braze_export_users_by_ids | Read Braze user profiles by identifier: external_ids (up to 50), user aliases, braze_id, email_address or phone |
braze_track_users | Write to Braze user profiles: set or change attributes (standard and custom), record custom events and record purchases, up to 75 objects… |
braze_send_campaign | Send an API-triggered Braze campaign now: to listed recipients, to a connected audience, or with broadcast true to the campaign's whole… |
braze_send_canvas | Start an API-triggered Braze Canvas now: for listed recipients, a connected audience, or with broadcast true for the Canvas's whole target… |
braze_delete_users | Permanently delete Braze user profiles, up to 50 per call, by external_ids, user_aliases, braze_ids, email_addresses or phone_numbers, only… |
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
¿Para qué Copilot es? Para Microsoft 365 Copilot en el trabajo, mediante agentes de Copilot Studio. La app de Microsoft Copilot para cuentas personales no permite añadir tu propio servidor MCP.
¿Qué necesito? Una cuenta de trabajo con acceso a Copilot Studio (licencia o prueba) para crear el agente. Quien lo use en Microsoft 365 Copilot o Teams necesita acceso al agente: compártelo o pide a un administrador que lo publique para la organización. Si tu organización aplica directivas de datos a los conectores de Power Platform, también cubren los servidores MCP.
El agente no llama a las herramientas. Comprueba que el nombre de la cabecera sea exactamente X-API-Key y que la clave pertenezca al mismo servidor MCP que la URL, y escribe una Server description concreta: Copilot Studio la usa para decidir cuándo llamar al servidor. Vuelve a publicar el agente después de cada cambio; en un chat abierto, escribe "start over" para usar la nueva versión.
Siguientes pasos
- Página del conector
- Conectar a Claude
- Conectar a ChatGPT
- Conectar a Cursor
- Conectar a Gemini
- Conectar a Meta Muse
¿Te ha sido útil esta guía?