El servidor MCP de Braze
Descubre el servidor MCP de Braze, una conexión 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 y proporcionar información.
El servidor MCP de Braze está en fase beta. No necesitas solicitar acceso para usarlo. Sigue las instrucciones de configuración para empezar. Al usar el servidor MCP de Braze, aceptas los Términos beta de Braze. Para ayudarnos a mejorarlo, envía tus comentarios a [email protected].
¿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 y trabajar con datos de otra plataforma. 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 proporcionado por otra plataforma, como Braze, que define qué herramientas puede utilizar 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, lo que les permite leer datos agregados como análisis de Canvas y Campaign, atributos personalizados, Segments y mucho más. El servidor MCP de Braze es ideal para:
- Crear herramientas basadas en IA que necesitan el contexto de Braze.
- Ingenieros de CRM que crean flujos de trabajo de agentes de varios pasos.
- Especialistas en marketing técnicos que experimentan con consultas en lenguaje natural.
El servidor MCP de Braze admite 39 puntos finales que no devuelven datos de los perfiles de usuario de Braze. Puedes elegir qué puntos finales asignar a tu clave de API de Braze para controlar a qué puede acceder o modificar un agente.
Asigna solo los permisos de clave de API que quieras que tenga tu agente. Si no quieres que tu agente realice cambios en Braze, asegúrate de dejar desactivados los permisos de escritura. Los agentes pueden intentar escribir datos a través de cualquier permiso que concedas.
Ejemplo de uso
Puedes interactuar con Braze mediante lenguaje natural utilizando herramientas como Claude o Cursor. Para ver otros ejemplos y prácticas recomendadas, consulta Uso del servidor MCP de Braze.
Preguntas más frecuentes (FAQ)
¿Qué clientes MCP son compatibles?
Solo Claude y Cursor son oficialmente compatibles. Debes tener una cuenta en uno de estos clientes para poder utilizar el servidor MCP de Braze.
¿A qué datos de Braze puede acceder mi cliente MCP?
Los clientes MCP pueden acceder a puntos finales que no devuelven PII. Tú controlas qué puntos finales puede utilizar un agente a través de los permisos que asignas a tu clave de API.
¿Mi cliente MCP puede modificar datos de Braze?
El servidor solo expone el punto de conexión de escritura /media_library/create, que te permite cargar activos de medios en tu biblioteca de medios. Si no quieres que tu agente realice esos cambios en Braze, deja sin marcar el permiso media_library.create cuando crees tu clave de API.
¿Puedo utilizar un servidor MCP de terceros para Braze?
No se recomienda utilizar un servidor MCP de terceros para los datos de Braze. Utiliza únicamente el servidor oficial MCP de Braze alojado en PyPi.
¿Por qué el servidor MCP de Braze no ofrece acceso a PII?
Para proteger los datos de usuario y al mismo tiempo respaldar casos de uso valiosos, el servidor se limita a puntos finales que normalmente no devuelven PII. Esto reduce el riesgo para tu espacio de trabajo y las personas que lo utilizan.
¿Puedo reutilizar mis claves de API?
No. Tendrás que crear una nueva clave de API para tu cliente MCP. Recuerda dar acceso a tus herramientas de IA solo a aquello con lo que te sientas cómodo y evita conceder permisos elevados.
¿El servidor MCP de Braze está alojado localmente o de forma remota?
El servidor MCP de Braze está alojado localmente.
¿Por qué Cursor solo muestra funciones?
Comprueba si estás en modo de consulta o en modo de agente. Para utilizar el servidor MCP, debes estar en modo agente.
¿Qué hago cuando el agente devuelve una respuesta que parece incorrecta?
Cuando trabajes con herramientas como Cursor, es posible que quieras probar a cambiar el modelo utilizado. Por ejemplo, si lo tienes configurado en automático, prueba a cambiarlo a un modelo específico y experimenta para descubrir cuál es el modelo con mejor rendimiento para tu caso de uso. También puedes intentar iniciar un nuevo chat y volver a intentar el mensaje.
Si los problemas persisten, puedes enviarnos un correo electrónico a [email protected] para informarnos. Si es posible, incluye un video y amplía las funciones de llamada para que podamos ver qué llamadas intentó realizar el agente.
Descargo de responsabilidad
El Model Context Protocol (MCP) es un protocolo de código abierto recientemente introducido que, en este momento, puede ser susceptible a problemas de seguridad o vulnerabilidades.
El código y las instrucciones de configuración del servidor MCP de Braze se proporcionan «tal cual», sin garantías de ningún tipo, y los clientes los utilizan bajo su propia responsabilidad. Braze no se hará responsable de ninguna consecuencia derivada de una configuración incorrecta, un uso indebido del MCP o cualquier posible problema de seguridad que pueda surgir. Braze recomienda encarecidamente a los clientes que revisen cuidadosamente sus configuraciones y sigan las directrices descritas para reducir los riesgos asociados a la integridad y seguridad de su entorno Braze.
Si necesitas ayuda o aclaración, ponte en contacto con soporte de Braze.