Zum Inhalt springen

Funktionen des Braze MCP-Servers

Der Braze MCP-Server stellt Tools zum Lesen und Schreiben bereit. Die meisten davon sind Braze REST API-Endpunkten zugeordnet. Einige sind nur über den MCP-Server verfügbar. Weitere Informationen finden Sie unter Braze MCP-Server.

Voraussetzungen

Bevor Sie dieses Feature nutzen können, müssen Sie den Braze MCP-Server einrichten.

Verfügbare Braze-API-Funktionen

Ihr MCP-Client nutzt diese Tools, um mit dem Braze MCP-Server zu interagieren. Tools mit der Kennzeichnung „Nur MCP“ in der Spalte API-Endpunkt sind ausschließlich über den Braze MCP-Server verfügbar. Für sie gibt es keinen entsprechenden öffentlichen REST API-Endpunkt.

Workspaces

Tool API-Endpunkt Zugriff Berechtigung Beschreibung
get_workspaces Nur MCP Lesen Keine Ermitteln Sie, auf welche Braze-Workspaces das aktuelle OAuth-Zugriffstoken zugreifen kann. Rufen Sie dieses Tool zuerst auf: Jede zurückgegebene Workspace-id ist die app_group_id, die alle anderen Tools benötigen.

Campaigns

Tool API-Endpunkt Zugriff Berechtigung Beschreibung
get_campaign_list /campaigns/list Lesen Kampagnen-Analytics anzeigen Exportieren Sie eine Liste von Kampagnen mit Name, API-Bezeichner der Kampagne, API-Kampagnen-Flag und Tags.
get_campaign_details /campaigns/details Lesen Kampagnen-Analytics anzeigen Rufen Sie relevante Informationen zu einer bestimmten Kampagne anhand der campaign_id ab.
get_campaign_dataseries /campaigns/data_series Lesen Kampagnen-Analytics anzeigen Tägliche Reihe von Kampagnenstatistiken im Zeitverlauf (Sendungen, Öffnungen, Klicks, Conversions nach Kanal).
duplicate_campaign /campaigns/duplicate Erstellen Kampagnen erstellen Eine bestehende Kampagne duplizieren.
create_campaign Nur MCP Erstellen Kampagnen erstellen Eine neue Kampagne erstellen.
edit_campaign Nur MCP Aktualisieren Kampagnen bearbeiten Eine bestehende Kampagne bearbeiten.
launch_campaign* Nur MCP Aktualisieren Kampagnen starten Eine Kampagne starten.
stop_campaign Nur MCP Aktualisieren Kampagnen stoppen Eine laufende Kampagne stoppen.
archive_campaign* Nur MCP Aktualisieren Kampagnen archivieren Eine Kampagne archivieren.
unarchive_campaign* Nur MCP Aktualisieren Kampagnen archivieren Die Archivierung einer Kampagne aufheben.
get_campaign_draft Nur MCP Lesen Kampagnen-Analytics anzeigen Details eines Kampagnenentwurfs abrufen.
get_campaign_live_details Nur MCP Lesen Kampagnen-Analytics anzeigen Details einer aktiven Kampagne abrufen.
create_campaign_message Nur MCP Erstellen Kampagnen bearbeiten Eine Nachricht innerhalb einer Kampagne erstellen.
update_campaign_message Nur MCP Aktualisieren Kampagnen bearbeiten Eine Kampagnennachricht aktualisieren.
delete_campaign_message Nur MCP Löschen Kampagnen bearbeiten Eine Kampagnennachricht löschen.
create_campaign_message_variation Nur MCP Erstellen Kampagnen bearbeiten Eine Nachrichtenvariante innerhalb einer Kampagne erstellen.
update_campaign_message_variation Nur MCP Aktualisieren Kampagnen bearbeiten Eine Nachrichtenvariante einer Kampagne aktualisieren.
delete_campaign_message_variation Nur MCP Löschen Kampagnen bearbeiten Eine Nachrichtenvariante einer Kampagne löschen.
update_campaign_distribution Nur MCP Aktualisieren Kampagnen bearbeiten Die Verteilungseinstellungen einer Kampagne aktualisieren.

Die Kampagnen-Tools sind allgemein verfügbar und erfordern keine Teilnahme an einem Betaprogramm – mit Ausnahme der mit einem Sternchen (*) gekennzeichneten Tools.

