Funciones del servidor MCP de Braze

El servidor MCP de Braze expone un conjunto de funciones API que se corresponden con puntos finales específicos de la REST API de Braze. Los clientes MCP como Claude y Cursor pueden llamar a estas funciones para recuperar datos sin PII y realizar acciones de escritura sin PII. Para obtener información más general, 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 las siguientes funciones API para interactuar con el servidor MCP de Braze.

Funciones generales

Estas funciones ayudan a tu cliente MCP a descubrir y ejecutar las funciones disponibles de la API de Braze.

Función	Descripción
list_functions	Enumera todas las funciones disponibles de la API de Braze con sus descripciones y parámetros.
call_function	Llama a una función específica de solo lectura de la API de Braze con los parámetros proporcionados.
call_write_function	Llama a una función específica de escritura de la API de Braze con los parámetros proporcionados.

Campaigns

Función	Punto de conexión	Descripción
get_campaign_list	/campaigns/list	Exporta una lista de campañas con metadatos.
get_campaign_details	/campaigns/details	Obtén información detallada sobre campañas específicas.
get_campaign_dataseries	/campaigns/data_series	Recupera datos de análisis de series temporales para campañas.

Canvas

Función	Punto de conexión	Descripción
get_canvas_list	/canvas/list	Exporta una lista de Canvas con metadatos.
get_canvas_details	/canvas/details	Obtén información detallada sobre Canvas específicos.
get_canvas_data_summary	/canvas/data_summary	Obtén análisis resumidos del rendimiento de Canvas.
get_canvas_data_series	/canvas/data_series	Recupera datos de análisis de series temporales para Canvas.

Catálogos

Función	Punto de conexión	Descripción
get_catalogs	/catalogs	Devuelve una lista de catálogos en un espacio de trabajo.
get_catalog_items	/catalogs/{catalog_name}/items	Devuelve varios elementos del catálogo y su contenido con soporte para paginación.
get_catalog_item	/catalogs/{catalog_name}/items/{item_id}	Devuelve un elemento específico del catálogo y su contenido por ID.

Ingesta de datos de Cloud

Función	Punto de conexión	Descripción
list_integrations	/cdi/integrations	Devuelve una lista de integraciones CDI existentes.
get_integration_job_sync_status	/cdi/integrations/{integration_id}/job_sync_status	Devuelve los estados de sincronización anteriores para una integración CDI determinada.

Content Blocks

Función	Punto de conexión	Descripción
get_content_blocks_list	/content_blocks/list	Enumera los bloques de contenido disponibles.
get_content_blocks_info	/content_blocks/info	Obtén información sobre tus bloques de contenido.

Atributos personalizados

Función	Punto de conexión	Descripción
get_custom_attributes	/custom_attributes	Exporta los atributos personalizados registrados para tu aplicación.

Eventos

Función	Punto de conexión	Descripción
get_events_list	/events/list	Exporta una lista de eventos personalizados registrados para tu aplicación.
get_events_data_series	/events/data_series	Recupera datos de series temporales para eventos personalizados.
get_events	/events	Obtén datos detallados sobre los eventos con soporte para paginación.

KPI

Función	Punto de conexión	Descripción
get_new_users_data_series	/kpi/new_users/data_series	Serie diaria de recuentos de nuevos usuarios.
get_dau_data_series	/kpi/dau/data_series	Datos de series temporales de usuarios activos diarios.
get_mau_data_series	/kpi/mau/data_series	Datos de series temporales de usuarios activos al mes.
get_uninstalls_data_series	/kpi/uninstalls/data_series	Datos de series temporales de desinstalaciones de la aplicación.

Biblioteca de medios

Esta es la única función de escritura en el servidor MCP de Braze. Para usarla, tu clave de API debe tener el permiso media_library.create.

Función	Punto de conexión	Descripción
create_media_library_asset	/media_library/create	Carga un activo a tu biblioteca de medios de Braze. Puedes proporcionar una URL de acceso público (asset_url) o un archivo codificado en base64 (asset_file_base64), pero no ambos. Las imágenes tienen un límite de tamaño de 5 MB.

Mensajes

Función	Punto de conexión	Descripción
get_scheduled_broadcasts	/messages/scheduled_broadcasts	Enumera las próximas Campaigns y Canvas programados.

Centros de preferencias

Función	Punto de conexión	Descripción
get_preference_centers	/preference_center/v1/list	Enumera los centros de preferencias disponibles.
get_preference_center_details	/preference_center/v1/{preferenceCenterExternalID}	Muestra los detalles de un centro de preferencias específico, incluido el contenido HTML y las opciones.

Compras

Función	Punto de conexión	Descripción
get_product_list	/purchases/product_list	Exporta una lista paginada de ID de productos.
get_revenue_series	/purchases/revenue_series	Datos de series temporales de análisis de ingresos.
get_quantity_series	/purchases/quantity_series	Datos de series temporales de cantidades de compras.

Segments

Función	Punto de conexión	Descripción
get_segment_list	/segments/list	Exporta una lista de Segments con el estado de seguimiento de análisis.
get_segment_data_series	/segments/data_series	Datos de análisis de series temporales para Segments.
get_segment_details	/segments/details	Información detallada sobre Segments específicos.

Envíos

Función	Punto de conexión	Descripción
get_send_data_series	/sends/data_series	Análisis diarios de los envíos de campañas con seguimiento.

Sesiones

Función	Punto de conexión	Descripción
get_session_data_series	/sessions/data_series	Datos de series temporales del recuento de sesiones de la aplicación.

Claves de Autenticación SDK

Función	Punto de conexión	Descripción
get_sdk_authentication_keys	/app_group/sdk_authentication/keys	Enumera todas las claves de Autenticación SDK para tu aplicación.

Suscripción

Función	Punto de conexión	Descripción
get_user_subscription_groups	/subscription/user/status	Enumera y obtiene los grupos de suscripción de un usuario determinado.
get_subscription_group_status	/subscription/status/get	Obtiene el estado de suscripción de un usuario en un grupo de suscripción.

Plantillas

Función	Punto de conexión	Descripción
get_email_templates_list	/templates/email/list	Enumera las plantillas de correo electrónico disponibles.
get_email_template_info	/templates/email/info	Obtén información sobre tus plantillas de correo electrónico.

Descargo de responsabilidad

El Model Context Protocol (MCP) es un protocolo de código abierto recientemente introducido que, en este momento, puede ser susceptible a problemas de seguridad o vulnerabilidades.

El código y las instrucciones de configuración del servidor MCP de Braze se proporcionan «tal cual», sin garantías de ningún tipo, y los clientes los utilizan bajo su propia responsabilidad. Braze no se hará responsable de ninguna consecuencia derivada de una configuración incorrecta, un uso indebido del MCP o cualquier posible problema de seguridad que pueda surgir. Braze recomienda encarecidamente a los clientes que revisen cuidadosamente sus configuraciones y sigan las directrices descritas para reducir los riesgos asociados a la integridad y seguridad de su entorno Braze.

Si necesitas ayuda o aclaración, ponte en contacto con soporte de Braze.