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
Inscripción en acceso anticipado Tu director de cuentas puede inscribir a tu empresa en el programa de acceso anticipado.
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 SSO 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 participar en el acceso anticipado 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 explícitamente.

Si un administrador no ve este permiso, contacta a tu director de cuentas de Braze para solicitar la inscripción en el Acceso Anticipado.

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.

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

  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 de Braze MCP. Por ejemplo, en Claude puedes ir a Settings > Connectors > Add custom connector y pegar la URL.

No se requiere 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 (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 dirigirá a Braze para iniciar sesión.

  1. Inicia sesión en Braze como lo harías normalmente, incluyendo SSO 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 usar.
  3. En la pantalla de consentimiento, revisa el acceso que la aplicación está solicitando.
  4. Selecciona la casilla de verificación de aceptación 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 verificación de aceptación 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 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, 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 solo requiere unos pocos pasos. El siguiente tutorial usa Claude, pero el flujo es similar para otros clientes compatibles.

  1. En Claude, ve a Settings > Connectors > Add custom connector.
  2. Introduce un nombre, como Braze, y luego 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, un secreto de cliente ni una clave de API.
  3. Selecciona Add para guardar el conector. Claude se registra automáticamente con Braze.
  4. Selecciona Connect para iniciar la autenticación. Claude abre una ventana del navegador y te redirige a Braze para iniciar sesión.
  5. Inicia sesión en Braze con tus credenciales habituales, incluyendo SSO 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 deseas usar.
  6. En la pantalla de consentimiento, revisa el acceso solicitado, selecciona la casilla de verificación de reconocimiento y luego selecciona Continue. Claude regresa 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 de forma remota en paralelo durante la migración. Es posible que necesites indicar explícitamente a tu agente cuál utilizar.

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

  1. Confirma que tu empresa está inscrita en el Acceso Anticipado.
  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 está bloqueada en un cliente no verificado

Durante el Acceso Anticipado, 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. Si crees que tu cliente debería ser compatible, contacta a [email protected].

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.

Si el problema continúa, graba un video y envíalo a [email protected] para su investigación.

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 espacios de trabajo disponibles.

El agente usa el espacio de trabajo incorrecto

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!