* Dieses Tool ist nur für Kund:innen verfügbar, die am Betaprogramm für Kampagnen-APIs teilnehmen. Wenn dieses Feature für Ihr Konto nicht aktiviert ist, erhalten Sie bei der Verwendung möglicherweise eine Fehlermeldung. Wenden Sie sich an Ihren Account Manager, um am Betaprogramm teilzunehmen.

Canvases

Tool API-Endpunkt Zugriff Berechtigung Beschreibung
get_canvas_list /canvas/list Lesen Canvas-Analytics anzeigen Exportieren Sie eine Liste von Canvases mit Name, Canvas-API-Bezeichner und Tags.
get_canvas_details /canvas/details Lesen Canvas-Analytics anzeigen Exportieren Sie Canvas-Metadaten: Name, Erstellungszeitpunkt, aktueller Status und mehr.
get_canvas_data_series /canvas/data_series Lesen Canvas-Analytics anzeigen Exportieren Sie Zeitreihendaten für ein Canvas.
get_canvas_data_summary /canvas/data_summary Lesen Canvas-Analytics anzeigen Exportieren Sie Zusammenfassungen der Canvas-Zeitreihendaten für eine kompakte Ergebnisübersicht.

Kataloge

Tool API-Endpunkt Zugriff Berechtigung Beschreibung
get_catalogs /catalogs Lesen Kataloge anzeigen Kataloge in einem Workspace auflisten.
get_catalog_items /catalogs/{catalog_name}/items Lesen Katalogartikel anzeigen Mehrere Katalogartikel und deren Inhalt zurückgeben.
get_catalog_item /catalogs/{catalog_name}/items/{item_id} Lesen Katalogartikel anzeigen Einen einzelnen Katalogartikel und dessen Inhalt zurückgeben.
create_catalog /catalogs Erstellen Kataloge verwalten Einen Katalog erstellen.
delete_catalog /catalogs/{catalog_name} Löschen Kataloge verwalten Einen Katalog löschen.
create_catalog_fields /catalogs/{catalog_name}/fields Erstellen Katalogfelder verwalten Mehrere Felder in einem Katalog erstellen.
delete_catalog_field /catalogs/{catalog_name}/fields/{field_name} Löschen Katalogfelder verwalten Ein Katalogfeld löschen.
create_catalog_items /catalogs/{catalog_name}/items Erstellen Katalogartikel verwalten Mehrere Artikel in einem Katalog erstellen. Bis zu 50 Artikel pro Anfrage.
edit_catalog_items /catalogs/{catalog_name}/items Aktualisieren Katalogartikel verwalten Mehrere bestehende Artikel in einem Katalog bearbeiten. Bis zu 50 Artikel pro Anfrage.
replace_catalog_items /catalogs/{catalog_name}/items Aktualisieren Katalogartikel verwalten Mehrere Artikel in einem Katalog ersetzen. Erstellt Artikel, falls sie nicht vorhanden sind. Bis zu 50 Artikel pro Anfrage.
delete_catalog_items /catalogs/{catalog_name}/items Löschen Katalogartikel verwalten Mehrere Artikel in einem Katalog löschen. Bis zu 50 Artikel pro Anfrage.
create_catalog_selection /catalogs/{catalog_name}/selections Erstellen Katalogauswahlen verwalten Eine Auswahl in einem Katalog erstellen.
delete_catalog_selection /catalogs/{catalog_name}/selections/{selection_name} Löschen Katalogauswahlen verwalten Eine Katalogauswahl löschen.

Angepasste Attribute

Tool API-Endpunkt Zugriff Berechtigung Beschreibung
get_custom_attributes /custom_attributes Lesen Angepasste Events, Attribute und Käufe anzeigen Exportieren Sie die für Ihre App erfassten angepassten Attribute in Gruppen von 50, alphabetisch sortiert.

Angepasste Events

Tool API-Endpunkt Zugriff Berechtigung Beschreibung
get_events /events Lesen Angepasste Events, Attribute und Käufe anzeigen Exportieren Sie die für Ihre App erfassten angepassten Events in Gruppen von 50, alphabetisch sortiert (Cursor-Paginierung).
get_events_list /events/list Lesen Angepasste Events, Attribute und Käufe anzeigen Exportieren Sie die Namen angepasster Events in Gruppen von 250, alphabetisch sortiert (Seiten-Paginierung).
get_events_data_series /events/data_series Lesen Angepasste Events, Attribute und Käufe anzeigen Vorkommen eines angepassten Events in einem festgelegten Zeitraum.

