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 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.

Importante

El servidor MCP de Braze alojado localmente (beta) está obsoleto y no recibe actualizaciones adicionales.

Nota

El servidor MCP de Braze incluye herramientas que solo están disponibles para los clientes que participan en programas beta. Si intentas acceder a una herramienta que forma parte de un programa beta y tu cuenta no tiene la característica habilitada, es posible que recibas una respuesta de error. Para unirte a un programa beta, ponte en contacto con tu director de cuentas.

Requisitos previos

Antes de poder usar esta característica, necesitarás configurar el servidor MCP de Braze.

Funciones API disponibles en 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 herramienta 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 campaña API y etiquetas.
`get_campaign_details`	`/campaigns/details`	lectura	Recupera información relevante sobre una campaña especificada mediante `campaign_id`.
`get_campaign_dataseries`	`/campaigns/data_series`	lectura	Series diarias de estadísticas de campaña a lo largo del tiempo (envíos, aperturas, clics, conversiones por canal).
`duplicate_campaign`	`/campaigns/duplicate`	creación	Duplica una campaña existente.
`create_campaign`^*	N/A	creación	Crea una nueva campaña.
`edit_campaign`^*	N/A	actualización	Edita una campaña existente.
`launch_campaign`^*	N/A	actualización	Lanza una campaña.
`stop_campaign`^*	N/A	actualización	Detiene una campaña en ejecución.
`archive_campaign`^*	N/A	actualización	Archiva una campaña.
`unarchive_campaign`^*	N/A	actualización	Desarchiva una campaña.
`get_campaign_draft`^*	N/A	lectura	Recupera los detalles de un borrador de campaña.
`get_campaign_live_details`^*	N/A	lectura	Recupera los detalles de una campaña en vivo.
`create_campaign_message`^*	N/A	creación	Crea un mensaje dentro de una campaña.
`update_campaign_message`^*	N/A	actualización	Actualiza un mensaje de campaña.
`delete_campaign_message`^*	N/A	eliminación	Elimina un mensaje de campaña.
`create_campaign_message_variation`^*	N/A	creación	Crea una variación de mensaje dentro de una campaña.
`update_campaign_message_variation`^*	N/A	actualización	Actualiza una variación de mensaje de campaña.
`delete_campaign_message_variation`^*	N/A	eliminación	Elimina una variación de mensaje de campaña.
`update_campaign_distribution`^*	N/A	actualización	Actualiza la configuración de distribución de una campaña.

^* Esta herramienta solo está disponible para los clientes que participan en el programa beta de API de Campaigns. Si tu cuenta no tiene esta característica habilitada, es posible que recibas un error al intentar usarla. Para unirte al programa beta, contacta a tu director de cuentas.

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 agregados 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 múltiples 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.
`create_catalog`	`/catalogs`	creación	Crea un catálogo.
`delete_catalog`	`/catalogs/{catalog_name}`	eliminación	Elimina un catálogo.
`create_catalog_fields`	`/catalogs/{catalog_name}/fields`	creación	Crea múltiples campos en un catálogo.
`delete_catalog_field`	`/catalogs/{catalog_name}/fields/{field_name}`	eliminación	Elimina un campo de catálogo.
`create_catalog_items`	`/catalogs/{catalog_name}/items`	creación	Crea múltiples elementos en un catálogo. Hasta 50 elementos por solicitud.
`edit_catalog_items`	`/catalogs/{catalog_name}/items`	actualización	Edita múltiples elementos existentes en un catálogo. Hasta 50 elementos por solicitud.
`replace_catalog_items`	`/catalogs/{catalog_name}/items`	actualización	Reemplaza múltiples elementos en un catálogo. Crea los elementos si no existen. Hasta 50 elementos por solicitud.
`delete_catalog_items`	`/catalogs/{catalog_name}/items`	eliminación	Elimina múltiples elementos en un catálogo. Hasta 50 elementos por solicitud.
`create_catalog_selection`	`/catalogs/{catalog_name}/selections`	creación	Crea una selección en un catálogo.
`delete_catalog_selection`	`/catalogs/{catalog_name}/selections/{selection_name}`	eliminación	Elimina una selección de catálogo.

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 los 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 período de tiempo designado.

Integraciones CDI

Herramienta	Endpoint de API	Acceso	Descripción
`list_integrations`	`/cdi/integrations`	lectura	Lista las integraciones de ingesta de datos en la nube existentes, 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.
`trigger_integration_sync`	`/cdi/integrations/{integration_id}/sync`	escritura	Desencadena una sincronización para una integración CDI determinada.

indicador clave de rendimiento

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	Sube 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.

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.

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.
`get_segment_filters`^*	N/A	lectura	Recupera las definiciones de filtros de Segment.
`create_segment`^*	N/A	creación	Crea un nuevo Segment.
`edit_segment`^*	N/A	actualización	Edita un Segment existente.

^* Esta herramienta solo está disponible para los clientes que participan en el programa beta de API de Segments. Si tu cuenta no tiene esta característica habilitada, es posible que recibas un error al intentar usarla. Para unirte al programa beta, contacta a tu director de cuentas.

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 período de tiempo designado.

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	Obtiene información de una plantilla de correo electrónico específica. Las plantillas del editor de arrastrar y soltar no se aceptan.
`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 información de los bloques de contenido existentes.
`get_content_block_info`	`/content_blocks/info`	lectura	Obtiene información de 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.

Operator

Herramienta	Endpoint de API	Acceso	Descripción
`send_operator_prompt`	N/A	actualización	Envía un prompt en lenguaje natural a BrazeAI Operator. Envía un trabajo en segundo plano y devuelve un job_id.
`get_operator_result`	N/A	lectura	Consulta el resultado de un trabajo de Operator enviado mediante su job_id.
`cancel_operator_job`	N/A	actualización	Cancela un trabajo de Operator en ejecución.

Importante

Estas herramientas solo están disponibles para los clientes que participan en el programa beta de Operator. Si tu cuenta no tiene esta característica habilitada, es posible que recibas un error al intentar usarla. Para unirte al programa beta, contacta a tu director de cuentas.

Descargo de responsabilidad

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!