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 Folgendes bereitsteht:

Hinweis

Der Zugriff Ihres Agenten entspricht Ihren Dashboard-Berechtigungen. Wenn Ihr Dashboard-Zugriff auf ein Team statt auf einen gesamten Workspace beschränkt ist, funktionieren einige Tools möglicherweise nicht.

Zugriff verwalten (für Admins)

Hinweis

Bevor Nutzer:innen eine Verbindung herstellen können, muss ein Unternehmensadmin unter Einstellungen > Admin-Einstellungen > Externe Verbindungen den MCP-OAuth-Zugriff 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 haben Nutzer:innen diese Berechtigung nicht, sie muss ausdrücklich erteilt werden.

Zugriff entziehen

Um den Zugriff zu entziehen, entfernen Sie die Berechtigung „Use MCP Server“ bei der jeweiligen Person. Wenn Sie Nutzer:innen Dashboard-Berechtigungen entziehen, verlieren alle verbundenen Agenten diese Fähigkeiten ebenfalls bei der nächsten Anfrage.

Wenn Sie vermuten, dass ein Token offengelegt oder missbraucht wurde, kann ein Unternehmensadmin unter Einstellungen > Admin-Einstellungen > Externe Verbindungen alle MCP-OAuth-Token des Unternehmens auf einmal widerrufen. Dadurch verlieren alle verbundenen Clients den Zugriff, und alle Nutzer:innen müssen sich erneut verbinden. Weitere Informationen finden Sie unter MCP-OAuth-Token widerrufen.

Nutzung prüfen

Wenn sich Nutzer:innen erfolgreich über OAuth verbinden, wird ein Ereignis im Bericht zu Sicherheitsereignissen protokolliert.

Client verbinden

Schritt 1: Berechtigungen und Workspace-Zugriff bestätigen

1. Prüfen Sie, ob Sie die Berechtigung „Use MCP Server“ haben, oder bitten Sie Ihre Unternehmensadministration, dies für Sie zu überprüfen.
2. Wenn Sie Zugriff auf mehrere Workspaces benötigen, stellen Sie sicher, dass die Berechtigung für alle relevanten Workspaces aktiviert ist.
3. Bitten Sie Ihre Unternehmensadministration zu bestätigen, dass Ihr MCP-Client unter MCP-Clients genehmigt ist, entweder als verifizierter MCP-Client oder über eine genehmigte angepasste Weiterleitungs-URI. Andernfalls können Sie die Anmeldung bei Braze in Schritt 3 nicht abschließen.

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

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

Es sind weder Client-ID noch Client-Secret oder API-Schlüssel erforderlich. Ihr Client registriert sich automatisch bei Braze. Durch die Registrierung wird der Client jedoch nicht für Ihr Unternehmen genehmigt. Eine Administratorin oder ein Administrator muss den verifizierten Client oder seine Weiterleitungs-URI weiterhin wie in Schritt 1 beschrieben genehmigen.

Optionen für den Braze-MCP-Endpunkt:

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

Tipp

Kund:innen in der EU sollten den EU-Endpunkt verwenden. Kund:innen außerhalb der EU können beide Endpunkte nutzen.

Anleitungen zur Client-Einrichtung:

• 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 an Braze weiter.

1. Melden Sie sich wie gewohnt bei Braze an, gegebenenfalls auch über Single Sign-on.
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 Zustimmungsbildschirm die Zugriffsrechte, die die Anwendung anfordert.
4. Aktivieren Sie das Bestätigungskästchen, um der Braze-Datenschutzerklärung zuzustimmen, und wählen Sie dann Weiter, 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 mitteilen, welcher Workspace verwendet werden soll

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

• Ich möchte mir die Campaign-Analytics der letzten Woche im Workspace Production ansehen.
• Kannst du die Analytics dieser Woche zwischen meinem Workspace prod-1 und meinem Workspace prod-2 vergleichen?

Wenn Sie keinen Workspace angeben, bittet Ihr Agent Sie möglicherweise um eine Klarstellung.

Schritt 5: Einen Test-Prompt senden

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

• Liste die Braze-Tools auf, die in diesem Workspace verfügbar sind.
• Zeige meine neuesten Canvases aus dem Workspace Production.

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

