Skip to content

Verwendung des Braze MCP-Servers

Erfahren Sie, wie Sie nach der Verbindung mit dem Remote-Braze-MCP-Server über natürliche Sprache mit Ihren Braze-Daten interagieren können. Weitere Informationen finden Sie unter Braze MCP-Server.

Voraussetzungen

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

Best Practices

Wenn Sie den Braze MCP-Server über Tools für natürliche Sprache verwenden, beachten Sie die folgenden Tipps:

  • Bestätigen Sie den Workspace in Ihrem Prompt, insbesondere wenn Sie Zugriff auf mehrere Workspaces haben.
  • Geben Sie bei Analytics-Anfragen genaue Datumsbereiche und Metriken an.
  • Bitten Sie den Agenten zu bestätigen, welche Tools er bei der Validierung der Ergebnisse verwendet hat.
  • Gleichen Sie Empfehlungen mit hoher Auswirkung mit den Quelldaten im Braze-Dashboard ab.

Anwendungsbeispiele

Nach der Einrichtung des Braze MCP-Servers können Sie über natürliche Sprache mit Braze interagieren. Hier finden Sie Beispiele für den Einstieg.

Auf welche Workspaces habe ich Zugriff?

Show my available Braze workspaces and tell me which one to use for production campaign analytics.

Ich habe get_workspaces aufgerufen und folgende Workspaces gefunden:

  • Marketing - Production (app_group_id: YOUR-APP-GROUP-ID-1)
  • Marketing - Staging (app_group_id: YOUR-APP-GROUP-ID-2)

Verwenden Sie Marketing - Production für Analytics-Prompts zu Produktions-Campaigns.

Weitere Informationen finden Sie unter Verfügbare API-Funktionen.

Campaign-Performance der letzten Woche anzeigen

In the Marketing - Production workspace, show campaign performance for the last seven days, including sends, opens, clicks, and top performers.

Ich habe get_campaign_list und get_campaign_dataseries für den angeforderten Workspace und Zeitraum verwendet.

Zusammenfassung:

  • Gesamtversand: YOUR-TEST-SENDS
  • Gesamtöffnungen: YOUR-TEST-OPENS
  • Gesamtklicks: YOUR-TEST-CLICKS
  • Top-Campaign nach Öffnungen: YOUR-TEST-CAMPAIGN-NAME

Ich kann dies bei Bedarf nach Campaign, Kanal oder Tag aufschlüsseln.

Weitere Informationen finden Sie unter Verfügbare API-Funktionen.

Ein E-Mail-Template erstellen

In the Marketing - Production workspace, create an onboarding email template named "YOUR-TEST-TEMPLATE-NAME".

Ich habe create_email_template verwendet und Ihr Template erstellt.

  • Template-ID: YOUR-TEST-TEMPLATE-ID-123
  • Template-Name: YOUR-TEST-TEMPLATE-NAME
  • Workspace: Marketing - Production

Weitere Informationen finden Sie unter Verfügbare API-Funktionen.

Beispiel-Workflows

Diese Beispiele kombinieren mehrere Tools, um eine Aufgabe von Anfang bis Ende abzuschließen.

Berichte über mehrere Workspaces hinweg

Get me an analytics report for the past week from my US Prod workspace and my EU Prod workspace, and compare total sends and open rates.

Ich habe get_workspaces aufgerufen, um den Zugriff zu bestätigen, und dann get_campaign_dataseries für jeden Workspace über die letzten sieben Tage ausgeführt.

  • US Prod: YOUR-TEST-SENDS Sendungen, YOUR-TEST-OPEN-RATE Öffnungsrate
  • EU Prod: YOUR-TEST-SENDS Sendungen, YOUR-TEST-OPEN-RATE Öffnungsrate

US Prod hat diese Woche mehr Nachrichten gesendet, während EU Prod die höhere Öffnungsrate hatte. Ich kann jeden Workspace nach Campaign oder Kanal aufschlüsseln.

Templates von Staging nach Production kopieren

Copy the email templates from my Staging workspace to my Production workspace.

Ich habe get_email_templates und get_email_template_info verwendet, um die Templates in Staging zu lesen, und dann create_email_template, um jedes einzelne in Production neu zu erstellen.

  • YOUR-TEST-TEMPLATE-NAME-1: erstellt in Production (YOUR-TEST-TEMPLATE-ID-1)
  • YOUR-TEST-TEMPLATE-NAME-2: erstellt in Production (YOUR-TEST-TEMPLATE-ID-2)

Ich habe Drag-and-Drop-Editor-Templates übersprungen, die von get_email_template_info nicht unterstützt werden. Lassen Sie mich wissen, ob ich die kopierten Templates überprüfen soll.

Wöchentliche Zusammenfassung der Campaign-Performance

Give me a weekly campaign health summary for the Production workspace.

Ich habe get_campaign_list und get_campaign_dataseries verwendet, um die Aktivitäten der letzten sieben Tage in Production abzurufen.

  • Gesamtsendungen: YOUR-TEST-SENDS
  • Öffnungsrate: YOUR-TEST-OPEN-RATE
  • Klickrate: YOUR-TEST-CLICK-RATE
  • Top-Campaign nach Conversions: YOUR-TEST-CAMPAIGN-NAME

Die Sendungen sind im Wochenvergleich gestiegen. Ich kann eine Aufschlüsselung nach Kanal hinzufügen oder Campaigns mit rückläufigem Engagement kennzeichnen.

So funktioniert der Remote-MCP-Server

Wenn Sie eine Anfrage senden, laufen im Hintergrund einige Schritte ab:

  1. Sie geben Ihrem Client einen Prompt. Sie formulieren eine Anfrage in natürlicher Sprache, z. B. nach der Campaign-Performance der letzten Woche.
  2. Das Modell des Clients wählt Tools aus. Das KI-Modell in Ihrem Client interpretiert Ihre Anfrage und übersetzt sie in einen oder mehrere Braze-Tool-Aufrufe, wie z. B. get_campaign_list und get_campaign_dataseries.
  3. Braze führt den Tool-Aufruf aus. Der Remote-MCP-Server empfängt jeden Tool-Aufruf über Ihre authentifizierte OAuth-Sitzung, wendet den von Ihnen angegebenen Workspace an und führt ihn gegen den entsprechenden Braze REST API-Endpunkt aus.
  4. Braze gibt das Ergebnis zurück. Der Server sendet die Daten an Ihren Client zurück, der sie formatiert und Ihnen präsentiert.

Ihr Zugriff ergibt sich aus der Schnittmenge zweier Faktoren:

  • Die Berechtigungen (Scopes), die bei der Autorisierung der Verbindung gewährt wurden, wie z. B. mcp:tools.
  • Ihre eigenen Dashboard-Nutzer:innenberechtigungen. Wenn Sie Campaigns im Dashboard nicht anzeigen können, kann Ihr Agent das auch nicht. Wenn Sie E-Mail-Templates erstellen können, kann Ihr Agent das ebenfalls. Ein Agent kann Ihren eigenen Zugriff niemals überschreiten.

Der Workspace-Kontext wird mit jeder Anfrage übergeben, anstatt in einer lokalen Konfigurationsdatei gespeichert zu werden. So kann eine einzelne Verbindung über alle Workspaces hinweg funktionieren, für die Sie autorisiert sind.

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!