Agenten anbinden

Ein Agent kann Brandhub nutzen, wenn er Remote-MCP per Streamable HTTP mit eigenem Header spricht. Sie brauchen dafür einen API-Key Ihrer Marke und die folgenden Verbindungsdaten. Die Anleitungen für die einzelnen Agenten verweisen hierher.

Verbindungsdaten

Tragen Sie als Server-URL ein und ersetzen Sie <marke> durch die Subdomain Ihres Portals:

https://<marke>.brandhub.31m.de/mcp

Als Header senden Sie:

Authorization: Bearer IHR_API_KEY

Als Transport wählen Sie Streamable HTTP.

API-Key

Den Key fordern Sie bei Ihrem Brand Success Management an. Für den Anfang reicht read mit kurzer Gültigkeit, etwa 30 Tage. write brauchen Sie erst, wenn der Agent Seiten anlegen oder Blöcke ändern soll. Brandhub zeigt den Key nur einmal an.

Unterstützte Agenten

Alle Agenten in der Liste senden den Key als Header.

Agent	Anbindung	Voraussetzung
Claude (claude.ai, Desktop)	Custom Connector	in Team und Enterprise legen Owner an
Claude Code	`claude mcp add`	keine
Langdock	MCP-Integration	Rolle Admin oder Integration-Manager
Mistral Le Chat	Custom Connector	nur Admins legen an, keine Resources
Cursor	`mcp.json`	keine
VS Code mit GitHub Copilot	`.vscode/mcp.json`	in Business und Enterprise Policy „MCP servers in Copilot“
n8n	Node „MCP Client Tool“	keine
Microsoft Copilot	Copilot Studio	Freigaben Ihrer IT

Fehlermeldungen

Status	Bedeutung	Abhilfe
`401`	Key falsch, abgelaufen oder ohne `Bearer` davor	Header prüfen
`403`	API für die Marke nicht freigeschaltet	Freischaltung bei Ihrem Brand Success Management anfragen
`429`	Rate-Limit für Aufrufe erreicht	`Retry-After` abwarten, siehe Limits
Tool fehlt	Key ohne `write` oder Modul für die Marke nicht aktiv	Key mit `read` + `write` oder Modul bei Ihrem Brand Success Management anfragen
Tool-Fehler	Suchlimit je Minute oder Tageslimit je Key oder Marke erreicht	Zeitpunkt aus der Meldung abwarten
Fehler	Resource ohne aktives Modul	Modul für die Marke aktivieren lassen

Bei 403 lautet die Meldung „Die API ist für diese Marke nicht aktiviert.“ Die schreibenden Tools create_page, append_block und update_block erscheinen nur mit einem Key, der write trägt. Ein erreichtes Suchlimit meldet ein Tool mit „Wieder möglich ab …“. Die Resources sind Corporate Language und Markenkontext.

Brauchen Sie eine Anbindung nach einem Test nicht mehr, lassen Sie den Key widerrufen.