El servidor MCP de Braze
Descubre el servidor MCP de Braze, una conexión remota segura que permite a herramientas de IA como Claude y Cursor acceder a datos de Braze que no son PII para responder preguntas, analizar tendencias, proporcionar información y crear contenido.
¿Qué es el Model Context Protocol (MCP)?
El Model Context Protocol, o MCP, es un estándar que permite a los agentes de IA conectarse a los datos de otra plataforma y trabajar con ellos. Tiene dos partes principales:
- Cliente MCP: La aplicación donde se ejecuta el agente de IA, como Cursor o Claude.
- Servidor MCP: Un servicio proporcionado por otra plataforma, como Braze, que define qué herramientas puede usar la IA y a qué datos puede acceder.
Acerca del servidor MCP de Braze
Después de configurar el servidor MCP de Braze, puedes conectar herramientas de IA, como agentes, asistentes y chatbots, directamente a Braze. Así podrán leer datos agregados como los análisis de Canvas y Campaign, los atributos personalizados, los Segments y mucho más. El servidor MCP de Braze es ideal para:
- Crear herramientas basadas en IA que necesiten contexto de Braze.
- Ingenieros de CRM que crean flujos de trabajo de agentes de varios pasos.
- Especialistas en marketing técnico que experimentan con consultas en lenguaje natural.
El servidor MCP de Braze incluye herramientas de lectura y de escritura. Estas herramientas no devuelven datos de los perfiles de usuario de Braze. Tus agentes heredan los permisos de usuario que tienes en el panel de Braze. Para ver la lista completa de herramientas disponibles, consulta Funciones de API disponibles.
Las herramientas que exponen PII a nivel de usuario no están disponibles.
Usa el servidor MCP para hacer preguntas sobre el rendimiento de las Campaigns y los Canvas, explorar tus Segments y atributos personalizados, generar informes y crear contenido, como plantillas de correo electrónico, Content Blocks y activos de la biblioteca multimedia, mediante lenguaje natural.
¿Está obsoleto el servidor MCP beta?
Sí. El servidor MCP alojado localmente que se lanzó en agosto de 2025 está obsoleto y no recibirá más actualizaciones. Puedes seguir usándolo, pero Braze recomienda migrar a la versión alojada de forma remota.
¿En qué se diferencia el servidor remoto?
El servidor MCP anterior de Braze se ejecutaba localmente en tu máquina. Tenías que instalar un paquete, gestionar un archivo de configuración y crear una clave de API de Braze con los permisos adecuados. El servidor MCP remoto elimina esa configuración local.
Conéctate desde un cliente MCP compatible en menos de un minuto. La autenticación usa OAuth. El acceso está vinculado a tu cuenta de usuario del panel de Braze, no a una clave de API compartida, así que lo que un agente puede ver y hacer refleja tus permisos del panel. Si un usuario del panel pierde el acceso en Braze, el cliente también lo pierde.
Las principales diferencias son:
- Configuración: Pega una URL de Braze en lugar de instalar un paquete y editar archivos de configuración.
- Autenticación: Inicia sesión con tu cuenta de Braze en lugar de crear una clave de API.
- Permisos: El acceso se basa en tu cuenta de usuario del panel en lugar de en los permisos de la clave de API.
- Selección del espacio de trabajo: El contexto del espacio de trabajo se pasa en cada solicitud en lugar de quedar fijado en la configuración local.
Preguntas más frecuentes (FAQ)
¿Qué clientes MCP son compatibles?
Cualquier cliente MCP que admita servidores MCP remotos con OAuth puede funcionar. Braze ha verificado:
- Claude a través de conectores personalizados
- ChatGPT a través de conectores personalizados
- Cursor
- OpenAI Codex
- Claude Code
- Visual Studio Code
¿A qué datos de Braze puede acceder mi cliente MCP?
Los clientes MCP pueden acceder a herramientas que no devuelven PII a nivel de usuario.
¿Mi cliente MCP puede modificar datos de Braze?
Sí, si tu usuario del panel tiene esos permisos.
¿Sigo necesitando una clave de API de Braze?
No para MCP. Las claves de API siguen funcionando para la REST API y no se van a descontinuar.
¿Qué regiones son compatibles?
Ambos clústeres de Braze son compatibles. Actualmente hay dos endpoints disponibles:
https://mcp.braze.com/mcp(EE. UU.)https://mcp.braze.eu/mcp(UE)
Cualquiera de los dos endpoints puede conectarse a cualquier clúster de Braze.
¿Puedo utilizar el servidor MCP remoto de Braze con herramientas distintas a las de la lista verificada?
Puedes intentarlo, pero la autenticación podría bloquearse. Actualmente, Braze mantiene una lista de dominios permitidos por seguridad. ¿Quieres support for your MCP client? Considera dejar comentarios sobre el producto.
¿El servidor remoto admite múltiples espacios de trabajo?
Sí. Especifica el espacio de trabajo por conversación o por solicitud. Una sola conexión cubre todos los espacios de trabajo a los que tienes acceso autorizado.
¿Mi agente puede acceder a PII a nivel de usuario?
No. Actualmente, las herramientas que exponen PII no están disponibles.
¿Las ediciones de campañas realizadas a través del servidor MCP aparecen en el historial de ediciones?
Sí. Las ediciones de campañas realizadas con herramientas MCP se atribuyen a tu usuario del panel con sesión iniciada y aparecen en el historial de ediciones de la campaña.
Las herramientas MCP específicas de Canvas son actualmente de solo lectura (get_canvas_list, get_canvas_details, get_canvas_data_series y get_canvas_data_summary).
¿Qué sucede cuando cambian mis permisos?
El acceso del agente cambia con el usuario del panel. Los cambios de permisos se aplican en la siguiente solicitud. Los usuarios del panel desactivados pierden el acceso a MCP.
¿Por qué no veo el conector de Braze en el directorio de mi cliente?
Es posible que los listados del directorio aún no estén disponibles en todos los clientes MCP. Siempre puedes conectarte manualmente utilizando la URL de MCP de Braze.
Mi empresa utiliza listas de IP permitidas. ¿Podemos usar el servidor MCP remoto?
No por el momento. Si utilizas listas de IP permitidas, no puedes usar el servidor MCP remoto.
Descargo de responsabilidad
Cómo se gestionan las instrucciones y las respuestas
El servidor MCP de Braze recibe instrucciones de tu cliente MCP de proveedor externo, como Claude, ChatGPT, Copilot, Gemini CLI, Codex o Cursor, exactamente como las formula el modelo de IA subyacente de ese proveedor. Cuando escribes una solicitud en lenguaje natural, el modelo de IA interpreta tu solicitud y la traduce en una o más llamadas de herramienta específicas a Braze. Braze recibe y ejecuta la llamada de herramienta tal como se envía. Braze no ve tu indicación original en lenguaje natural y no puede verificar que la llamada de herramienta generada refleje total o fielmente tu solicitud prevista.
Cuando Braze devuelve datos o un resultado, esa respuesta se envía de vuelta a tu cliente MCP de proveedor externo, que luego la interpreta, formatea y te la presenta. Braze no controla cómo el modelo de IA presenta, resume o describe la información devuelta.
Braze no es responsable de las instrucciones generadas por, ni de las respuestas transmitidas a través de, ningún cliente MCP de proveedor externo. Braze recomienda no utilizar el «modo automático» si tu cliente MCP de proveedor externo lo ofrece para la implementación automática de acciones. Revisa los resúmenes generados por IA comparándolos con los datos de origen en tu panel de Braze y revisa cualquier acción propuesta por la IA antes de implementarla a través de tu cliente MCP de proveedor externo.