Beispiel: Mit Claude verbinden

Einen Client zu verbinden, dauert nur wenige Schritte. Die folgende Anleitung verwendet Claude, der Ablauf ist für andere kompatible Clients jedoch ähnlich.

Bevor Sie beginnen, stellen Sie sicher, dass ein:e Unternehmensadministrator:in Claude unter MCP-Clients genehmigt hat, wie in Schritt 1 beschrieben.

1. Gehen Sie in Claude zu Einstellungen > Konnektoren > Benutzerdefinierten Konnektor hinzufügen.
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 die USA oder https://mcp.braze.eu/mcp für die EU. Sie benötigen weder eine Client-ID noch ein Client-Secret oder einen API-Schlüssel.
3. Wählen Sie Hinzufügen, um den Konnektor zu speichern. Claude registriert sich automatisch bei Braze, wird dadurch aber nicht für Ihr Unternehmen genehmigt.
4. Wählen Sie Verbinden, um die Authentifizierung zu starten. Claude öffnet ein Browserfenster und leitet Sie zur Anmeldung an Braze weiter.
5. Melden Sie sich mit Ihren üblichen Zugangsdaten bei Braze an, einschließlich Single Sign-on, falls Ihr Unternehmen es verwendet. Wenn Ihre Anmeldung Zugriff auf mehr als ein Unternehmen im selben Cluster hat, wählen Sie das Unternehmen aus, das Sie verwenden möchten.
6. Prüfen Sie auf dem Zustimmungsbildschirm den angeforderten Zugriff, aktivieren Sie das Kontrollkästchen zur Bestätigung und wählen Sie dann Weiter. 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

Während der Migration können Sie den lokalen Beta-Server und den remote gehosteten Server 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 es auf dem lokalen Beta-Server nicht gibt. Wenn Sie Skills für den lokalen Server erstellt haben, müssen Sie diese Skills möglicherweise aktualisieren, damit sie auf die neuen Tool-Namen und das neue Verhalten verweisen.

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

Fehlerbehebung

Authentifizierung beim MCP schlägt fehl

1. Stellen Sie sicher, dass Ihr:e Unternehmensadministrator:in den MCP-OAuth-Zugriff in den OAuth-Einstellungen aktiviert hat.
2. Stellen Sie sicher, dass Ihr Nutzerkonto die Berechtigung „Use MCP Server“ hat.
3. Stellen Sie sicher, dass Ihr MCP-Client genehmigt ist. Wenn Sie beim Zustimmungsschritt „This app needs approval“ oder eine allgemeine Fehlermeldung wie „An unexpected error occurred“ sehen, bitten Sie Ihre:n Unternehmensadministrator:in, den verifizierten Client oder dessen Weiterleitungs-URI unter MCP-Clients zu genehmigen.
4. Wiederholen Sie die Anmeldung und Autorisierung.

Eine funktionierende Verbindung authentifiziert sich nicht mehr

Wenn Ihr Client verbunden war und sich nun nicht mehr authentifizieren kann, hat Ihr:e Unternehmensadministrator:in 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, prüfen Sie, ob der MCP-OAuth-Zugriff aktiviert ist und Sie weiterhin die Berechtigung „Use MCP Server“ haben.

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 die erwarteten Tools zugreifen

1. Stellen Sie sicher, dass Ihr Dashboard-Nutzerkonto über die erforderlichen Berechtigungen verfügt. Ihr Agent kann nur Tools verwenden, die Ihrem eigenen Dashboard-Zugriff entsprechen.
2. Stellen Sie sicher, dass Sie in Ihrem Prompt den erwarteten Workspace 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 genauen Namen, der im Braze-Dashboard angezeigt wird. Wenn Sie keinen Workspace angeben, fragt Ihr Agent möglicherweise nach oder verwendet einen unerwarteten Workspace.

Wichtig

Bestätigen Sie immer, welchen Workspace Ihr Agent verwendet, bevor er mit der Arbeit beginnt. In manchen Fällen wählt ein Agent möglicherweise einen anderen Workspace als den von Ihnen beabsichtigten.

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 sich erneut und wählen Sie bei der Anmeldung das andere Unternehmen 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.