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.

Wichtig

Der lokal gehostete Braze MCP-Server (Beta) ist veraltet und erhält keine weiteren Updates.

Voraussetzungen

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

Hinweis

Der Zugriff Ihres Agenten spiegelt Ihre Dashboard-Berechtigungen wider. Wenn Ihr Dashboard-Zugriff auf ein Team statt auf einen vollständigen Workspace beschränkt ist, funktionieren einige Tools möglicherweise nicht.

Zugriffsverwaltung (für Admins)

Hinweis

Bevor Nutzer:innen eine Verbindung herstellen können, muss ein Unternehmensadmin MCP-OAuth-Zugriff unter Einstellungen > Administratoreinstellungen > OAuth aktivieren. Weitere Informationen finden Sie unter OAuth-Einstellungen verwalten.

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 gewährt werden.

Zugriff widerrufen

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

Wenn Sie vermuten, dass ein Token kompromittiert oder missbraucht wurde, kann ein Unternehmensadmin alle MCP-OAuth-Token für das Unternehmen auf einmal unter Einstellungen > Administratoreinstellungen > OAuth widerrufen. Alle verbundenen Clients verlieren den Zugriff, und alle Nutzer:innen müssen sich erneut verbinden. Weitere Informationen finden Sie unter MCP-OAuth-Token widerrufen.

Nutzung überwachen

Wenn eine Nutzerin oder ein Nutzer sich erfolgreich über OAuth verbindet, wird ein Ereignis im Bericht über Sicherheitsereignisse protokolliert.

Verbinden Sie Ihren Client

Schritt 1: Berechtigungen und Workspace-Zugriff bestätigen

1. Sie oder die Admin-Verantwortlichen Ihres Unternehmens müssen bestätigen, dass Sie die Berechtigung „Use MCP Server“ haben.
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)

Tipp

EU-Kund:innen sollten den EU-Endpunkt verwenden. Nicht-EU-Kund:innen können beide Endpunkte verwenden.

Einrichtungsanleitungen für Clients:

• Claude
• Claude Code
• ChatGPT
• Cursor
• OpenAI Codex
• Visual Studio Code

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 auf demselben Cluster Zugriff auf mehr als ein Unternehmen hat, wählen Sie das Unternehmen aus, das Sie verwenden möchten.
3. Überprüfen Sie auf dem Zustimmungsbildschirm 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.

Ihre Sitzung verwendet kurzlebige Zugriffstoken, die automatisch aktualisiert werden. Gelegentlich müssen Sie sich möglicherweise erneut anmelden.

Schritt 4: Ihrem Agenten den gewünschten Workspace mitteilen

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, wie zum Beispiel:

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

Weitere Beispiele finden Sie unter Nutzung des Braze MCP-Servers.

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 es nutzt. Wenn Ihre Anmeldung Zugriff auf mehr als ein Unternehmen auf demselben Cluster bietet, 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 jetzt 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 möglicherweise aktualisieren, damit sie auf neue Tool-Namen und -Verhaltensweisen 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 eine Zulassungsliste unterstützter Client-Domains aus Sicherheitsgründen. 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 ausgeführt werden, wie Claude Code und OpenAI Codex, sollten ebenfalls funktionieren.

Eine funktionierende Verbindung authentifiziert sich nicht mehr

Wenn Ihr Client verbunden war und die Authentifizierung nun fehlschlägt, hat Ihr Unternehmensadministrator möglicherweise die MCP-OAuth-Token Ihres Unternehmens widerrufen. Melden Sie sich über Ihren Client erneut bei Braze an, um eine neue Verbindung herzustellen. Wenn die Anmeldung weiterhin fehlschlägt, bestätigen Sie, dass MCP-OAuth-Zugriff aktiviert ist und dass Sie weiterhin die Berechtigung „Use MCP Server“ besitzen.

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, benennen Sie den Workspace in Ihrem Prompt mit dem genauen Namen, der im Braze-Dashboard angezeigt wird. Wenn Sie keinen Workspace angeben, fragt Ihr Agent möglicherweise nach oder verwendet einen unerwarteten.

Wichtig

Bevor Ihr Agent mit der Arbeit beginnt, bestätigen Sie immer, welchen Workspace er verwendet. In einigen Fällen kann ein Agent einen anderen Workspace auswählen als den, den Sie beabsichtigt haben.

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 während der Anmeldung aus.

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.