Der Braze MCP-Server
Erfahren Sie mehr über den Braze MCP-Server, eine sichere Remote-Verbindung, über die KI-Tools wie Claude und Cursor auf nicht PII-bezogene Braze-Daten zugreifen können, um Fragen zu beantworten, Trends zu analysieren, Insights zu gewinnen und Inhalte zu erstellen.
Was ist das Model Context Protocol (MCP)?
Das Model Context Protocol (MCP) ist ein Standard, mit dem KI-Agenten eine Verbindung zu einer anderen Plattform herstellen und mit deren Daten arbeiten können. Es besteht aus zwei Hauptkomponenten:
- MCP-Client: Die Anwendung, in der der KI-Agent ausgeführt wird, zum Beispiel Cursor oder Claude.
- MCP-Server: Ein Dienst einer anderen Plattform, etwa Braze, der festlegt, welche Tools die KI verwenden kann und auf welche Daten sie zugreifen darf.
Über den Braze MCP-Server
Nachdem Sie den Braze MCP-Server eingerichtet haben, können Sie KI-Tools wie Agenten, Assistenten und Chatbots direkt mit Braze verbinden. So können diese Tools aggregierte Daten lesen, etwa Analytics zu Canvas und Campaigns, angepasste Attribute, Segmente und mehr. Der Braze MCP-Server eignet sich hervorragend für:
- Die Entwicklung KI-gestützter Tools, die Kontext aus Braze benötigen.
- CRM-Engineers, die mehrstufige Agenten-Workflows erstellen.
- Technische Marketer, die mit Abfragen in natürlicher Sprache experimentieren.
Der Braze MCP-Server umfasst sowohl Lese- als auch Schreib-Tools. Diese Tools geben keine Daten aus Braze-Nutzerprofilen zurück. Ihre Agenten übernehmen die Nutzerberechtigungen Ihres Braze-Dashboards. Eine vollständige Liste der verfügbaren Tools finden Sie unter Verfügbare API-Funktionen.
Tools, die PII auf Nutzerebene offenlegen, sind nicht verfügbar.
Mit dem MCP-Server können Sie in natürlicher Sprache Fragen zur Performance von Campaigns und Canvases stellen, Ihre Segmente und angepassten Attribute erkunden, Berichte erstellen und Inhalte wie E-Mail-Templates, Content-Blocks und Assets der Medienbibliothek erstellen.
Ist der Beta-MCP-Server veraltet?
Ja. Der lokal gehostete MCP-Server, der im August 2025 veröffentlicht wurde, ist veraltet und erhält keine weiteren Updates. Sie können ihn weiterhin verwenden, Braze empfiehlt jedoch die Migration auf die remote gehostete Version.
Wie unterscheidet sich der Remote-Server?
Der bisherige Braze-MCP-Server lief lokal auf Ihrem Rechner. Sie mussten ein Paket installieren, eine Konfigurationsdatei verwalten und einen Braze-API-Schlüssel mit den richtigen Berechtigungen erstellen. Mit dem Remote-MCP-Server entfällt diese lokale Einrichtung.
Stellen Sie die Verbindung von einem unterstützten MCP-Client in weniger als einer Minute her. Die Authentifizierung erfolgt über OAuth. Der Zugriff ist an Ihr Nutzerkonto im Braze-Dashboard gebunden, nicht an einen gemeinsam genutzten API-Schlüssel. Was ein Agent sehen und tun kann, entspricht also Ihren Dashboard-Berechtigungen. Verliert ein:e Dashboard-Nutzer:in den Zugriff in Braze, verliert auch der Client den Zugriff.
Die wichtigsten Unterschiede sind:
- Einrichtung: Fügen Sie eine Braze-URL ein, anstatt ein Paket zu installieren und Konfigurationsdateien zu bearbeiten.
- Authentifizierung: Melden Sie sich mit Ihrem Braze-Konto an, anstatt einen API-Schlüssel zu erstellen.
- Berechtigungen: Der Zugriff basiert auf Ihrem Dashboard-Nutzerkonto statt auf den Berechtigungen eines API-Schlüssels.
- Workspace-Targeting: Der Workspace-Kontext wird pro Anfrage übergeben, anstatt in der lokalen Konfiguration festgelegt zu sein.
Häufig gestellte Fragen (FAQ)
Welche MCP-Clients werden unterstützt?
Jeder MCP-Client, der Remote-MCP-Server mit OAuth unterstützt, kann verwendet werden. Braze hat folgende Clients verifiziert:
- Claude über angepasste Konnektoren
- ChatGPT über angepasste Konnektoren
- Cursor
- OpenAI Codex
- Claude Code
- Visual Studio Code
Auf welche Braze-Daten hat mein MCP-Client Zugriff?
MCP-Clients können auf Tools zugreifen, die keine PII auf Nutzerebene zurückgeben.
Kann mein MCP-Client Braze-Daten ändern?
Ja, wenn Ihr Dashboard-Nutzerkonto über die entsprechenden Berechtigungen verfügt.
Benötige ich weiterhin einen Braze-API-Schlüssel?
Nicht für MCP. API-Schlüssel funktionieren weiterhin für die REST API und werden nicht eingestellt.
Welche Regionen werden unterstützt?
Beide Braze-Cluster werden unterstützt. Derzeit sind zwei Endpunkte verfügbar:
https://mcp.braze.com/mcp(US)https://mcp.braze.eu/mcp(EU)
Jeder Endpunkt kann jeden Braze-Cluster erreichen.
Kann ich den Braze Remote-MCP-Server mit anderen Tools als den verifizierten verwenden?
Sie können es versuchen, aber die Authentifizierung könnte blockiert werden. Braze pflegt derzeit aus Sicherheitsgründen eine Zulassungsliste unterstützter Domains. Sie wünschen sich support for your MCP client? Hinterlassen Sie gerne Produktfeedback.
Unterstützt der Remote-Server mehrere Workspaces?
Ja. Geben Sie den Workspace pro Konversation oder pro Anfrage an. Eine Verbindung deckt alle Workspaces ab, auf die Sie zugriffsberechtigt sind.
Kann mein Agent auf PII auf Nutzerebene zugreifen?
Nein. Derzeit sind Tools, die PII offenlegen, nicht verfügbar.
Erscheinen über den MCP-Server vorgenommene Campaign-Bearbeitungen im Bearbeitungsverlauf?
Ja. Campaign-Bearbeitungen, die über MCP-Tools vorgenommen werden, werden Ihrem angemeldeten Dashboard-Nutzerkonto zugeordnet und erscheinen im Bearbeitungsverlauf der Campaign.
Canvas-spezifische MCP-Tools sind derzeit schreibgeschützt (get_canvas_list, get_canvas_details, get_canvas_data_series und get_canvas_data_summary).
Was passiert, wenn sich meine Berechtigungen ändern?
Der Agentenzugriff ändert sich mit dem Dashboard-Nutzerkonto. Berechtigungsänderungen werden bei der nächsten Anfrage wirksam. Deaktivierte Dashboard-Nutzer:innen verlieren den MCP-Zugriff.
Warum sehe ich den Braze-Konnektor nicht im Verzeichnis meines Clients?
Verzeichniseinträge sind möglicherweise noch nicht in jedem MCP-Client verfügbar. Sie können sich jederzeit manuell über die Braze-MCP-URL verbinden.
Mein Unternehmen verwendet IP-Allowlisting. Können wir den Remote-MCP-Server nutzen?
Derzeit nicht. Wenn Sie IP-Allowlisting verwenden, können Sie den Remote-MCP-Server nicht nutzen.
Haftungsausschluss
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.