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 siga el estándar MCP para servidores remotos, se autentique con OAuth y se registre mediante el registro dinámico de clientes (Dynamic Client Registration) o un documento de metadatos de ID de cliente (Client ID Metadata Document). Los clientes que solo aceptan un ID de cliente y un secreto de cliente estáticos no pueden conectarse. Braze ha probado Claude, ChatGPT, Cursor, OpenAI Codex, Claude Code y Visual Studio Code. |
| URI de redireccionamiento aprobado | Un administrador de la empresa debe aprobar el URI de redireccionamiento de tu cliente en Configuración > Configuración de administrador > Conexiones externas. El administrador puede copiarlo desde la configuración de OAuth o del conector del cliente. Para más información, consulta Administrar la configuración de OAuth. |
| Cuenta del 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 independiente para MCP. |
| 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 acceder a cualquier clúster de Braze. |
| Cuenta de Braze de pago | El servidor MCP de Braze no está disponible para cuentas de prueba gratuitas. |
| Sin lista de IP permitidas | Los clientes que utilizan la lista de direcciones IP permitidas no pueden usar el servidor MCP de Braze por el momento. |
El acceso de tu agente refleja tus permisos del 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.
Gestionar el acceso (para administradores)
Antes de que los usuarios puedan conectarse, un administrador de la empresa debe activar el Acceso OAuth de MCP en Configuración > Configuración de administrador > Conexiones externas. Para obtener más información, consulta Gestionar la configuración de OAuth.
Conceder acceso
Los administradores controlan el acceso al servidor MCP mediante el permiso “Use MCP Server”. De forma predeterminada, los usuarios no tienen este permiso, así que hay que concederlo explícitamente.
Revocar el acceso
Para revocar el acceso, quita al usuario el permiso “Use MCP Server”. Si quitas permisos del panel a un usuario, esas capacidades también se eliminan de cualquier agente conectado en la siguiente solicitud.
Si crees que se ha filtrado o se ha hecho un uso indebido de un token, un administrador de la empresa puede revocar a la vez todos los tokens OAuth de MCP de la empresa en Configuración > Configuración de administrador > Conexiones externas. Todos los clientes conectados pierden el acceso y todos los usuarios deben volver a conectarse. Para obtener más información, consulta Revocar tokens OAuth de MCP.
Auditar el uso
Cuando un usuario se conecta correctamente mediante 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
- Confirma que tienes el permiso “Use MCP Server” o pide al administrador de tu empresa que lo verifique por ti.
- Si necesitas acceso a varios espacios de trabajo, asegúrate de que el permiso esté habilitado en todos los espacios de trabajo pertinentes.
- Pide al administrador de tu empresa que confirme que el URI de redireccionamiento de tu cliente está aprobado en la configuración de OAuth. Si no lo está, no podrás terminar de iniciar sesión en Braze en el Paso 3.
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 MCP de Braze. 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 automáticamente en Braze. El registro no aprueba el URI de redireccionamiento del cliente para tu empresa, así que un administrador sigue teniendo que aprobarlo como se describe en el Paso 1.
Opciones de endpoint MCP de Braze:
https://mcp.braze.com/mcp(EE. UU.)https://mcp.braze.eu/mcp(UE)
Los clientes de la UE deben utilizar el endpoint de la UE. Los clientes de fuera de la UE pueden utilizar cualquiera de los dos endpoints.
Guías de configuración de clientes:
Paso 3: Inicia sesión en Braze mediante OAuth
La primera vez que tu agente llama a una herramienta de Braze, tu cliente abre una ventana del navegador y te dirige a Braze para iniciar sesión.
- Inicia sesión en Braze como lo haces normalmente, incluido el 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 quieres utilizar.
- En la pantalla de consentimiento, revisa el acceso que solicita la aplicación.
- Marca la casilla de confirmació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 de vez en cuando tengas que volver a iniciar sesión.
Paso 4: Indica a tu agente qué espacio de trabajo debe usar
Si tu cuenta puede acceder a más de un espacio de trabajo, especifica el espacio de trabajo en tu prompt. Por ejemplo:
I'd like to look at campaign analytics for the past week in the Production workspace.Can you compare this week's analytics between my prod-1 workspace and my prod-2 workspace?
Si no especificas un espacio de trabajo, es posible que tu agente te pida que lo aclares.
Paso 5: Envía un prompt de prueba
Después de la configuración, envía un prompt rápido de validación, como por ejemplo:
List the Braze tools available in this workspace.Show my recent Canvases from the Production workspace.
Para ver más ejemplos, consulta Uso del servidor MCP de Braze.
Ejemplo: Conectar con Claude
Conectar un cliente solo requiere unos pocos pasos. La siguiente guía usa Claude, pero el flujo es similar para otros clientes compatibles.
Antes de empezar, asegúrate de que un administrador de la empresa haya aprobado el URI de redirección de tu cliente, como se describe en el Paso 1.
- 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 EE. UU. ohttps://mcp.braze.eu/mcppara la UE. No necesitas un ID de cliente, un secreto de cliente ni una clave de API. - Selecciona Add para guardar el conector. Claude se registra automáticamente con Braze, pero esto no aprueba su URI de redirección para tu empresa.
- 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, incluido el inicio de sesión único si tu empresa lo utiliza. Si tu inicio de sesión puede acceder a más de una empresa en el mismo clúster, selecciona la empresa que quieres usar.
- En la pantalla de consentimiento, revisa el acceso solicitado, marca la casilla de confirmación y luego selecciona Continue. Claude vuelve a tu chat y tu agente ya puede usar 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 remotamente en paralelo durante la migración. Es posible que tengas que indicarle explícitamente a tu agente cuál debe usar.
El servidor alojado remotamente incluye herramientas nuevas que no existen en el servidor beta local. Si creaste skills para el servidor local, es posible que tengas que actualizarlas para que hagan referencia a los nuevos nombres y comportamientos de las herramientas.
Después de confirmar que tus flujos de trabajo y skills funcionan en el servidor remoto, desactiva el servidor alojado localmente.
Solución de problemas
Falla la autenticación en MCP
- Confirma que el administrador de tu empresa ha activado el acceso OAuth de MCP en la configuración de OAuth.
- Confirma que tu usuario tiene el permiso “Usar servidor MCP”.
- Confirma que el URI de redireccionamiento de tu cliente está aprobado. Si ves “Esta aplicación necesita aprobación” o un error genérico como “Se ha producido un error inesperado” en el paso de consentimiento, pide al administrador de tu empresa que confirme que el estado del URI de redireccionamiento es Aprobado en la configuración de OAuth.
- Vuelve a intentar iniciar sesión y autorizar.
Una conexión que funcionaba deja de autenticarse
Si tu cliente estaba conectado y ahora no consigue autenticarse, es posible que el administrador de tu empresa haya revocado los tokens OAuth de MCP de tu empresa. Vuelve a iniciar sesión en Braze desde tu cliente para crear una nueva conexión. Si el inicio de sesión sigue fallando, confirma que el acceso OAuth de MCP está activado y que sigues teniendo el permiso “Usar servidor MCP”.
Las herramientas no aparecen en tu cliente
Si tu agente no puede enumerar las herramientas de Braze, espera unos minutos y vuelve a intentarlo. Estos problemas suelen ser temporales y se resuelven solos.
El agente no puede acceder a las herramientas esperadas
- Confirma que tu usuario del panel tiene los permisos necesarios. Tu agente solo puede usar las herramientas que coinciden 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 espacio de trabajo disponibles.
El agente usa el espacio de trabajo equivocado
Si tu cuenta puede acceder a más de un espacio de trabajo, indica el espacio de trabajo en tu prompt con el nombre exacto que aparece en el panel de Braze. Si no especificas un espacio de trabajo, es posible que tu agente te pida que lo aclares o que use uno inesperado.
Antes de que tu agente empiece a trabajar, confirma siempre qué espacio de trabajo está usando. En algunos casos, un agente puede seleccionar un espacio de trabajo distinto del que pretendías.
Cambiar a otra empresa
Tu empresa se establece la primera vez que autorizas. Para trabajar en otra empresa del mismo clúster, desconecta el conector de Braze en tu cliente, vuelve a autorizar y selecciona la otra empresa al iniciar 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.