MCP

Der DesignerBox MCP-Server lässt einen AI-Assistenten direkt mit deinem DesignerBox-Konto arbeiten. Bitte Claude, ein Produktfoto zu generieren, ein Template anzuwenden, dein Credit-Guthaben zu prüfen oder ein Asset aus deiner Bibliothek zu holen: Es passiert in deinem Konto und erscheint in der App.

MCP (Model Context Protocol) ist ein offener Standard, um AI-Assistenten mit externen Tools zu verbinden. DesignerBox betreibt einen gehosteten MCP-Server, du musst also nichts installieren und nichts selbst hosten.

Server-URL

Verbinde deinen Client mit:

https://mcp.designerbox.ai/api

Der Pfad lautet /api, nicht /mcp. Der Server spricht JSON-RPC 2.0 über streamable HTTP.

Assistenten verbinden

Die genauen Schritte unterscheiden sich je nach Client, aber der Ablauf ist immer derselbe: einen Custom Connector hinzufügen, die Server-URL einfügen und sich anmelden.

Claude (Web, Desktop und Cowork)

Öffne die Einstellungen und dann Connectors.
Wähle die Option, einen Custom Connector hinzuzufügen.
Füge https://mcp.designerbox.ai/api ein.
Schließe die DesignerBox-Anmeldung ab, wenn sich dein Browser öffnet.
Starte einen Chat und frage nach etwas, zum Beispiel "liste meine DesignerBox-Designs auf".

Der Connector registriert sich automatisch, es gibt also keine Client-ID und kein Secret zum Kopieren. Sobald die Verbindung in Claude besteht, ist dieselbe Verbindung auch in Cowork verfügbar.

Cursor und andere MCP-Clients

Jeder Client, der Remote-MCP-Server über streamable HTTP unterstützt, funktioniert. Richte ihn auf dieselbe URL. Clients mit OAuth-Discovery finden den Anmeldeflow von selbst.

Authentifizierung

DesignerBox MCP nutzt ausschließlich OAuth. Du meldest dich über deinen Browser an, und dein Client erhält ein Token, das nur für dein Konto gilt. Es gibt keinen API-Key zum Einfügen, und API-Keys aus anderen Bereichen von DesignerBox werden hier nicht akzeptiert.

Der Server unterstützt dynamische Client-Registrierung, sodass sich saubere Clients allein anhand der URL selbst konfigurieren. Tokens werden mit diesen Scopes ausgestellt:

openid - identifiziert dein Konto.
mcp:read - deine Designs, Assets, Templates und deinen Plan lesen.
mcp:write - Medien generieren und deine Daten ändern.
offline_access - die Sitzung erneuern, damit du dich nicht jeden Tag anmelden musst.

Deine Teamzugehörigkeit wird bei jeder Anfrage geprüft. Wird jemand aus einem Team entfernt, ist sein Zugriff sofort entzogen, ohne dass ein Token erst ablaufen muss.

Um einen verbundenen Assistenten zu prüfen oder zu widerrufen, öffne die MCP-Verbindungen in deinen Kontoeinstellungen in der App. Ein Widerruf dort trennt diesen Client.

Was dein Assistent tun kann

Der Server stellt 63 Tools bereit, 37 lesende und 26 schreibende. Du musst ihre Namen nicht kennen. Frag in normaler Sprache nach dem, was du brauchst, und der Assistent wählt das passende Tool.

Die wichtigsten Bereiche:

Generieren. Bilder, Videos, Cinema-Studio-Aufnahmen und AI-Characters.
Bearbeiten. Hintergrund entfernen, Neubeleuchtung und Blickwinkel, Haut-Retusche, virtuelle Anprobe, Flat Lays und Produktanzeigen.
Templates und Techniken. Den kuratierten Katalog durchsuchen und ein Template auf deine eigenen Referenzbilder anwenden.
Bibliothek. Deine Designs, Assets, Ordner und Galerien auflisten und abrufen oder ein neues Asset direkt aus dem Chat hochladen.
Marke. Dein Markenprofil und deine Marken-Assets lesen und aktualisieren.
Workflows. Pipelines aus dem Canvas auflisten, erstellen und ausführen.
Konto. Plan, Credit-Guthaben, Limits und Teams prüfen.

