Braze MCP mit Microsoft Copilot verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Braze klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

Braze + Microsoft Copilot

Lass deine KI mit Braze arbeiten: Kampagnen, Canvases und ihre Ergebnisse prüfen, Segmente, täglich aktive Nutzer und Umsatz ansehen, Nutzerprofile und Abonnements nachschlagen, Attribute und Events erfassen und nach deiner Bestätigung API-Kampagnen auslösen.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

BRAZE_REST_ENDPOINT, BRAZE_REST_API_KEY

Schritt 1 — Zugangsdaten holen

1. Öffne in Braze Settings → APIs and Identifiers → API Keys und klicke auf Create API Key. Ein Schlüssel gehört zu genau einem Workspace.
2. Gib ihm einen Namen und hake die Berechtigungen an, die die Tools brauchen. Zum Lesen: campaigns.list, campaigns.details, campaigns.data_series, sends.data_series, canvas.list, canvas.details, canvas.data_summary, segments.list, segments.details, segments.data_series, kpi.dau.data_series, kpi.mau.data_series, kpi.new_users.data_series, kpi.uninstalls.data_series, events.list, events.data_series, purchases.product_list, purchases.quantity_series, purchases.revenue_series, subscription.status.get, subscription.groups.get, users.export.ids. Zum Schreiben zusätzlich users.track, campaigns.trigger.send, canvas.trigger.send, und users.delete nur, wenn das Lösch-Tool aktiviert werden soll. Die Berechtigungen eines Schlüssels lassen sich später nicht ändern: Lege stattdessen einen neuen Schlüssel an.
3. Kopiere den Schlüssel in BRAZE_REST_API_KEY, ohne das Präfix Bearer.
4. Kopiere den REST endpoint von derselben Seite in BRAZE_REST_ENDPOINT. Er hängt von deiner Braze-Instanz ab und passt zu deiner Dashboard-Adresse: dashboard-01.braze.com nutzt https://rest.iad-01.braze.com, dashboard-01.braze.eu nutzt https://rest.fra-01.braze.eu und so weiter. US-Instanzen laufen auf rest.iad-01 bis rest.iad-08 und rest.us-10 (.braze.com), EU-Instanzen auf rest.fra-01 und rest.fra-02 (.braze.eu), weitere auf rest.au-01, rest.id-01, rest.jp-01 und rest.kr-01 (.braze.com). Ein Schlüssel funktioniert nur auf seiner eigenen Instanz.
5. Installiere den Connector. Der Verbindungstest listet deine Kampagnen auf, der Schlüssel braucht also campaigns.list.

Wer was sieht: Der Schlüssel handelt für den ganzen Workspace, nicht für eine Person. Wer den Connector nutzt, sieht alles, was der Schlüssel lesen kann, auch Nutzerprofile. Teile den MCP-Server nur mit Personen, die das sehen dürfen.

Was der Connector liest: Kampagnen und Canvases mit Einrichtung, Nachrichten und täglichen Ergebnissen (Sends, Zustellungen, Öffnungen, Klicks, Conversions, Umsatz), die Ergebnisse eines einzelnen API-ausgelösten Versands (14 Tage gespeichert), Segmente mit ihrer geschätzten Größe (bei Segmenten mit Analytics Tracking), täglich und monatlich aktive Nutzer, neue Nutzer und Deinstallationen, Custom Events, Käufe und Umsatz, Nutzerprofile per External ID, Alias, braze_id, E-Mail oder Telefonnummer sowie den Status von Subscription Groups. Zeitreihen umfassen 1 bis 100 Tage, Canvas-Zusammenfassungen 1 bis 14.

Erst bestätigen: braze_track_users erfasst Attribute, Custom Events und Käufe, bis zu 75 pro Aufruf, und kann Nutzer in Segmente bringen und Canvases starten. Die KI zeigt dir deshalb die Änderungen und wartet auf deine Bestätigung. braze_send_campaign und braze_send_canvas lösen API-Kampagnen und Canvases aus, die echte Nachrichten an echte Menschen senden: Die KI zeigt dir die Kampagne oder das Canvas, den Kanal und genau, wer sie erhält, und bei einem Broadcast oder mehr als einem Empfänger wartet sie auf ein ausdrückliches „ja, senden“. braze_delete_users ist bei der Installation deaktiviert.

Limits: Die meisten Endpoints erlauben 250.000 Anfragen pro Stunde. Das Lesen von Nutzerprofilen erlaubt 250 Aufrufe pro Minute für Workspaces, die seit August 2024 eingerichtet wurden (davor 2.500), die Listen der Custom Events und Produkte teilen sich 1.000 pro Stunde, und die Sende-Endpoints erlauben 250 Broadcast-Aufrufe pro Minute und 10 pro Minute je Zielgruppe. Ist ein Limit erreicht, antwortet Braze mit 429.

