Configurar el servidor Braze MCP
Aprende a conectarte al servidor remoto Braze MCP, autenticarte con OAuth y empezar a utilizar las herramientas de Braze desde tu cliente MCP. Para más información, consulta Servidor Braze MCP.
El servidor MCP de Braze alojado localmente (beta) está obsoleto y no recibe actualizaciones adicionales.
Requisitos previos
Antes de empezar, asegúrate de tener lo siguiente:
| Requisito previo | Descripción |
|---|---|
| Cliente MCP compatible | Cualquier cliente que admita servidores MCP remotos con OAuth puede funcionar. Braze ha verificado Claude, ChatGPT, Cursor, OpenAI Codex, Claude Code y Visual Studio Code. |
| Cuenta en el panel de Braze | Inicias sesión con tus credenciales habituales de Braze, incluido el inicio de sesión único o SAML si tu empresa lo utiliza. No hay un inicio de sesión MCP independiente. |
| Selección del endpoint del servidor | Elige https://mcp.braze.com/mcp (EE. UU.) o https://mcp.braze.eu/mcp (UE). Cualquiera de los dos endpoints puede llegar a cualquier clúster de Braze. |
| Sin lista de IP permitidas | Los clientes que utilizan la lista de IP permitidas no pueden utilizar el servidor Braze MCP en este momento. |
El acceso de tu agente refleja tus permisos en el panel. Si tu acceso al panel está limitado a un equipo en lugar de a un espacio de trabajo completo, es posible que algunas herramientas no funcionen.
Gestión de accesos (para administradores)
Antes de que los usuarios puedan conectarse, un administrador de la empresa debe activar el acceso MCP OAuth en Configuración > Configuración de administrador > OAuth. Para más información, consulta Gestionar la configuración de OAuth.
Conceder acceso
Los administradores controlan el acceso al servidor MCP a través del permiso “Use MCP Server”. De forma predeterminada, los usuarios no tienen este permiso y debe concederse explícitamente.
Revocar acceso
Para revocar el acceso, elimina el permiso “Use MCP Server” del usuario. Eliminar los permisos del panel de un usuario también elimina esas capacidades de cualquier agente conectado en la siguiente solicitud.
Si crees que un token se ha filtrado o se ha utilizado indebidamente, un administrador de la empresa puede revocar todos los tokens MCP OAuth de la empresa a la vez en Configuración > Configuración de administrador > OAuth. Todos los clientes conectados perderán el acceso y todos los usuarios deberán reconectarse. Para más información, consulta Revocar tokens MCP OAuth.
Auditar el uso
Cuando un usuario se conecta correctamente a través de OAuth, se registra un evento en el informe de eventos de seguridad.
Conecta tu cliente
Paso 1: Confirma los permisos y el acceso al espacio de trabajo
- Tú o el administrador de tu empresa deben confirmar que tienes el permiso “Use MCP Server”.
- Si necesitas acceso a varios espacios de trabajo, asegúrate de que el permiso esté habilitado para todos los espacios de trabajo relevantes.
Paso 2: Añade Braze como conector MCP remoto
En tu cliente MCP, añade un nuevo servidor remoto o conector personalizado e introduce tu URL de Braze MCP. Por ejemplo, en Claude puedes ir a Configuración > Conectores > Añadir conector personalizado y pegar la URL.
No se necesita ningún ID de cliente, secreto de cliente ni clave de API. Tu cliente se registra con Braze automáticamente.
Opciones de endpoint de Braze MCP:
https://mcp.braze.com/mcp(EE. UU.)https://mcp.braze.eu/mcp(UE)
Los clientes de la UE deben usar el endpoint de la UE. Los clientes fuera de la UE pueden usar cualquiera de los dos endpoints.
Guías de configuración de clientes:
Paso 3: Inicia sesión en Braze a través de OAuth
La primera vez que tu agente llame a una herramienta de Braze, tu cliente abrirá una ventana del navegador y te dirigirá a Braze para iniciar sesión.
- Inicia sesión en Braze como lo harías normalmente, incluyendo inicio de sesión único si es necesario.
- Si tu inicio de sesión puede acceder a más de una empresa en el mismo clúster, selecciona la empresa que deseas utilizar.
- En la pantalla de consentimiento, revisa el acceso que la aplicación está solicitando.
- Selecciona la casilla de verificación de aceptación para aceptar la Política de Privacidad de Braze y, a continuación, selecciona Continuar para volver a tu cliente MCP.
Tu sesión utiliza tokens de acceso de corta duración que se actualizan automáticamente. Es posible que ocasionalmente necesites iniciar sesión de nuevo.
Paso 4: Indica a tu agente qué espacio de trabajo usar
Si tu cuenta puede acceder a más de un espacio de trabajo, especifica el espacio de trabajo en tu prompt. Por ejemplo:
Me gustaría ver los análisis de Campaign de la última semana en el espacio de trabajo Production.¿Puedes comparar los análisis de esta semana entre mi espacio de trabajo prod-1 y mi espacio de trabajo prod-2?
Si no especificas un espacio de trabajo, tu agente puede pedirte que lo aclares.
Paso 5: Envía un prompt de prueba
Después de la configuración, envía un prompt de validación rápido, como:
Enumera las herramientas de Braze disponibles en este espacio de trabajo.Muestra mis Canvas recientes del espacio de trabajo Production.
Para más ejemplos, consulta Uso del servidor Braze MCP.
Ejemplo: Conectar con Claude
Conectar un cliente solo requiere unos pocos pasos. El siguiente tutorial usa Claude, pero el flujo es similar para otros clientes compatibles.
- En Claude, ve a Settings > Connectors > Add custom connector.
- Introduce un nombre, como
Braze, y luego pega tu URL de Braze MCP:https://mcp.braze.com/mcppara US ohttps://mcp.braze.eu/mcppara EU. No necesitas un ID de cliente, un secreto de cliente ni una clave de API. - Selecciona Add para guardar el conector. Claude se registra con Braze automáticamente.
- Selecciona Connect para iniciar la autenticación. Claude abre una ventana del navegador y te redirige a Braze para iniciar sesión.
- Inicia sesión en Braze con tus credenciales habituales, incluyendo inicio de sesión único si tu empresa lo utiliza. Si tu cuenta puede acceder a más de una empresa en el mismo clúster, selecciona la empresa que quieras usar.
- En la pantalla de consentimiento, revisa el acceso solicitado, marca la casilla de confirmación y selecciona Continue. Claude vuelve a tu chat y tu agente ya puede utilizar las herramientas de Braze.
Para confirmar la conexión, envía un mensaje de prueba como Show my recent Canvases from the Production workspace.
Migración desde el servidor beta local
Puedes ejecutar el servidor beta local y el servidor alojado de forma remota en paralelo durante la migración. Es posible que necesites indicar explícitamente a tu agente cuál usar.
El servidor alojado de forma remota incluye nuevas herramientas que no existen en el servidor beta local. Si creaste habilidades para el servidor local, es posible que necesites actualizar esas habilidades para hacer referencia a los nuevos nombres y comportamientos de las herramientas.
Después de confirmar que tus flujos de trabajo y habilidades funcionan en el servidor remoto, desactiva el servidor alojado localmente.
Solución de problemas
La autenticación falla en un cliente compatible
- Confirma que el administrador de tu empresa ha activado MCP OAuth access en la configuración de OAuth.
- Confirma que tu usuario tiene el permiso “Use MCP Server”.
- Vuelve a intentar el inicio de sesión y la autorización.
La autenticación se bloquea en un cliente no verificado
Braze mantiene una lista de dominios de clientes compatibles permitidos por seguridad. Si te conectas desde un cliente que no está en la lista de permitidos, la autenticación puede bloquearse. ¿Quieres support for your MCP client? Considera dejar comentarios sobre el producto.
Los clientes que se ejecutan localmente en tu máquina sin un esquema personalizado, como Claude Code y OpenAI Codex, también deberían funcionar.
Una conexión que funcionaba deja de autenticarse
Si tu cliente estaba conectado y ahora no logra autenticarse, es posible que el administrador de tu empresa haya revocado los tokens de MCP OAuth de tu empresa. Inicia sesión en Braze a través de tu cliente nuevamente para crear una nueva conexión. Si el inicio de sesión sigue fallando, confirma que MCP OAuth access está activado y que aún tienes el permiso “Use MCP Server”.
Las herramientas no aparecen en tu cliente
Si tu agente no puede listar las herramientas de Braze, espera unos minutos e inténtalo de nuevo. Estos problemas suelen ser temporales y se resuelven por sí solos.
El agente no puede acceder a las herramientas esperadas
- Confirma que tu usuario del panel tiene los permisos requeridos. Tu agente solo puede usar herramientas que coincidan con tu propio acceso al panel.
- Confirma que seleccionaste el espacio de trabajo esperado en tu prompt.
- Pide a tu agente que llame a
get_workspacesy verifica los ID de espacios de trabajo disponibles.
El agente usa el espacio de trabajo equivocado
Si tu cuenta puede acceder a más de un espacio de trabajo, nombra el espacio de trabajo en tu prompt usando el nombre exacto que se muestra en el panel de Braze. Si no especificas un espacio de trabajo, tu agente puede pedirte que lo aclares o usar uno inesperado.
Antes de que tu agente comience a trabajar, siempre confirma qué espacio de trabajo está utilizando. En algunos casos, un agente puede seleccionar un espacio de trabajo diferente al que pretendías.
Cambiar a una empresa diferente
Tu empresa se establece cuando autorizas por primera vez. Para trabajar en una empresa diferente en el mismo clúster, desconecta el conector de Braze en tu cliente, vuelve a autorizar y selecciona la otra empresa durante el inicio de sesión.
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.