Für Entwickler · Kapitel 25
MCP
Baut ein KI-Assistent im Editor eine Seite für einen Kunden, rät er Farben gern. Über MCP, das Model Context Protocol, fragt er stattdessen nexbrand und baut mit den echten Werten.
Einrichten
MCP benutzt dieselben Token wie die API. Du legst unter Mein Konto, Verbindungen ein Token an und trägst nexbrand in die MCP-Einstellungen deines Editors ein:
{"mcpServers": {"nexbrand": {
"type": "http",
"url": "https://brand.example.com/api/mcp",
"headers": {"Authorization": "Bearer nxb_…"}
}}}nexbrand spricht MCP unter /api/mcp als Streamable HTTP ohne Ströme: Jede Anfrage bekommt ihre Antwort als JSON, eine Sitzung gibt es nicht, und jede Anfrage trägt das Token.
Acht Werkzeuge
| Werkzeug | was es tut |
|---|---|
list_clients | die Kunden mit geltender Fassung, Hauptfarben und Projekten |
get_brand | die CI eines Kunden: Farben, Schriften, Logos mit Dateiadressen, Größen, Regeln, Prüfungen; auch für eine Fassung, einen Tag oder ein Projekt |
get_code | die CI als CSS, Tailwind, SCSS oder Design Tokens |
list_versions | alle Fassungen mit dem Tag, ab dem sie gelten |
compare_versions | was sich zwischen zwei Fassungen geändert hat, wie im Vergleich |
check_contrast | Kontrast einer Schrift auf einem Grund, mit Noten und der nächsten reichenden Farbe |
audit | Farbwerte und CSS gegen die CI |
propose_version | ein Redesign als Entwurf zurückschreiben, mit Name und Notiz |
propose_version sieht nur ein Token der Stufe Lesen und Entwürfe anlegen. Für ein Token, das nur liest, gibt es das Werkzeug gar nicht.
Was die KI mitbekommt
nexbrand gibt dem Assistenten eine kurze Anweisung mit: vor dem Bauen get_brand aufrufen, nie Farbwerte erfinden, ein Redesign mit propose_version vorschlagen. Ein solcher Entwurf erscheint in nexbrand mit der Herkunft über MCP und dem Namen des Tokens als Autor. Veröffentlichen tut ihn ein Mensch, oder er wirft ihn weg.
Dieselben Wälle wie die API
MCP folgt denselben Regeln wie /api/v1: Schalter des Betreibers, Token, 600 Anfragen in der Minute, keine Anfragen aus Webseiten, und dieselben Rechte wie in der Oberfläche. Ein Token sieht über MCP nicht mehr als über die API.
Pavo sagtEin Token für den Editor muss meist nur lesen. Die Stufe zum Zurückschreiben gibst du nur, wenn die KI wirklich Entwürfe vorschlagen soll.