Skip to content

Funciones del servidor MCP de Braze

El servidor MCP de Braze expone herramientas de lectura y escritura que se corresponden con endpoints específicos de la REST API de Braze. Para más información, consulta Servidor MCP de Braze.

Requisitos previos

Antes de poder utilizar esta característica, tendrás que configurar el servidor MCP de Braze.

Funciones disponibles de la API de Braze

Tu cliente MCP hace referencia a estas herramientas para interactuar con el servidor MCP de Braze.

Espacios de trabajo

Herramienta Endpoint de API Acceso Descripción
get_workspaces N/A lectura Descubre a qué espacios de trabajo de Braze puede acceder el token de acceso OAuth actual. Llama a esta función primero: cada id de espacio de trabajo devuelto es el app_group_id que requieren todas las demás herramientas.

Campaigns

Herramienta Endpoint de API Acceso Descripción
get_campaign_list /campaigns/list lectura Exporta una lista de Campaigns con nombre, identificador de API de la campaña, indicador de API-campaign y etiquetas.
get_campaign_details /campaigns/details lectura Recupera información relevante sobre una Campaign específica mediante campaign_id.
get_campaign_dataseries /campaigns/data_series lectura Serie diaria de estadísticas de Campaigns a lo largo del tiempo (envíos, aperturas, clics, conversiones por canal).

Canvas

Herramienta Endpoint de API Acceso Descripción
get_canvas_list /canvas/list lectura Exporta una lista de Canvas con nombre, identificador de API de Canvas y etiquetas.
get_canvas_details /canvas/details lectura Exporta metadatos de Canvas: nombre, fecha de creación, estado actual y más.
get_canvas_data_series /canvas/data_series lectura Exporta datos de series temporales para un Canvas.
get_canvas_data_summary /canvas/data_summary lectura Exporta resúmenes acumulados de datos de series temporales de Canvas para un resumen conciso de resultados.

Catálogos

Herramienta Endpoint de API Acceso Descripción
get_catalogs /catalogs lectura Lista los catálogos en un espacio de trabajo.
get_catalog_items /catalogs/{catalog_name}/items lectura Devuelve varios elementos del catálogo y su contenido.
get_catalog_item /catalogs/{catalog_name}/items/{item_id} lectura Devuelve un único elemento del catálogo y su contenido.

Atributos personalizados

Herramienta Endpoint de API Acceso Descripción
get_custom_attributes /custom_attributes lectura Exporta los atributos personalizados registrados para tu aplicación, en grupos de 50, en orden alfabético.

Eventos personalizados

Herramienta Endpoint de API Acceso Descripción
get_events /events lectura Exporta los eventos personalizados registrados para tu aplicación, en grupos de 50, en orden alfabético (paginación por cursor).
get_events_list /events/list lectura Exporta nombres de eventos personalizados, en grupos de 250, en orden alfabético (paginación por página).
get_events_data_series /events/data_series lectura Ocurrencias de un evento personalizado durante un periodo de tiempo designado.

Integraciones CDI

Herramienta Endpoint de API Acceso Descripción
list_integrations /cdi/integrations lectura Lista las integraciones existentes de Cloud Data Ingestion, 10 por llamada.
get_integration_job_sync_status /cdi/integrations/{integration_id}/job_sync_status lectura Estados de sincronización anteriores para una integración CDI determinada, 10 por llamada.

KPI

Herramienta Endpoint de API Acceso Descripción
get_dau_data_series /kpi/dau/data_series lectura Serie diaria de usuarios activos únicos por fecha.
get_mau_data_series /kpi/mau/data_series lectura Serie diaria de usuarios activos únicos en una ventana móvil de 30 días.
get_new_users_data_series /kpi/new_users/data_series lectura Serie diaria del total de nuevos usuarios por fecha.
get_uninstalls_data_series /kpi/uninstalls/data_series lectura Serie diaria del total de desinstalaciones por fecha.

Biblioteca de medios

Herramienta Endpoint de API Acceso Descripción
create_media_library_asset /media_library/create creación Carga un activo a la biblioteca de medios de Braze mediante una URL externa o contenido de archivo en base64. Se debe proporcionar exactamente un modo de carga.

Mensajes

Herramienta Endpoint de API Acceso Descripción
get_scheduled_broadcasts /messages/scheduled_broadcasts lectura Lista las Campaigns programadas y los Canvas de entrada entre el momento actual y un end_time designado.

Compras

Herramienta Endpoint de API Acceso Descripción
get_product_list /purchases/product_list lectura Lista paginada de ID de productos.
get_quantity_series /purchases/quantity_series lectura Número total de compras en tu aplicación durante un rango de tiempo.
get_revenue_series /purchases/revenue_series lectura Total de dinero gastado en tu aplicación durante un rango de tiempo.

Autenticación SDK

Herramienta Endpoint de API Acceso Descripción
get_sdk_authentication_keys /app_group/sdk_authentication/keys lectura Recupera todas las claves de autenticación SDK para una aplicación.

Segments

Herramienta Endpoint de API Acceso Descripción
get_segment_list /segments/list lectura Exporta Segments con nombre, identificador de API de Segment e indicador de seguimiento de análisis.
get_segment_details /segments/details lectura Recupera información relevante sobre un Segment mediante segment_id.
get_segment_data_series /segments/data_series lectura Serie diaria del tamaño estimado de un Segment a lo largo del tiempo.

Envíos

Herramienta Endpoint de API Acceso Descripción
get_send_data_series /sends/data_series lectura Estadísticas diarias para un send_id con seguimiento (Campaigns de API). Braze almacena los análisis de envío durante 14 días después del envío.

Sesiones

Herramienta Endpoint de API Acceso Descripción
get_session_data_series /sessions/data_series lectura Número de sesiones de tu aplicación durante un periodo de tiempo designado.

Grupos de suscripción

Herramienta Endpoint de API Acceso Descripción
get_subscription_group_status /subscription/status/get lectura Estado de suscripción de un usuario en un grupo de suscripción.
get_user_subscription_groups /subscription/user/status lectura Lista los grupos de suscripción de un usuario.

Plantillas

Herramienta Endpoint de API Acceso Descripción
get_email_templates /templates/email/list lectura Lista las plantillas de correo electrónico disponibles en tu cuenta de Braze.
get_email_template_info /templates/email/info lectura Obtén información sobre una plantilla de correo electrónico específica. No se aceptan plantillas del editor de arrastrar y soltar.
create_email_template /templates/email/create creación Crea una plantilla de correo electrónico en el panel de Braze.
update_email_template /templates/email/update actualización Actualiza una plantilla de correo electrónico existente.

Content Blocks

Herramienta Endpoint de API Acceso Descripción
get_content_blocks /content_blocks/list lectura Lista la información de los bloques de contenido existentes.
get_content_block_info /content_blocks/info lectura Obtén información sobre un bloque de contenido existente, opcionalmente con datos de inclusión en Campaigns o Canvas.
create_content_block /content_blocks/create creación Crea un bloque de contenido.
update_content_block /content_blocks/update actualización Actualiza un bloque de contenido.

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!