Skip to content

Einrichtung des Braze MCP-Servers

Erfahren Sie, wie Sie eine Verbindung zum Remote-Braze-MCP-Server herstellen, sich mit OAuth authentifizieren und Braze-Tools in Ihrem MCP-Client nutzen. Weitere Informationen finden Sie unter Braze MCP-Server.

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie über Folgendes verfügen:

Voraussetzung Beschreibung
Unterstützter MCP-Client Jeder Client, der Remote-MCP-Server mit OAuth unterstützt, funktioniert. Braze hat Claude, ChatGPT, Cursor, OpenAI Codex, Claude Code und Visual Studio Code verifiziert.
Braze-Dashboard-Konto Sie melden sich mit Ihren normalen Braze-Zugangsdaten an, einschließlich Single Sign-on oder SAML, falls Ihr Unternehmen dies nutzt. Es gibt keine separate MCP-Anmeldung.
Auswahl des Server-Endpunkts Wählen Sie https://mcp.braze.com/mcp (US) oder https://mcp.braze.eu/mcp (EU). Beide Endpunkte können jeden Braze-Cluster erreichen.
Kein IP-Allowlisting Kund:innen, die IP-Allowlisting verwenden, können den Braze MCP-Server derzeit nicht nutzen.

Zugriff verwalten (für Admins)

Zugriff gewähren

Admins steuern den Zugriff auf den MCP-Server über die Berechtigung „Use MCP Server“. Standardmäßig verfügen Nutzer:innen nicht über diese Berechtigung, und sie muss explizit erteilt werden.

Zugriff widerrufen

Um den Zugriff zu widerrufen, entfernen Sie die Berechtigung „Use MCP Server“ von der/dem Nutzer:in. Das Entfernen von Dashboard-Berechtigungen einer/eines Nutzer:in entfernt diese Funktionen auch von jedem verbundenen Agenten bei der nächsten Anfrage.

Nutzung prüfen

Wenn eine Verbindung über OAuth erfolgreich hergestellt wird, wird ein Ereignis im Sicherheitsereignisbericht protokolliert.

Client verbinden

Schritt 1: Berechtigungen und Workspace-Zugriff bestätigen

  1. Sie oder Ihre Unternehmensadministrator:innen müssen bestätigen, dass Sie die Berechtigung „Use MCP Server“ besitzen.
  2. Wenn Sie Zugriff auf mehrere Workspaces benötigen, stellen Sie sicher, dass die Berechtigung für alle relevanten Workspaces aktiviert ist.

Schritt 2: Braze als Remote-MCP-Konnektor hinzufügen

Fügen Sie in Ihrem MCP-Client einen neuen Remote-Server oder angepassten Konnektor hinzu und geben Sie Ihre Braze-MCP-URL ein. In Claude können Sie beispielsweise zu Settings > Connectors > Add custom connector navigieren und die URL einfügen.

Es sind keine Client-ID, kein Client-Secret und kein API-Schlüssel erforderlich. Ihr Client registriert sich automatisch bei Braze.

Braze-MCP-Endpunktoptionen:

  • https://mcp.braze.com/mcp (US)
  • https://mcp.braze.eu/mcp (EU)

Einrichtungsanleitungen für Clients:

Schritt 3: Über OAuth bei Braze anmelden

Wenn Ihr Agent zum ersten Mal ein Braze-Tool aufruft, öffnet Ihr Client ein Browserfenster und leitet Sie zur Anmeldung bei Braze weiter.

  1. Melden Sie sich wie gewohnt bei Braze an, einschließlich Single Sign-on, falls erforderlich.
  2. Wenn Ihre Anmeldung Zugriff auf mehr als ein Unternehmen im selben Cluster hat, wählen Sie das Unternehmen aus, das Sie verwenden möchten.
  3. Überprüfen Sie auf dem Einwilligungsbildschirm den Zugriff, den die Anwendung anfordert.
  4. Aktivieren Sie das Bestätigungskontrollkästchen, um der Braze-Datenschutzrichtlinie zuzustimmen, und wählen Sie dann Continue, um zu Ihrem MCP-Client zurückzukehren.

Der Braze-Einwilligungsbildschirm, der zeigt, dass Claude Desktop Zugriff auf Braze-Kontoinformationen und umfassenden Zugriff auf Braze-Daten anfordert, mit einem Kontrollkästchen zur Bestätigung der Datenschutzrichtlinie sowie den Buttons „Cancel“ und „Continue“.

Ihre Sitzung verwendet kurzlebige Zugangs-Token, die automatisch erneuert werden. Gelegentlich müssen Sie sich möglicherweise erneut anmelden.

Schritt 4: Ihrem Agenten mitteilen, welchen Workspace er verwenden soll

Wenn Ihr Konto Zugriff auf mehr als einen Workspace hat, geben Sie den Workspace in Ihrem Prompt an. Zum Beispiel:

  • I'd like to look at campaign analytics for the past week in the Production workspace.
  • Can you compare this week's analytics between my prod-1 workspace and my prod-2 workspace?

Wenn Sie keinen Workspace angeben, fragt Ihr Agent möglicherweise nach.

Schritt 5: Einen Test-Prompt senden

