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 protocolo de contexto de modelo (MCP)?
El protocolo de contexto de modelo, 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 en la que se ejecuta el agente de IA, como Cursor o Claude.
- Servidor MCP: Un servicio que proporciona otra plataforma, como Braze, y 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 necesitan contexto de Braze.
- Ingenieros de CRM que crean flujos de trabajo de agentes con varios pasos.
- Especialistas en marketing técnicos 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 campañas y los Canvas, explorar tus Segments y atributos personalizados, generar informes y crear contenido mediante lenguaje natural, como plantillas de correo electrónico, bloques de contenido y activos de la biblioteca multimedia.
¿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 anterior servidor MCP de Braze se ejecutaba localmente en tu máquina. Tenías que instalar un paquete, administrar 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, por lo 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 pierde el acceso.
Las diferencias clave 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.
- Segmentación por 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 puedo usar?
Cualquier cliente MCP que siga el estándar MCP para servidores remotos debería funcionar con el servidor MCP de Braze. El cliente debe autenticarse con OAuth y registrarse por sí mismo, mediante el registro dinámico de clientes (Dynamic Client Registration) o un documento de metadatos de ID de cliente (Client ID Metadata Document), para que no tengas que introducir un ID de cliente ni un secreto de cliente. Antes de poder iniciar sesión, un administrador de la empresa también debe aprobar el URI de redireccionamiento del cliente en la configuración de OAuth.
Braze ha probado Claude y ChatGPT a través de conectores personalizados, así como Cursor, OpenAI Codex, Claude Code y 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 usar el servidor MCP remoto de Braze con un cliente que Braze no haya probado?
Sí, si tu cliente puede registrarse por sí mismo mediante el registro dinámico de clientes (Dynamic Client Registration) o un documento de metadatos de ID de cliente (Client ID Metadata Document). Un administrador de la empresa debe aprobar el URI de redireccionamiento del cliente en la configuración de OAuth antes de que puedas iniciar sesión. ¿Quieres support for your MCP client? Considera dejar comentarios sobre el producto.
¿El servidor remoto admite varios 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. Las herramientas que exponen PII no están disponibles.
¿Las ediciones de Campaign realizadas a través del servidor MCP aparecen en el historial de ediciones?
Sí. Las ediciones de Campaign realizadas con herramientas MCP se atribuyen a tu usuario del panel con sesión iniciada y aparecen en el historial de ediciones de Campaign.
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 con la URL de MCP de Braze.
¿Puedo usar el servidor MCP de Braze durante una prueba gratuita?
No. El servidor MCP de Braze no está disponible para cuentas de prueba gratuita.
Mi empresa usa listas de IP permitidas. ¿Podemos usar el servidor MCP remoto?
Por ahora no. Si usas 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.