Skip to content

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.

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 normales de Braze, incluido inicio de sesión único o SAML si tu empresa lo utiliza. No hay un inicio de sesión MCP independiente.
Selección de 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 usar el servidor Braze MCP en este momento.

Gestión de acceso (para administradores)

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 de forma explícita.

Revocar acceso

Para revocar el acceso, elimina el permiso “Use MCP Server” del usuario. Al eliminar los permisos del panel a un usuario, también se eliminan esas capacidades de cualquier agente conectado en la siguiente solicitud.

Auditar 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

  1. Tú o el administrador de tu empresa deben confirmar que tienes el permiso “Use MCP Server”.
  2. 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 MCP de Braze. Por ejemplo, en Claude puedes ir a Settings > Connectors > Add custom connector y pegar la URL.

No se necesita ID de cliente, secreto de cliente ni clave de API. Tu cliente se registra con Braze automáticamente.

Opciones de endpoint MCP de Braze:

  • https://mcp.braze.com/mcp (US)
  • https://mcp.braze.eu/mcp (EU)

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 enviará a Braze para iniciar sesión.

  1. Inicia sesión en Braze como lo harías normalmente, incluyendo inicio de sesión único si es necesario.
  2. 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.
  3. En la pantalla de consentimiento, revisa el acceso que la aplicación está solicitando.
  4. Selecciona la casilla de reconocimiento para aceptar la Política de Privacidad de Braze y luego selecciona Continue para volver a tu cliente MCP.

La pantalla de consentimiento de Braze que muestra que Claude Desktop está solicitando acceso a la información de la cuenta de Braze y acceso amplio a los datos de Braze, con una casilla de reconocimiento de la Política de Privacidad y los botones Cancel y Continue.

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 utilizar

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, 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:

  • List the Braze tools available in this workspace.
  • Show my recent Canvases from the Production workspace.

Para más ejemplos, consulta Uso del servidor Braze MCP.

Ejemplo: conectar con Claude

Conectar un cliente toma solo unos pasos. El siguiente tutorial usa Claude, pero el flujo es similar para otros clientes compatibles.

  1. En Claude, ve a Configuración > Conectores > Agregar conector personalizado.
  2. Introduce un nombre, como Braze, y pega tu URL de Braze MCP: https://mcp.braze.com/mcp para US o https://mcp.braze.eu/mcp para EU. No necesitas un ID de cliente, secreto de cliente ni clave de API.
  3. Selecciona Agregar para guardar el conector. Claude se registra con Braze automáticamente.
  4. Selecciona Conectar para iniciar la autenticación. Claude abre una ventana del navegador y te dirige a Braze para iniciar sesión.
  5. Inicia sesión en Braze con tus credenciales habituales, incluido 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 quieras usar.
  6. En la pantalla de consentimiento, revisa el acceso solicitado, selecciona la casilla de reconocimiento y luego selecciona Continuar. 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 en remoto en paralelo durante la migración. Es posible que necesites indicar explícitamente a tu agente cuál usar.

El servidor alojado en remoto 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 en local.

Solución de problemas

La autenticación falla en un cliente compatible

  1. Confirma que el administrador de tu empresa ha activado Acceso OAuth de MCP en la configuración de OAuth.
  2. Confirma que tu usuario tiene el permiso “Use MCP Server”.
  3. 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.

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

  1. Confirma que tu usuario del panel tiene los permisos necesarios. Tu agente solo puede usar herramientas que coincidan con tu propio acceso al panel.
  2. Confirma que seleccionaste el espacio de trabajo esperado en tu prompt.
  3. Pide a tu agente que llame a get_workspaces y 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, 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 aclares o usar uno inesperado.

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.

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.
New Stuff!