CDI-Integrationen

Tool API-Endpunkt Zugriff Berechtigung Beschreibung
list_integrations /cdi/integrations Lesen Cloud Data Ingestion-Jobstatus anzeigen Bestehende Cloud Data Ingestion-Integrationen auflisten, 10 pro Aufruf.
get_integration_job_sync_status /cdi/integrations/{integration_id}/job_sync_status Lesen Cloud Data Ingestion-Jobstatus anzeigen Frühere Synchronisierungsstatus für eine bestimmte CDI-Integration, 10 pro Aufruf.
trigger_integration_sync /cdi/integrations/{integration_id}/sync Schreiben Cloud Data Ingestion-Integrationen synchronisieren Eine Synchronisierung für eine bestimmte CDI-Integration triggern.

KPI

Tool API-Endpunkt Zugriff Berechtigung Beschreibung
get_dau_data_series /kpi/dau/data_series Lesen KPI-Daten anzeigen Tägliche Reihe eindeutiger aktiver Nutzer:innen pro Datum.
get_mau_data_series /kpi/mau/data_series Lesen KPI-Daten anzeigen Tägliche Reihe eindeutiger aktiver Nutzer:innen in einem rollierenden 30-Tage-Fenster.
get_new_users_data_series /kpi/new_users/data_series Lesen KPI-Daten anzeigen Tägliche Reihe der gesamten neuen Nutzer:innen pro Datum.
get_uninstalls_data_series /kpi/uninstalls/data_series Lesen KPI-Daten anzeigen Tägliche Reihe der gesamten Deinstallationen pro Datum.

Medienbibliothek

Tool API-Endpunkt Zugriff Berechtigung Beschreibung
create_media_library_asset /media_library/create Erstellen Assets der Medienbibliothek verwalten Laden Sie ein Asset über eine externe URL oder einen Base64-Dateiinhalt in die Braze-Medienbibliothek hoch. Es muss genau ein Upload-Modus angegeben werden.

Käufe

Tool API-Endpunkt Zugriff Berechtigung Beschreibung
get_product_list /purchases/product_list Lesen Angepasste Events, Attribute und Käufe anzeigen Paginierte Liste von Produkt-IDs.
get_quantity_series /purchases/quantity_series Lesen Angepasste Events, Attribute und Käufe anzeigen Gesamtzahl der Käufe in Ihrer App über einen Zeitraum.
get_revenue_series /purchases/revenue_series Lesen Angepasste Events, Attribute und Käufe anzeigen Gesamtbetrag, der in Ihrer App über einen Zeitraum ausgegeben wurde.

Segments

Tool API-Endpunkt Zugriff Berechtigung Beschreibung
get_segment_list /segments/list Lesen Segmente anzeigen Exportieren Sie Segmente mit Name, Segment-API-Bezeichner und Analytics-Tracking-Flag.
get_segment_details /segments/details Lesen Segmente anzeigen Rufen Sie relevante Informationen zu einem Segment anhand der segment_id ab.
get_segment_data_series /segments/data_series Lesen Segmente anzeigen Tägliche Reihe der geschätzten Größe eines Segments im Zeitverlauf.
get_segment_filters Nur MCP Lesen Segmente anzeigen Definitionen von Segmentfiltern abrufen.
create_segment Nur MCP Erstellen Segmente erstellen Ein neues Segment erstellen.
edit_segment Nur MCP Aktualisieren Segmente bearbeiten Ein bestehendes Segment bearbeiten.

Die Segment-Tools sind allgemein verfügbar und erfordern keine Teilnahme an einem Betaprogramm.

Sendungen

Tool API-Endpunkt Zugriff Berechtigung Beschreibung
get_send_data_series /sends/data_series Lesen Sendedaten anzeigen Tägliche Statistik für eine getrackte send_id (API-Kampagnen). Braze speichert Sende-Analytics 14 Tage nach dem Versand.

Sitzungen

Tool API-Endpunkt Zugriff Berechtigung Beschreibung
get_session_data_series /sessions/data_series Lesen Sitzungsdaten anzeigen Anzahl der Sitzungen für Ihre App in einem festgelegten Zeitraum.

Templates

