{"componentChunkName":"component---src-templates-docs-js","path":"/de-de/integrations/mcp","result":{"data":{"site":{"siteMetadata":{"title":"Documentation | DesignerBox","docsLocation":""}},"mdx":{"fields":{"id":"18ff8986-fadb-5846-8279-b8dea9d1d6d5","title":"MCP","slug":"/de-de/integrations/mcp","locale":"de-DE"},"body":"var _excluded = [\"components\"];\nfunction _extends() { return _extends = Object.assign ? Object.assign.bind() : function (n) { for (var e = 1; e < arguments.length; e++) { var t = arguments[e]; for (var r in t) ({}).hasOwnProperty.call(t, r) && (n[r] = t[r]); } return n; }, _extends.apply(null, arguments); }\nfunction _objectWithoutProperties(e, t) { if (null == e) return {}; var o, r, i = _objectWithoutPropertiesLoose(e, t); if (Object.getOwnPropertySymbols) { var n = Object.getOwnPropertySymbols(e); for (r = 0; r < n.length; r++) o = n[r], -1 === t.indexOf(o) && {}.propertyIsEnumerable.call(e, o) && (i[o] = e[o]); } return i; }\nfunction _objectWithoutPropertiesLoose(r, e) { if (null == r) return {}; var t = {}; for (var n in r) if ({}.hasOwnProperty.call(r, n)) { if (-1 !== e.indexOf(n)) continue; t[n] = r[n]; } return t; }\n/* @jsxRuntime classic */\n/* @jsx mdx */\n\nvar _frontmatter = {\n  \"title\": \"MCP\",\n  \"metaTitle\": \"DesignerBox MCP | AI-Assistenten verbinden\",\n  \"metaDescription\": \"Verbinde DesignerBox mit Claude, Cursor, ChatGPT und jedem MCP-Client. Generiere Bilder und Videos, verwalte Assets und starte Workflows im Chat.\",\n  \"order\": 3\n};\nvar layoutProps = {\n  _frontmatter: _frontmatter\n};\nvar MDXLayout = \"wrapper\";\nreturn function MDXContent(_ref) {\n  var components = _ref.components,\n    props = _objectWithoutProperties(_ref, _excluded);\n  return mdx(MDXLayout, _extends({}, layoutProps, props, {\n    components: components,\n    mdxType: \"MDXLayout\"\n  }), mdx(\"h1\", null, \"MCP\"), mdx(\"p\", null, \"Der DesignerBox MCP-Server l\\xE4sst einen AI-Assistenten direkt mit deinem DesignerBox-Konto arbeiten. Bitte Claude, ein Produktfoto zu generieren, ein Template anzuwenden, dein Credit-Guthaben zu pr\\xFCfen oder ein Asset aus deiner Bibliothek zu holen: Es passiert in deinem Konto und erscheint in der App.\"), mdx(\"p\", null, \"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.\"), mdx(\"p\", null, mdx(\"span\", {\n    parentName: \"p\",\n    \"className\": \"gatsby-resp-image-wrapper\",\n    \"style\": {\n      \"position\": \"relative\",\n      \"display\": \"block\",\n      \"marginLeft\": \"auto\",\n      \"marginRight\": \"auto\",\n      \"maxWidth\": \"800px\"\n    }\n  }, \"\\n      \", mdx(\"a\", {\n    parentName: \"span\",\n    \"className\": \"gatsby-resp-image-link\",\n    \"href\": \"/docs/static/4c3c658a490868a68460ef55f89028f7/356e8/home.jpg\",\n    \"style\": {\n      \"display\": \"block\"\n    },\n    \"target\": \"_blank\",\n    \"rel\": \"noopener\"\n  }, \"\\n    \", mdx(\"span\", {\n    parentName: \"a\",\n    \"className\": \"gatsby-resp-image-background-image\",\n    \"style\": {\n      \"paddingBottom\": \"57.00000000000001%\",\n      \"position\": \"relative\",\n      \"bottom\": \"0\",\n      \"left\": \"0\",\n      \"backgroundImage\": \"url('data:image/jpeg;base64,/9j/2wBDABALDA4MChAODQ4SERATGCgaGBYWGDEjJR0oOjM9PDkzODdASFxOQERXRTc4UG1RV19iZ2hnPk1xeXBkeFxlZ2P/2wBDARESEhgVGC8aGi9jQjhCY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2NjY2P/wgARCAALABQDASIAAhEBAxEB/8QAFwABAQEBAAAAAAAAAAAAAAAAAAUBBP/EABUBAQEAAAAAAAAAAAAAAAAAAAAB/9oADAMBAAIQAxAAAAHun1Z5gj//xAAbEAABBAMAAAAAAAAAAAAAAAABAAIDBBMyNP/aAAgBAQABBQKyZQclxNktKfVnKSQv/8QAFBEBAAAAAAAAAAAAAAAAAAAAEP/aAAgBAwEBPwE//8QAFBEBAAAAAAAAAAAAAAAAAAAAEP/aAAgBAgEBPwE//8QAHhAAAgEDBQAAAAAAAAAAAAAAAAECITGSEBETgZH/2gAIAQEABj8Cjxb9ItLEqpY6XfpRs//EABsQAQACAwEBAAAAAAAAAAAAAAEAMREhQXEQ/9oACAEBAAE/IcfKudnz6S9Fe2+eRPseouAjB2f/2gAMAwEAAgADAAAAEEP/AP/EABURAQEAAAAAAAAAAAAAAAAAAAAR/9oACAEDAQE/EEf/xAAVEQEBAAAAAAAAAAAAAAAAAAAAEf/aAAgBAgEBPxBX/8QAHhAAAgICAgMAAAAAAAAAAAAAAREAITFBUXGBkdH/2gAIAQEAAT8QIChqlmEMdxGzw+QzNpTEV6hlIBbIg5cQkmcvdmttx8GSfgT/2Q==')\",\n      \"backgroundSize\": \"cover\",\n      \"display\": \"block\"\n    }\n  }), \"\\n  \", mdx(\"img\", {\n    parentName: \"a\",\n    \"className\": \"gatsby-resp-image-image\",\n    \"alt\": \"Die DesignerBox-App, deren Generierungs- und Asset-Funktionen auch über MCP verfügbar sind\",\n    \"title\": \"Die DesignerBox-App, deren Generierungs- und Asset-Funktionen auch über MCP verfügbar sind\",\n    \"src\": \"/docs/static/4c3c658a490868a68460ef55f89028f7/4b190/home.jpg\",\n    \"srcSet\": [\"/docs/static/4c3c658a490868a68460ef55f89028f7/e07e9/home.jpg 200w\", \"/docs/static/4c3c658a490868a68460ef55f89028f7/066f9/home.jpg 400w\", \"/docs/static/4c3c658a490868a68460ef55f89028f7/4b190/home.jpg 800w\", \"/docs/static/4c3c658a490868a68460ef55f89028f7/e5166/home.jpg 1200w\", \"/docs/static/4c3c658a490868a68460ef55f89028f7/356e8/home.jpg 1512w\"],\n    \"sizes\": \"(max-width: 800px) 100vw, 800px\",\n    \"style\": {\n      \"width\": \"100%\",\n      \"height\": \"100%\",\n      \"margin\": \"0\",\n      \"verticalAlign\": \"middle\",\n      \"position\": \"absolute\",\n      \"top\": \"0\",\n      \"left\": \"0\"\n    },\n    \"loading\": \"lazy\"\n  }), \"\\n  \"), \"\\n    \")), mdx(\"h2\", null, \"Server-URL\"), mdx(\"p\", null, \"Verbinde deinen Client mit:\"), mdx(\"pre\", null, mdx(\"code\", {\n    parentName: \"pre\"\n  }, \"https://mcp.designerbox.ai/api\\n\")), mdx(\"p\", null, \"Der Pfad lautet \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"/api\"), \", nicht \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"/mcp\"), \". Der Server spricht JSON-RPC 2.0 \\xFCber streamable HTTP.\"), mdx(\"h2\", null, \"Assistenten verbinden\"), mdx(\"p\", null, \"Die genauen Schritte unterscheiden sich je nach Client, aber der Ablauf ist immer derselbe: einen Custom Connector hinzuf\\xFCgen, die Server-URL einf\\xFCgen und sich anmelden.\"), mdx(\"h3\", null, \"Claude (Web, Desktop und Cowork)\"), mdx(\"ol\", null, mdx(\"li\", {\n    parentName: \"ol\"\n  }, \"\\xD6ffne die Einstellungen und dann Connectors.\"), mdx(\"li\", {\n    parentName: \"ol\"\n  }, \"W\\xE4hle die Option, einen Custom Connector hinzuzuf\\xFCgen.\"), mdx(\"li\", {\n    parentName: \"ol\"\n  }, \"F\\xFCge \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"https://mcp.designerbox.ai/api\"), \" ein.\"), mdx(\"li\", {\n    parentName: \"ol\"\n  }, \"Schlie\\xDFe die DesignerBox-Anmeldung ab, wenn sich dein Browser \\xF6ffnet.\"), mdx(\"li\", {\n    parentName: \"ol\"\n  }, \"Starte einen Chat und frage nach etwas, zum Beispiel \\\"liste meine DesignerBox-Designs auf\\\".\")), mdx(\"p\", null, \"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\\xFCgbar.\"), mdx(\"h3\", null, \"Cursor und andere MCP-Clients\"), mdx(\"p\", null, \"Jeder Client, der Remote-MCP-Server \\xFCber streamable HTTP unterst\\xFCtzt, funktioniert. Richte ihn auf dieselbe URL. Clients mit OAuth-Discovery finden den Anmeldeflow von selbst.\"), mdx(\"h2\", null, \"Authentifizierung\"), mdx(\"p\", null, \"DesignerBox MCP nutzt \", mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"ausschlie\\xDFlich OAuth\"), \". Du meldest dich \\xFCber deinen Browser an, und dein Client erh\\xE4lt ein Token, das nur f\\xFCr dein Konto gilt. Es gibt keinen API-Key zum Einf\\xFCgen, und API-Keys aus anderen Bereichen von DesignerBox werden hier nicht akzeptiert.\"), mdx(\"p\", null, \"Der Server unterst\\xFCtzt dynamische Client-Registrierung, sodass sich saubere Clients allein anhand der URL selbst konfigurieren. Tokens werden mit diesen Scopes ausgestellt:\"), mdx(\"ul\", null, mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"openid\"), \" - identifiziert dein Konto.\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"mcp:read\"), \" - deine Designs, Assets, Templates und deinen Plan lesen.\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"mcp:write\"), \" - Medien generieren und deine Daten \\xE4ndern.\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"offline_access\"), \" - die Sitzung erneuern, damit du dich nicht jeden Tag anmelden musst.\")), mdx(\"p\", null, \"Deine Teamzugeh\\xF6rigkeit wird bei jeder Anfrage gepr\\xFCft. Wird jemand aus einem Team entfernt, ist sein Zugriff sofort entzogen, ohne dass ein Token erst ablaufen muss.\"), mdx(\"p\", null, \"Um einen verbundenen Assistenten zu pr\\xFCfen oder zu widerrufen, \\xF6ffne die MCP-Verbindungen in deinen Kontoeinstellungen in der App. Ein Widerruf dort trennt diesen Client.\"), mdx(\"h2\", null, \"Was dein Assistent tun kann\"), mdx(\"p\", null, \"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\\xE4hlt das passende Tool.\"), mdx(\"p\", null, \"Die wichtigsten Bereiche:\"), mdx(\"ul\", null, mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"strong\", {\n    parentName: \"li\"\n  }, \"Generieren.\"), \" Bilder, Videos, Cinema-Studio-Aufnahmen und AI-Characters.\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"strong\", {\n    parentName: \"li\"\n  }, \"Bearbeiten.\"), \" Hintergrund entfernen, Neubeleuchtung und Blickwinkel, Haut-Retusche, virtuelle Anprobe, Flat Lays und Produktanzeigen.\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"strong\", {\n    parentName: \"li\"\n  }, \"Templates und Techniken.\"), \" Den kuratierten Katalog durchsuchen und ein Template auf deine eigenen Referenzbilder anwenden.\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"strong\", {\n    parentName: \"li\"\n  }, \"Bibliothek.\"), \" Deine Designs, Assets, Ordner und Galerien auflisten und abrufen oder ein neues Asset direkt aus dem Chat hochladen.\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"strong\", {\n    parentName: \"li\"\n  }, \"Marke.\"), \" Dein Markenprofil und deine Marken-Assets lesen und aktualisieren.\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"strong\", {\n    parentName: \"li\"\n  }, \"Workflows.\"), \" Pipelines aus dem Canvas auflisten, erstellen und ausf\\xFChren.\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"strong\", {\n    parentName: \"li\"\n  }, \"Konto.\"), \" Plan, Credit-Guthaben, Limits und Teams pr\\xFCfen.\")), mdx(\"p\", null, \"Lesende und schreibende Tools sind gekennzeichnet, damit dein Assistent wei\\xDF, welche Aktionen dein Konto ver\\xE4ndern. Die meisten Clients fragen beim ersten Mal nach einer Best\\xE4tigung, bevor sie ein schreibendes Tool ausf\\xFChren.\"), mdx(\"h3\", null, \"Probier das aus\"), mdx(\"ul\", null, mdx(\"li\", {\n    parentName: \"ul\"\n  }, \"\\\"Generiere ein Produktfoto einer mattschwarzen Trinkflasche auf einer Betonoberfl\\xE4che.\\\"\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, \"\\\"Welche Templates gibt es f\\xFCr Fashion Flat Lays?\\\"\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, \"\\\"Wie viele Credits habe ich diesen Monat noch?\\\"\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, \"\\\"Entferne den Hintergrund vom letzten Bild, das du erstellt hast.\\\"\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, \"\\\"Liste meine Designs aus dieser Woche auf.\\\"\")), mdx(\"h2\", null, \"Pl\\xE4ne und Credits\"), mdx(\"p\", null, \"Generierungen verbrauchen Credits aus demselben monatlichen Pool wie die App. Es gibt kein separates MCP-Kontingent und keine Zusatzkosten f\\xFCr die Nutzung von MCP. Der Free-Plan enth\\xE4lt 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\\xE4hrend die lesenden Tools weiter funktionieren.\"), mdx(\"p\", null, \"Die Kosten pro Bild h\\xE4ngen vom Modell ab:\"), mdx(\"table\", null, mdx(\"thead\", {\n    parentName: \"table\"\n  }, mdx(\"tr\", {\n    parentName: \"thead\"\n  }, mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Modell\"), mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Credits pro Bild\"))), mdx(\"tbody\", {\n    parentName: \"table\"\n  }, mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Seedream 5\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"4\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"FLUX Pro 1.1\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"5\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Nano Banana 2\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"7\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"FLUX 2 Flex\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"7\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Nano Banana Pro\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"14\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"GPT Image 2\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"22\")))), mdx(\"p\", null, \"Weitere Aktionen:\"), mdx(\"table\", null, mdx(\"thead\", {\n    parentName: \"table\"\n  }, mdx(\"tr\", {\n    parentName: \"thead\"\n  }, mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Aktion\"), mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Credits\"))), mdx(\"tbody\", {\n    parentName: \"table\"\n  }, mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Eine Technik auf ein Bild anwenden\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Die Kosten pro Bild des gew\\xE4hlten Modells (14 beim Standardmodell)\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Hintergrund entfernen\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"3\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Cinema Studio\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"2 pro Bild\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"AI Character (9 Posen)\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"25\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Video\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Modellrate pro Sekunde, mal Dauer\")))), mdx(\"p\", null, \"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 \", mdx(\"a\", {\n    parentName: \"p\",\n    \"href\": \"/docs/de-de/knowledge-base/plans-credits-and-limits\"\n  }, \"Pl\\xE4ne, Credits und Limits\"), \".\"), mdx(\"h2\", null, \"Wie lange das dauert\"), mdx(\"p\", null, \"Manche Tools werden noch im Gespr\\xE4ch fertig, andere laufen im Hintergrund:\"), mdx(\"ul\", null, mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"strong\", {\n    parentName: \"li\"\n  }, \"Bilder werden im Chat fertig.\"), \" Eine Generierung dauert rund 30 Sekunden, und der Assistent liefert das Bild, sobald es fertig ist.\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"strong\", {\n    parentName: \"li\"\n  }, \"Videos und AI-Characters laufen im Hintergrund.\"), \" Du bekommst sofort eine Task-Referenz, und der Assistent pr\\xFCft den Status, bis alles bereit ist. Du kannst weiterarbeiten oder sp\\xE4ter zur\\xFCckkommen und fragen, ob es fertig ist.\")), mdx(\"p\", null, \"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.\"), mdx(\"h2\", null, \"Limits\"), mdx(\"p\", null, \"Anfragen sind pro Konto rate-limitiert. Normale Nutzung im Gespr\\xE4ch bleibt deutlich innerhalb der Limits. Wenn ein Assistent in einer Schleife l\\xE4uft oder viele Anfragen auf einmal sendet, wird er kurz gedrosselt und sollte es erneut versuchen.\"), mdx(\"h2\", null, \"Fehlerbehebung\"), mdx(\"p\", null, mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"Der Assistent findet den Server nicht.\"), \" Pr\\xFCfe, ob die URL auf \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"/api\"), \" endet. \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"https://mcp.designerbox.ai/mcp\"), \" ist nicht g\\xFCltig und liefert Not Found.\"), mdx(\"p\", null, mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"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.\"), mdx(\"p\", null, mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"Eine Generierung bricht ab und erw\\xE4hnt 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\\xFCfe dein Guthaben in der App oder frag den Assistenten nach deinem Plan.\"), mdx(\"p\", null, mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"Der Assistent w\\xE4hlt das falsche Tool.\"), \" Beschreibe das Ergebnis genauer. \\\"Wende das Linen-Flat-Lay-Template auf dieses Foto an\\\" funktioniert besser als \\\"mach das sch\\xF6ner\\\".\"), mdx(\"h2\", null, \"Verwandt\"), mdx(\"ul\", null, mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"a\", {\n    parentName: \"li\",\n    \"href\": \"/docs/de-de/integrations/api\"\n  }, \"API\"), \" - die REST-API, f\\xFCr Code statt Konversation.\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"a\", {\n    parentName: \"li\",\n    \"href\": \"/docs/de-de/knowledge-base/plans-credits-and-limits\"\n  }, \"Pl\\xE4ne, Credits und Limits\"), \" - wie Generierungen Credits verbrauchen.\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"a\", {\n    parentName: \"li\",\n    \"href\": \"/docs/de-de/features/workflows-and-canvas\"\n  }, \"Workflows und Canvas\"), \" - die Pipelines, die MCP ausf\\xFChren kann.\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"a\", {\n    parentName: \"li\",\n    \"href\": \"/docs/de-de/features/techniques-and-templates\"\n  }, \"Techniken und Templates\"), \" - der Katalog, den dein Assistent anwenden kann.\")));\n}\n;\nMDXContent.isMDXComponent = true;","rawBody":"---\ntitle: \"MCP\"\nmetaTitle: \"DesignerBox MCP | AI-Assistenten verbinden\"\nmetaDescription: \"Verbinde DesignerBox mit Claude, Cursor, ChatGPT und jedem MCP-Client. Generiere Bilder und Videos, verwalte Assets und starte Workflows im Chat.\"\norder: 3\n---\n\n# MCP\n\nDer 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.\n\nMCP (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.\n\n![Die DesignerBox-App, deren Generierungs- und Asset-Funktionen auch über MCP verfügbar sind](../images/docs/home.jpg)\n\n## Server-URL\n\nVerbinde deinen Client mit:\n\n```\nhttps://mcp.designerbox.ai/api\n```\n\nDer Pfad lautet `/api`, nicht `/mcp`. Der Server spricht JSON-RPC 2.0 über streamable HTTP.\n\n## Assistenten verbinden\n\nDie 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.\n\n### Claude (Web, Desktop und Cowork)\n\n1. Öffne die Einstellungen und dann Connectors.\n2. Wähle die Option, einen Custom Connector hinzuzufügen.\n3. Füge `https://mcp.designerbox.ai/api` ein.\n4. Schließe die DesignerBox-Anmeldung ab, wenn sich dein Browser öffnet.\n5. Starte einen Chat und frage nach etwas, zum Beispiel \"liste meine DesignerBox-Designs auf\".\n\nDer 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.\n\n### Cursor und andere MCP-Clients\n\nJeder 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.\n\n## Authentifizierung\n\nDesignerBox 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.\n\nDer Server unterstützt dynamische Client-Registrierung, sodass sich saubere Clients allein anhand der URL selbst konfigurieren. Tokens werden mit diesen Scopes ausgestellt:\n\n- `openid` - identifiziert dein Konto.\n- `mcp:read` - deine Designs, Assets, Templates und deinen Plan lesen.\n- `mcp:write` - Medien generieren und deine Daten ändern.\n- `offline_access` - die Sitzung erneuern, damit du dich nicht jeden Tag anmelden musst.\n\nDeine 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.\n\nUm 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.\n\n## Was dein Assistent tun kann\n\nDer 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.\n\nDie wichtigsten Bereiche:\n\n- **Generieren.** Bilder, Videos, Cinema-Studio-Aufnahmen und AI-Characters.\n- **Bearbeiten.** Hintergrund entfernen, Neubeleuchtung und Blickwinkel, Haut-Retusche, virtuelle Anprobe, Flat Lays und Produktanzeigen.\n- **Templates und Techniken.** Den kuratierten Katalog durchsuchen und ein Template auf deine eigenen Referenzbilder anwenden.\n- **Bibliothek.** Deine Designs, Assets, Ordner und Galerien auflisten und abrufen oder ein neues Asset direkt aus dem Chat hochladen.\n- **Marke.** Dein Markenprofil und deine Marken-Assets lesen und aktualisieren.\n- **Workflows.** Pipelines aus dem Canvas auflisten, erstellen und ausführen.\n- **Konto.** Plan, Credit-Guthaben, Limits und Teams prüfen.\n\nLesende 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.\n\n### Probier das aus\n\n- \"Generiere ein Produktfoto einer mattschwarzen Trinkflasche auf einer Betonoberfläche.\"\n- \"Welche Templates gibt es für Fashion Flat Lays?\"\n- \"Wie viele Credits habe ich diesen Monat noch?\"\n- \"Entferne den Hintergrund vom letzten Bild, das du erstellt hast.\"\n- \"Liste meine Designs aus dieser Woche auf.\"\n\n## Pläne und Credits\n\nGenerierungen 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.\n\nDie Kosten pro Bild hängen vom Modell ab:\n\n| Modell | Credits pro Bild |\n|--------|------------------|\n| Seedream 5 | 4 |\n| FLUX Pro 1.1 | 5 |\n| Nano Banana 2 | 7 |\n| FLUX 2 Flex | 7 |\n| Nano Banana Pro | 14 |\n| GPT Image 2 | 22 |\n\nWeitere Aktionen:\n\n| Aktion | Credits |\n|--------|---------|\n| Eine Technik auf ein Bild anwenden | Die Kosten pro Bild des gewählten Modells (14 beim Standardmodell) |\n| Hintergrund entfernen | 3 |\n| Cinema Studio | 2 pro Bild |\n| AI Character (9 Posen) | 25 |\n| Video | Modellrate pro Sekunde, mal Dauer |\n\nBitte 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](/de-de/knowledge-base/plans-credits-and-limits).\n\n## Wie lange das dauert\n\nManche Tools werden noch im Gespräch fertig, andere laufen im Hintergrund:\n\n- **Bilder werden im Chat fertig.** Eine Generierung dauert rund 30 Sekunden, und der Assistent liefert das Bild, sobald es fertig ist.\n- **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.\n\nAlles, was du generierst, wird in deiner DesignerBox-Bibliothek gespeichert und ist damit in der App, egal ob der Chat noch offen ist oder nicht.\n\n## Limits\n\nAnfragen 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.\n\n## Fehlerbehebung\n\n**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.\n\n**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.\n\n**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.\n\n**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\".\n\n## Verwandt\n\n- [API](/de-de/integrations/api) - die REST-API, für Code statt Konversation.\n- [Pläne, Credits und Limits](/de-de/knowledge-base/plans-credits-and-limits) - wie Generierungen Credits verbrauchen.\n- [Workflows und Canvas](/de-de/features/workflows-and-canvas) - die Pipelines, die MCP ausführen kann.\n- [Techniken und Templates](/de-de/features/techniques-and-templates) - der Katalog, den dein Assistent anwenden kann.\n","tableOfContents":{"items":[{"url":"#mcp","title":"MCP","items":[{"url":"#server-url","title":"Server-URL"},{"url":"#assistenten-verbinden","title":"Assistenten verbinden","items":[{"url":"#claude-web-desktop-und-cowork","title":"Claude (Web, Desktop und Cowork)"},{"url":"#cursor-und-andere-mcp-clients","title":"Cursor und andere MCP-Clients"}]},{"url":"#authentifizierung","title":"Authentifizierung"},{"url":"#was-dein-assistent-tun-kann","title":"Was dein Assistent tun kann","items":[{"url":"#probier-das-aus","title":"Probier das aus"}]},{"url":"#pläne-und-credits","title":"Pläne und Credits"},{"url":"#wie-lange-das-dauert","title":"Wie lange das dauert"},{"url":"#limits","title":"Limits"},{"url":"#fehlerbehebung","title":"Fehlerbehebung"},{"url":"#verwandt","title":"Verwandt"}]}]},"parent":{"__typename":"File","relativePath":"de-de/integrations/mcp.md"},"frontmatter":{"metaTitle":"DesignerBox MCP | AI-Assistenten verbinden","metaDescription":"Verbinde DesignerBox mit Claude, Cursor, ChatGPT und jedem MCP-Client. Generiere Bilder und Videos, verwalte Assets und starte Workflows im Chat.","order":3}},"allMdx":{"edges":[{"node":{"fields":{"slug":"/de-de/integrations","title":"Integrationen"}}},{"node":{"fields":{"slug":"/de-de/features","title":"Features"}}},{"node":{"fields":{"slug":"/de-de/pricing-faqs","title":"Preis-FAQs"}}},{"node":{"fields":{"slug":"/de-de/guides","title":"Anleitungen"}}},{"node":{"fields":{"slug":"/de-de/knowledge-base","title":"Knowledge Base"}}},{"node":{"fields":{"slug":"/de-de","title":"DesignerBox Dokumentation"}}},{"node":{"fields":{"slug":"/de-de/features/cinema-studio","title":"Cinema Studio"}}},{"node":{"fields":{"slug":"/de-de/features/avatars-and-models","title":"AI Character"}}},{"node":{"fields":{"slug":"/de-de/features/community","title":"Community"}}},{"node":{"fields":{"slug":"/de-de/features/gallery","title":"Gallery"}}},{"node":{"fields":{"slug":"/de-de/features/photo-packs","title":"Photo Packs"}}},{"node":{"fields":{"slug":"/de-de/features/relighting-and-angles","title":"Relighting und Winkel"}}},{"node":{"fields":{"slug":"/de-de/features/brand-profile","title":"Markenprofil und Bibliothek"}}},{"node":{"fields":{"slug":"/de-de/features/skills","title":"Skills"}}},{"node":{"fields":{"slug":"/de-de/features/image-generation","title":"AI Image"}}},{"node":{"fields":{"slug":"/de-de/features/stock-and-audio","title":"Stock Library und Audio"}}},{"node":{"fields":{"slug":"/de-de/features/upscaling","title":"Upscaling"}}},{"node":{"fields":{"slug":"/de-de/features/techniques-and-templates","title":"Techniken und Templates"}}},{"node":{"fields":{"slug":"/de-de/features/video-studio","title":"Video Studio"}}},{"node":{"fields":{"slug":"/de-de/features/apps","title":"Apps"}}},{"node":{"fields":{"slug":"/de-de/features/video","title":"AI Video"}}},{"node":{"fields":{"slug":"/de-de/features/ai-assistant","title":"DesignerBox AI"}}},{"node":{"fields":{"slug":"/de-de/features/workflows-and-canvas","title":"Workflows und Canvas"}}},{"node":{"fields":{"slug":"/de-de/features/virtual-try-on","title":"Virtual Try-On"}}},{"node":{"fields":{"slug":"/de-de/guides/creating-videos","title":"Videos erstellen"}}},{"node":{"fields":{"slug":"/de-de/guides/teams-and-brand-profiles","title":"Teams und Markenprofile"}}},{"node":{"fields":{"slug":"/de-de/guides/create-your-first-image","title":"Dein erstes Bild erstellen"}}},{"node":{"fields":{"slug":"/de-de/guides/building-workflows-on-the-canvas","title":"Workflows auf dem Canvas bauen"}}},{"node":{"fields":{"slug":"/de-de/guides/using-techniques-and-templates","title":"Techniken und Templates verwenden"}}},{"node":{"fields":{"slug":"/de-de/integrations/api","title":"API"}}},{"node":{"fields":{"slug":"/de-de/integrations/chrome-extension","title":"Chrome Extension"}}},{"node":{"fields":{"slug":"/de-de/knowledge-base/plans-credits-and-limits","title":"Pläne, Credits und Limits"}}},{"node":{"fields":{"slug":"/de-de/integrations/white-label","title":"White-Label"}}},{"node":{"fields":{"slug":"/de-de/knowledge-base/referrals","title":"Empfehlungen und Gratis-Credits"}}},{"node":{"fields":{"slug":"/de-de/knowledge-base/understanding-declined-card-payments","title":"Abgelehnte Kartenzahlungen verstehen"}}},{"node":{"fields":{"slug":"/de-de/knowledge-base/how-to-update-card-details","title":"Kartendaten aktualisieren"}}},{"node":{"fields":{"slug":"/de-de/integrations/mcp","title":"MCP"}}},{"node":{"fields":{"slug":"/de-de/features/workflows-and-canvas/node-types","title":"Node-Typen"}}},{"node":{"fields":{"slug":"/de-de/features/image-generation/editing-modes","title":"Bearbeitungsmodi"}}}]}},"pageContext":{"id":"18ff8986-fadb-5846-8279-b8dea9d1d6d5","locale":"de-DE"}},"staticQueryHashes":["361965504","361965504","417421954","417421954","445494767","445494767"]}