Esta página fue traducida automáticamente y puede contener errores. Para informar de un error de traducción, usa el componente de comentarios situado bajo el sumario, a la derecha de la página.

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, con los permisos adecuados, realizar acciones de escritura sin PII. Para obtener información más general, consulta Servidor MCP de Braze.

Importante

El servidor MCP de Braze está en fase beta. No necesitas solicitar acceso para usarlo. Sigue las instrucciones de configuración para empezar. Al usar el servidor MCP de Braze, aceptas los Términos beta de Braze. Para ayudarnos a mejorarlo, envía tus comentarios a [email protected].

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 Campaigns con metadatos.
`get_campaign_details`	`/campaigns/details`	Obtén información detallada sobre Campaigns específicas.
`get_campaign_dataseries`	`/campaigns/data_series`	Recupera datos de análisis de series temporales para Campaigns.

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

Las funciones create_content_block y update_content_block son funciones de escritura. Tu cliente MCP debe llamarlas con call_write_function, y tu clave de API debe tener el permiso correspondiente content_blocks.create o content_blocks.update.

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.
`create_content_block`	`/content_blocks/create`	Crea un bloque de contenido. Requiere `name` y `content`. Los campos opcionales son `description`, `state` (debe ser `active` o `draft`) y `tags`.
`update_content_block`	`/content_blocks/update`	Actualiza un bloque de contenido existente. Requiere `content_block_id` y al menos un campo actualizable: `name`, `content`, `description`, `state` (debe ser `active` o `draft`) o `tags`.

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

La función create_media_library_asset es una función de escritura. Tu cliente MCP debe llamarla con call_write_function, y 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 Campaigns 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

Las funciones create_email_template y update_email_template son funciones de escritura. Tu cliente MCP debe llamarlas con call_write_function, y tu clave de API debe tener el permiso correspondiente templates.email.create o templates.email.update.

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.
`create_email_template`	`/templates/email/create`	Crea una plantilla de correo electrónico. Requiere `template_name`, `subject` y `body`. Los campos opcionales son `plaintext_body`, `preheader`, `tags` y `should_inline_css`.
`update_email_template`	`/templates/email/update`	Actualiza una plantilla de correo electrónico existente. Requiere `email_template_id` y al menos un campo actualizable: `template_name`, `subject`, `body`, `plaintext_body`, `preheader`, `tags` o `should_inline_css`.

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.

New Stuff!