MCP-Server im Überblick
Über den MCP-Server liest ein KI-Agent Farben, Sprachregeln, Markenkontext, Guidelines-Seiten, Bilder und Download-Dateien Ihrer Marke. Mit Schreibrecht legt er Seiten an und ändert einzelne Blöcke.
Verbindung
Abschnitt betitelt „Verbindung“Der Server läuft unter der Portal-Adresse Ihrer Marke. Ersetzen Sie <marke> durch die Subdomain
Ihres Portals.
https://<marke>.brandhub.31m.de/mcpJeder Aufruf braucht diesen Header:
Authorization: Bearer IHR_API_KEYDer Transport ist Streamable HTTP (Remote-MCP), kein SSE und kein lokaler Prozess. Rechte und Limits gelten wie bei der REST-API, siehe Authentifizierung und Limits.
Der Server bietet 15 Tools in fünf Gruppen. Parameter und Antwortfelder stehen in der MCP-Referenz.
| Tool | Zweck | Recht |
|---|---|---|
get_brand |
Stammdaten und Theme mit Farben und Schriften je Rolle | read |
get_brand_colors |
Markenfarben, kurz oder mit allen Werten | read |
Mit allen Werten liefert get_brand_colors HEX, RGB, CMYK, Pantone, RAL und Abstufungen.
Sprache und Wissen
Abschnitt betitelt „Sprache und Wissen“| Tool | Zweck | Recht |
|---|---|---|
get_corporate_language |
Sprachleitfaden ganz oder je Sektion und Kapitel | read |
check_terms |
Text gegen verbotene und bevorzugte Begriffe und die Firmierung prüfen | read |
get_brand_context |
geprüfter Markenkontext, ganz oder je Kategorie, je Eintrag mit Beleg | read |
search_website |
die eingelesene Website der Marke nach Bedeutung durchsuchen | read |
check_terms meldet jeden Fund mit Zeile, Position, Ersatzvorschlag und Begründung. Das Tool prüft
Wortlisten, keinen Ton und keinen Stil. Dafür holt der Agent die Kapitel der Stimme über
get_corporate_language.
search_website findet Produkte, Angebote, News und Unternehmensseiten. Ein Treffer enthält Titel,
URL, Überschrift und Textauszug, höchstens zwei Abschnitte je Website-Seite.
Medien und Dateien
Abschnitt betitelt „Medien und Dateien“| Tool | Zweck | Recht |
|---|---|---|
search_media |
freigegebene Bilder nach Stichwort, Kategorie, Tags, Format, Herkunft und KI filtern | read |
get_media_item |
Rechte, Personen, KI-Kennzeichnung, Maße, Zuschnitte und Download-Links eines Bildes | read |
search_downloads |
Logos, Vorlagen, Schriften und Dokumente nach Titel, Dateiname und Typ | read |
get_media |
veraltet, listet alle Bilder ohne Filter; stattdessen search_media nutzen |
read |
Bilder mit locked: true zeigt der Agent an, Download-Links liefert get_media_item für sie
nicht. search_downloads gibt je Datei eine Portal-URL zurück, keine Datei. Der Download läuft im
Portal, bei Dateien mit Sichtbarkeit login nach der Anmeldung. Auch die Links aus
get_media_item führen ins Portal und verlangen dort einen Login.
| Tool | Zweck | Recht |
|---|---|---|
search_pages |
Guidelines-Seiten durchsuchen, ohne Suchbegriff alle Seiten als Liste | read |
get_page |
eine Seite mit allen Blöcken und deren stabilen IDs | read |
search_pages durchsucht Titel und Inhalte der Seiten im Volltext, mit Modul „Markenagent (KI)“
zusätzlich nach Bedeutung. Ein Treffer enthält Seiten-ID, Titel, Slug, URL des Abschnitts,
Textauszug und Kapitel. Die Seiten-ID übergeben Sie an get_page und die schreibenden Tools. Beide
Such-Tools finden nur Inhalte, die das Portal Ihrer Marke zeigt.
Schreiben
Abschnitt betitelt „Schreiben“| Tool | Zweck | Recht |
|---|---|---|
create_page |
eine Seite anlegen, optional mit Start-Blöcken | write |
append_block |
einen Block ans Ende einer Seite hängen | write |
update_block |
einen Block über seine ID ändern, nicht gesendete Felder bleiben erhalten | write |
Die schreibenden Tools prüfen jeden Block wie der Editor im Backend (Typ, Pflichtfelder, erlaubtes
HTML). Schreibbar sind heading, rich_text, alert, button, video, image_placeholder,
accordion, table, columns, group, image, gallery, tabs, asset_download,
download_list und color_palette.
Medien- und Asset-Blöcke verweisen auf IDs aus der Medienbibliothek. Brandhub prüft jede ID gegen die Marke des Keys und lehnt fremde oder erfundene IDs ab, auch in Spalten und Gruppen.
Änderungen erscheinen sofort im Portal. Brandhub versioniert sie, im Backend lassen sie sich nachvollziehen und zurücksetzen. Löschen ist über MCP nicht möglich.
Welche Tools Ihr Agent sieht
Abschnitt betitelt „Welche Tools Ihr Agent sieht“Der Server zeigt einem Agenten nur die Tools, die für Ihre Marke und den Key freigeschaltet sind.
Die schreibenden Tools erscheinen nur mit einem Key, der write trägt. Mit einem reinen Lese-Key
fehlen sie in der Liste.
Sieben Tools hängen an einem Modul. get_corporate_language und check_terms brauchen das Modul
„Corporate Language“. search_media, get_media_item und get_media brauchen das Modul „Media“.
get_brand_context braucht das Modul „Markenagent (KI)“, search_website zusätzlich eine
eingelesene Website. get_brand, get_brand_colors, search_downloads, search_pages und
get_page stehen jeder Marke zur Verfügung.
Fehlt Ihrem Agenten ein Tool, ist das Modul für Ihre Marke nicht aktiv. Freischalten lässt es Ihr Brand Success Management.
Typischer Ablauf
Abschnitt betitelt „Typischer Ablauf“Für einen Text holt der Agent zuerst die Sprachregeln mit get_corporate_language, Inhalte und
Argumente mit get_brand_context. Dann schreibt er den Entwurf und prüft ihn mit check_terms.
Die Funde ersetzt er und prüft erneut.
Für eine Änderung im Portal sucht der Agent die Seite mit search_pages, liest sie mit get_page
und übernimmt die Block-ID. Dann ändert er mit append_block oder update_block.
Resources
Abschnitt betitelt „Resources“| Resource | Inhalt | Modul |
|---|---|---|
brandhub://corporate-language |
der gesamte Sprachleitfaden | Corporate Language |
brandhub://brand-context |
der geprüfte Markenkontext, je Eintrag mit Beleg | Markenagent (KI) |
Ohne das zugehörige Modul meldet die Resource einen Fehler. Der Sprachleitfaden umfasst Stimme, Terminologie, Firmierung und Schreibweisen. Der Markenkontext umfasst Positionierung, Zielgruppen, Angebot, Wettbewerb, Kernbotschaften, Fakten und FAQ.
Dieselben Inhalte liefern die Tools get_corporate_language und get_brand_context, dort auch
in Teilen. Agenten, die keine Resources lesen, kommen so ebenfalls an Sprachleitfaden und
Markenkontext.
Die Corporate Language pflegen Sie über die REST-API. Ein schreibendes MCP-Tool dafür gibt es nicht.