Häufige Fehler: 401 "Invalid API key": Der Schlüssel ist falsch oder gehört zu einer anderen Instanz; prüfe, ob der REST endpoint zu deinem Dashboard passt. 403 "Access Denied": Dem Schlüssel fehlt die Berechtigung für diesen Endpoint, lege also einen Schlüssel an, der sie hat. 400: Ein Parameter fehlt oder ist ungültig, zum Beispiel eine Länge außerhalb des Bereichs oder eine unbekannte Kampagnen-ID. 429: Ein Rate Limit ist erreicht; warte und versuche es einmal erneut.

Der Connector deckt keine Content Blocks und Templates, Kataloge, E-Mail-Listen und Hard Bounces, geplanten Nachrichten, Preference Center, SCIM, die Endpoints für User Alias und Identify, Segment-Exporte in Cloud-Speicher oder Currents ab.

Schritt 2 — Adapter installieren

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Schritt 3 — Connector in Microsoft Copilot hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Microsoft Copilot nutzt MCP-Server über Agents, die du in Copilot Studio baust: Du fügst AnythingMCP einem Agent als Tool hinzu und veröffentlichst den Agent dann in Microsoft 365 Copilot und Teams. Copilot Studio verbindet sich aus der Cloud von Microsoft per Streamable HTTP, das AnythingMCP unterstützt.

1. Öffne in Copilot Studio deinen Agent (oder leg einen an), geh zu Tools und wähle Add a tool → New tool → Model Context Protocol.
2. Trag einen Server name ein (zum Beispiel AnythingMCP), eine Server description, die sagt, was der Connector kann, und die Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Anhand der Beschreibung entscheidet Copilot Studio, wann es den Server aufruft.
3. Wähle bei der Authentifizierung API key, setze Type auf Header und den Header-Namen auf X-API-Key und klicke auf Create.
4. Wähle in Add tool die Option Create a new connection, füge einen MCP-API-Key aus AnythingMCP ein (MCP Servers → dein Server → API keys) und klicke auf Add to agent.
5. Probier es im Test-Bereich des Agents aus: Bitte um etwas, wofür er die Braze-Tools braucht.
6. Klicke auf Publish, dann auf Channels → Microsoft 365 and Microsoft Teams, lass Make agent available in Microsoft Copilot aktiviert und wähle Add channel. See agent in Teams installiert den Agent für dich; in Microsoft 365 Copilot tippst du @ und wählst den Agent aus.

Lieber eine Anmeldung pro Person? Wähle statt API key OAuth 2.0 → Dynamic discovery: Dann meldet sich jede Person beim ersten Aufruf des Agents bei AnythingMCP an.

Du hostest selbst? Nimm statt https://cloud.anythingmcp.com die öffentliche HTTPS-Adresse deiner Instanz. Copilot Studio verbindet sich aus der Cloud von Microsoft, localhost funktioniert deshalb nicht.

Verfügbare Tools

Beispiel-Prompts

• „Welche Kampagnen haben wir in den letzten 30 Tagen gesendet, und welche hatte die besten Öffnungs- und Klickraten?“
• „Wie viele Nutzer sind letzte Woche in unser Onboarding-Canvas eingestiegen, und wie viele haben bei jedem Schritt konvertiert?“
• „Zeig mir die täglich aktiven Nutzer und die neuen Nutzer der letzten 60 Tage.“
• „Erfasse das Custom Event webinar_attended für den Nutzer mit der external_id 4821 und zeig mir vorher, was du schreiben wirst.“

FAQ

Für welchen Copilot gilt das? Für Microsoft 365 Copilot im Unternehmen, über Agents aus Copilot Studio. Die Microsoft-Copilot-App für private Konten bietet keine Möglichkeit, einen eigenen MCP-Server hinzuzufügen.

Was brauche ich? Ein Arbeitskonto mit Zugang zu Copilot Studio (Lizenz oder Testversion), um den Agent zu bauen. Wer ihn in Microsoft 365 Copilot oder Teams nutzen soll, braucht Zugriff auf den Agent: Teile ihn oder lass ihn von einem Admin für die Organisation veröffentlichen. Wendet deine Organisation Datenrichtlinien auf Power-Platform-Connectors an, gelten sie auch für MCP-Server.

Der Agent ruft die Tools nicht auf. Prüfe, dass der Header-Name genau X-API-Key lautet und der Schlüssel zum selben MCP-Server gehört wie die URL, und formuliere die Server description konkret: Copilot Studio entscheidet anhand der Beschreibung, wann es den Server aufruft. Veröffentliche den Agent nach jeder Änderung erneut; in einem offenen Chat holst du die neue Version mit „start over“.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden
• Mit Cursor verbinden
• Mit Gemini verbinden
• Mit Meta Muse verbinden