Brandhub für Entwickler:innen

Brandhub ist die agentische Plattform für Markenarbeit. Guidelines, Corporate Language, Markenkontext und Medien liegen dort als strukturierte, geprüfte Daten. Agenten lesen daraus die Marke, schreiben in ihrem Ton und legen Inhalte im Portal an. Jede Änderung über die Schnittstellen ist versioniert und lässt sich im Backend zurücksetzen.

Für Ihre Systeme gibt es zwei Zugänge. Über den MCP-Server (/mcp) arbeiten Agenten wie Claude, Langdock oder Microsoft Copilot direkt mit der Marke. Die REST-API (/api/v1) liefert dieselben Daten als JSON für eigene Anwendungen und Automatisierungen. Beide nutzen denselben API-Key, dieselben Rechte und dieselben Limits.

AuthentifizierungAPI-Key, Rechte und Fehlercodes.

REST-APIEndpunkte für Marke, Corporate Language, Seiten, Blöcke und Medien.

MCP-ServerTools und Resources für KI-Agenten.

LimitsRate-Limits und Obergrenzen für Suche und Schreiben.

Schnellstart

1. API-Key anfordern

   Ihr Brand Success Management schaltet die API für Ihre Marke frei und stellt den Key aus, mit Lese- oder Schreibrecht. Der Key erscheint nur einmal. Speichern Sie ihn in Ihrem Passwort-Manager.

2. Basis-URL bestimmen

   Die API liegt unter der Portal-Adresse Ihrer Marke. Ersetzen Sie <marke> durch die Subdomain Ihres Portals.

   https://<marke>.brandhub.31m.de/api/v1

3. Erste Abfrage senden

   REST (curl)

   GET /brand liefert Stammdaten und Theme der Marke.

   curl -H "Authorization: Bearer IHR_API_KEY" \
        -H "Accept: application/json" \
        https://<marke>.brandhub.31m.de/api/v1/brand

   {
     "slug": "<marke>",
     "name": "Ihre Marke",
     "theme": {
       "colors": { "primary": "#14323D", "accent": "…", "background": "…", "text": "…", "link": "…" },
       "palette": [ … ],
       "font": "…",
       "fonts": [ { "role": "headline", "family": "…", "base_weight": 700, "faces": [ … ] } ]
     }
   }

   MCP (Claude Code)

   Server eintragen:

   claude mcp add --transport http brandhub \
     https://<marke>.brandhub.31m.de/mcp \
     --header "Authorization: Bearer IHR_API_KEY"

   Fragen Sie in einer Sitzung „Welche Primärfarbe hat unsere Marke?“. Claude ruft dafür get_brand_colors auf. Guidelines durchsucht es mit search_pages. Mit Schreibrecht hängt es Blöcke per append_block an.

Bei 401 oder 403 finden Sie die Ursache unter Authentifizierung.

Anleitungen für Agenten

Agenten anbindenVerbindungsdaten, unterstützte Agenten und Fehlermeldungen.

Microsoft CopilotÜber Copilot Studio in Microsoft 365 Copilot und Teams.