Senden Sie nach der Einrichtung einen kurzen Validierungs-Prompt, zum Beispiel:

  • List the Braze tools available in this workspace.
  • Show my recent Canvases from the Production workspace.

Weitere Beispiele finden Sie unter Den Braze MCP-Server verwenden.

Beispiel: Verbindung mit Claude herstellen

Die Verbindung eines Clients erfordert nur wenige Schritte. Die folgende Anleitung verwendet Claude, aber der Ablauf ist bei anderen unterstützten Clients ähnlich.

  1. Gehen Sie in Claude zu Settings > Connectors > Add custom connector.
  2. Geben Sie einen Namen ein, z. B. Braze, und fügen Sie dann Ihre Braze MCP-URL ein: https://mcp.braze.com/mcp für US oder https://mcp.braze.eu/mcp für EU. Sie benötigen keine Client-ID, kein Client-Secret und keinen API-Schlüssel.
  3. Wählen Sie Add aus, um den Konnektor zu speichern. Claude registriert sich automatisch bei Braze.
  4. Wählen Sie Connect aus, um die Authentifizierung zu starten. Claude öffnet ein Browserfenster und leitet Sie zur Anmeldung bei Braze weiter.
  5. Melden Sie sich mit Ihren üblichen Zugangsdaten bei Braze an, einschließlich Single Sign-on, falls Ihr Unternehmen dies verwendet. Wenn Ihre Anmeldung Zugriff auf mehr als ein Unternehmen im selben Cluster ermöglicht, wählen Sie das Unternehmen aus, das Sie verwenden möchten.
  6. Überprüfen Sie auf dem Zustimmungsbildschirm den angeforderten Zugriff, aktivieren Sie das Bestätigungskontrollkästchen und wählen Sie dann Continue aus. Claude kehrt zu Ihrem Chat zurück, und Ihr Agent kann nun Braze-Tools verwenden.

Um die Verbindung zu bestätigen, senden Sie einen Test-Prompt wie Show my recent Canvases from the Production workspace.

Migration vom lokalen Beta-Server

Sie können den lokalen Beta-Server und den remote-gehosteten Server während der Migration parallel betreiben. Möglicherweise müssen Sie Ihrem Agenten explizit mitteilen, welchen Server er verwenden soll.

Der remote-gehostete Server enthält neue Tools, die im lokalen Beta-Server nicht vorhanden sind. Wenn Sie Skills für den lokalen Server erstellt haben, müssen Sie diese Skills möglicherweise aktualisieren, um auf neue Tool-Namen und -Verhaltensweisen zu verweisen.

Nachdem Sie bestätigt haben, dass Ihre Workflows und Skills auf dem Remote-Server funktionieren, deaktivieren Sie den lokal gehosteten Server.

Fehlerbehebung

Authentifizierung schlägt in einem unterstützten Client fehl

  1. Bestätigen Sie, dass Ihr Unternehmensadministrator MCP OAuth-Zugriff in den OAuth-Einstellungen aktiviert hat.
  2. Bestätigen Sie, dass Ihre Nutzer:in die Berechtigung „Use MCP Server“ besitzt.
  3. Versuchen Sie die Anmeldung und Autorisierung erneut.

Authentifizierung wird in einem nicht verifizierten Client blockiert

Braze führt aus Sicherheitsgründen eine Zulassungsliste unterstützter Client-Domains. Wenn Sie sich von einem Client aus verbinden, der nicht auf der Zulassungsliste steht, kann die Authentifizierung blockiert werden. Sie wünschen sich support for your MCP client? Hinterlassen Sie gerne Produktfeedback.

Clients, die lokal auf Ihrem Rechner ohne ein benutzerdefiniertes Schema laufen, wie Claude Code und OpenAI Codex, sollten ebenfalls funktionieren.

Tools werden in Ihrem Client nicht angezeigt

Wenn Ihr Agent die Braze-Tools nicht auflisten kann, warten Sie einige Minuten und versuchen Sie es erneut. Diese Probleme sind oft vorübergehend und lösen sich von selbst.

Agent kann nicht auf erwartete Tools zugreifen

  1. Bestätigen Sie, dass Ihre Dashboard-Nutzer:in über die erforderlichen Berechtigungen verfügt. Ihr Agent kann nur Tools verwenden, die Ihrem eigenen Dashboard-Zugriff entsprechen.
  2. Bestätigen Sie, dass Sie den erwarteten Workspace in Ihrem Prompt ausgewählt haben.
  3. Bitten Sie Ihren Agenten, get_workspaces aufzurufen, und überprüfen Sie die verfügbaren Workspace-IDs.

Agent verwendet den falschen Workspace

Wenn Ihr Konto auf mehr als einen Workspace zugreifen kann, nennen Sie den Workspace in Ihrem Prompt mit dem exakten Namen, der im Braze-Dashboard angezeigt wird. Wenn Sie keinen Workspace angeben, fragt Ihr Agent möglicherweise nach oder verwendet einen unerwarteten.

Zu einem anderen Unternehmen wechseln

Ihr Unternehmen wird bei der ersten Autorisierung festgelegt. Um in einem anderen Unternehmen auf demselben Cluster zu arbeiten, trennen Sie den Braze-Konnektor in Ihrem Client, autorisieren Sie erneut und wählen Sie das andere Unternehmen bei der Anmeldung aus.

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!