Lesende und schreibende Tools sind gekennzeichnet, damit dein Assistent weiß, welche Aktionen dein Konto verändern. Die meisten Clients fragen beim ersten Mal nach einer Bestätigung, bevor sie ein schreibendes Tool ausführen.

Probier das aus

"Generiere ein Produktfoto einer mattschwarzen Trinkflasche auf einer Betonoberfläche."
"Welche Templates gibt es für Fashion Flat Lays?"
"Wie viele Credits habe ich diesen Monat noch?"
"Entferne den Hintergrund vom letzten Bild, das du erstellt hast."
"Liste meine Designs aus dieser Woche auf."

Pläne und Credits

Generierungen verbrauchen Credits aus demselben monatlichen Pool wie die App. Es gibt kein separates MCP-Kontingent und keine Zusatzkosten für die Nutzung von MCP. Der Free-Plan enthält 112 Credits (etwa vier Bilder mit dem Standardmodell), du kannst Generierung also vor einem Upgrade ausprobieren; sind die Credits aufgebraucht, stoppen die Generierungs-Tools, bis dein Kontingent aufgefrischt wird oder du upgradest, während die lesenden Tools weiter funktionieren.

Die Kosten pro Bild hängen vom Modell ab:

Modell	Credits pro Bild
Seedream 5	4
FLUX Pro 1.1	5
Nano Banana 2	7
FLUX 2 Flex	7
Nano Banana Pro	14
GPT Image 2	22

Weitere Aktionen:

Aktion	Credits
Eine Technik auf ein Bild anwenden	Die Kosten pro Bild des gewählten Modells (14 beim Standardmodell)
Hintergrund entfernen	3
Cinema Studio	2 pro Bild
AI Character (9 Posen)	25
Video	Modellrate pro Sekunde, mal Dauer

Bitte deinen Assistenten, die Bild- oder Videomodelle aufzulisten, wenn du aktuelle Kosten und Funktionen sehen willst, ohne den Chat zu verlassen. Das ganze Bild findest du unter Pläne, Credits und Limits.

Wie lange das dauert

Manche Tools werden noch im Gespräch fertig, andere laufen im Hintergrund:

Bilder werden im Chat fertig. Eine Generierung dauert rund 30 Sekunden, und der Assistent liefert das Bild, sobald es fertig ist.
Videos und AI-Characters laufen im Hintergrund. Du bekommst sofort eine Task-Referenz, und der Assistent prüft den Status, bis alles bereit ist. Du kannst weiterarbeiten oder später zurückkommen und fragen, ob es fertig ist.

Alles, was du generierst, wird in deiner DesignerBox-Bibliothek gespeichert und ist damit in der App, egal ob der Chat noch offen ist oder nicht.

Limits

Anfragen sind pro Konto rate-limitiert. Normale Nutzung im Gespräch bleibt deutlich innerhalb der Limits. Wenn ein Assistent in einer Schleife läuft oder viele Anfragen auf einmal sendet, wird er kurz gedrosselt und sollte es erneut versuchen.

Fehlerbehebung

Der Assistent findet den Server nicht. Prüfe, ob die URL auf /api endet. https://mcp.designerbox.ai/mcp ist nicht gültig und liefert Not Found.

Die Anmeldung klappt, aber Tools scheitern mit einem Autorisierungsfehler. Dein Token wurde vielleicht widerrufen, oder du wurdest aus dem Team entfernt. Verbinde den Connector neu.

Eine Generierung bricht ab und erwähnt Credits. Deine monatlichen Credits sind aufgebraucht (der Free-Plan startet mit 112). Lesende Tools funktionieren weiter; um wieder zu generieren, warte auf die Auffrischung deines Kontingents, kaufe ein Credit-Pack oder mach ein Upgrade. Prüfe dein Guthaben in der App oder frag den Assistenten nach deinem Plan.

Der Assistent wählt das falsche Tool. Beschreibe das Ergebnis genauer. "Wende das Linen-Flat-Lay-Template auf dieses Foto an" funktioniert besser als "mach das schöner".

Verwandt

API - die REST-API, für Code statt Konversation.
Pläne, Credits und Limits - wie Generierungen Credits verbrauchen.
Workflows und Canvas - die Pipelines, die MCP ausführen kann.
Techniken und Templates - der Katalog, den dein Assistent anwenden kann.