Tool API-Endpunkt Zugriff Berechtigung Beschreibung
get_email_templates /templates/email/list Lesen E-Mail-Templates anzeigen Verfügbare E-Mail-Templates in Ihrem Braze-Konto auflisten.
get_email_template_info /templates/email/info Lesen E-Mail-Templates anzeigen Informationen zu einem bestimmten E-Mail-Template abrufen. Templates aus dem Drag-and-Drop-Editor werden nicht akzeptiert.
create_email_template /templates/email/create Erstellen E-Mail-Templates verwalten Ein E-Mail-Template im Braze-Dashboard erstellen.
update_email_template /templates/email/update Aktualisieren E-Mail-Templates verwalten Ein bestehendes E-Mail-Template aktualisieren.

Content-Blocks

Tool API-Endpunkt Zugriff Berechtigung Beschreibung
get_content_blocks /content_blocks/list Lesen Content-Blocks anzeigen Informationen zu bestehenden Content-Blocks auflisten.
get_content_block_info /content_blocks/info Lesen Content-Blocks anzeigen Informationen zu einem bestehenden Content-Block abrufen, optional mit Daten zur Einbindung in Kampagnen oder Canvases.
create_content_block /content_blocks/create Erstellen Content-Blocks verwalten Einen Content-Block erstellen.
update_content_block /content_blocks/update Aktualisieren Content-Blocks verwalten Einen Content-Block aktualisieren.

Operator

Tool API-Endpunkt Zugriff Berechtigung Beschreibung
send_operator_prompt Nur MCP Aktualisieren BrazeAI Operator verwenden Einen Prompt in natürlicher Sprache an den BrazeAI Operator senden. Übermittelt einen Hintergrundjob und gibt eine job_id zurück.
get_operator_result Nur MCP Lesen BrazeAI Operator verwenden Das Ergebnis eines übermittelten Operator-Jobs anhand seiner job_id abfragen.
cancel_operator_job Nur MCP Aktualisieren BrazeAI Operator verwenden Einen laufenden Operator-Job abbrechen.

Skills

Tool API-Endpunkt Zugriff Berechtigung Beschreibung
get_operator_skills Nur MCP Lesen Skills anzeigen Die Skills des Workspace mit Name und Beschreibung jedes Skills auflisten.
get_operator_skill Nur MCP Lesen Skills anzeigen Einen Skill einschließlich seiner Anweisungen lesen.
create_operator_skill Nur MCP Erstellen Skills anzeigen, Skills bearbeiten Einen Skill erstellen. Wenn der Name bereits verwendet wird, fügt Braze ein Suffix hinzu.
update_operator_skill Nur MCP Aktualisieren Skills anzeigen, Skills bearbeiten Einen Skill bearbeiten. Felder, die Sie weglassen, behalten ihre aktuellen Werte.

Weitere Informationen finden Sie unter Skills.

Wie Anweisungen und Antworten verarbeitet werden

Der Braze MCP-Server empfängt Anweisungen von Ihrem MCP-Client eines Drittanbieters, wie z. B. Claude, ChatGPT, Copilot, Gemini CLI, Codex oder Cursor, genau so, wie das zugrunde liegende KI-Modell dieses Anbieters sie formuliert. Wenn Sie eine Anfrage in natürlicher Sprache eingeben, interpretiert das KI-Modell Ihre Anfrage und übersetzt sie in einen oder mehrere spezifische Tool-Aufrufe an Braze. Braze empfängt und führt den Tool-Aufruf wie gesendet aus. Braze sieht Ihren ursprünglichen Prompt in natürlicher Sprache nicht und kann nicht überprüfen, ob der generierte Tool-Aufruf Ihre beabsichtigte Anfrage vollständig oder korrekt widerspiegelt.

Wenn Braze Daten oder ein Ergebnis zurückgibt, wird diese Antwort an Ihren MCP-Client des Drittanbieters zurückgesendet, der sie dann interpretiert, formatiert und Ihnen präsentiert. Braze hat keine Kontrolle darüber, wie das KI-Modell zurückgegebene Informationen darstellt, zusammenfasst oder beschreibt.

Braze haftet nicht für Anweisungen, die von einem MCP-Client eines Drittanbieters generiert werden, oder für Antworten, die über einen solchen übermittelt werden. Braze empfiehlt, den „Auto-Modus“ nicht zu verwenden, falls Ihr MCP-Client eines Drittanbieters diesen zur automatischen Aktionsausführung anbietet. Überprüfen Sie KI-generierte Zusammenfassungen anhand der Quelldaten in Ihrem Braze-Dashboard und prüfen Sie jede von der KI vorgeschlagene Aktion, bevor Sie sie über Ihren MCP-Client des Drittanbieters umsetzen.

New Stuff!