claude.design-mcp
claude.design-mcp
Ein MCP, das die echte Claude Design-Web-App von deinem Editor/Agenten aus steuert – einmal anmelden, dann erstellen, iterieren und abrufen von Designs, die claude.ai/design auf deinem eigenen Konto generiert (keine lokale Nachahmung).
So funktioniert es
Es steuert dein eigenes eingeloggtes Chrome (ein dediziertes Profil) über CDP mit
playwright-coreund spricht mit der echtenclaude.ai/design-„Omelette“-API als du, über deine Browser-Sitzung.Die Generierung wird so ausgelöst, wie es die Website tut – dein Prompt wird in den Design-Composer getippt und abgeschickt; das Tool wartet dann, bis der Turn abgeschlossen ist (das
ReleaseTurn-Netzwerksignal + Dateibaum-Stabilität) und meldet die Dateien, die Claude Design geschrieben hat. Dateien werden auf Wunsch lokal abgerufen.Projektmetadaten, Dateien, Löschungen und direkte Dateibearbeitungen verwenden die dokumentierten JSON-RPCs (
CreateProject/ListFiles/GetFile/EditFile/DeleteProject), die in der Seite ausgeführt werden, sodass sie deine Sitzung + Cloudflare-Freigabe teilen.Kein
claude -p-Nachahmer. Jedes Design wird von claude.ai/design selbst erzeugt.
Related MCP server: Browser Agent MCP
Offizielles Design-MCP und Protokoll-Urteil (2026-08-12)
Dieses Projekt ist ein unabhängiges CDP-Browser-Automatisierungs-MCP. Es ruft nicht den offiziellen
api.anthropic.com/v1/design/mcp-Endpunkt auf. Wie in So funktioniert es beschrieben, verwendet es
playwright-core und CDP, um eine echte Chrome-Sitzung zu steuern, die bereits in der tatsächlichen
claude.ai/design-Web-App angemeldet ist.
Die Create prompt for Claude Code-Exportnachricht der claude.ai/design-Oberfläche übergibt eine Projekt-URL
in der Form https://claude.ai/design/p/<projectId>. Für diesen Server besteht der passende Ablauf darin,
<projectId> aus dieser URL zu extrahieren und design_pull aufzurufen. Das offizielle Design-MCP ist nicht
erforderlich, um die generierten Dateien zu empfangen.
Die MCP-Protokollrevision, die um den 2026-07-28 diskutiert wurde, einschließlich der zustandslosen Wire-Protokoll-
Änderung, die von einigen MCP-Ökosystemen übernommen wurde, hat keine praktische Auswirkung auf die aktuelle OpenCode-
stdio-Client-Integration oder den Tool-Vertrag. Dieser Server antwortet auf die Initialisierung mit dem festen
protocolVersion: "2024-11-05"-Handshake.
Überprüfe dieses Urteil erneut, wenn eine dieser Bedingungen eintritt:
Der OpenCode-MCP-Client stellt die Unterstützung für die ältere Handshake-Version ein, die dieser Server zurückgibt.
Das Projekt beschließt, seinen CDP-Browser-Automatisierungsansatz durch den offiziellen
api.anthropic.com/v1/design/mcp-Endpunkt zu ersetzen.claude.ai ändert sein Authentifizierungs- oder Sitzungsmodell auf eine Weise, die den CDP-gesteuerten Login-Ablauf beeinflusst.
Tools
Tool | Funktion |
| Einmalig: Chrome öffnen, um sich bei claude.ai/design anzumelden (Sitzung bleibt erhalten) |
| Deine claude.ai/design-Projekte auflisten |
| Ein Projekt erstellen und ein Design aus einem Prompt generieren – |
| Mehrere Designvarianten eines Prompts parallel generieren – |
| Einen Folge-Prompt senden, um ein Design zu ändern – |
| Die Dateien eines Projekts lokal herunterladen – |
| Das eigenständige HTML eines Projekts als ganzseitiges PNG zur Überprüfung rendern – |
| Eine Datei aus einem Projekt lesen – |
| Den Chat-/Turn-Zustand eines Projekts melden – |
| Eine asynchrone Generierung abfragen und wiederherstellen – |
| Eine direkte Dateibearbeitung anwenden – |
| Ein Projekt löschen – |
| Einen materialisierten Design-System-Paketordner als Design-System zu claude.ai hochladen, indem Claude Code |
| Die Design-Systeme auf deinem Konto auflisten (Name + ID), über alle Seiten der Projektliste hinweg |
Jedes Tool akzeptiert außerdem ein optionales caller-Objekt – { directory, sessionID, agent, project? } – das
der MCP-Client injizieren kann, um anzugeben, wer aufruft. Es ist nie ein Generierungsargument: Der Dispatcher entfernt
es, bevor der Handler läuft, und zeichnet es nur in der Aufrufhistorie auf.
Aufrufhistorie
Jeder tools/call-Dispatch hängt genau eine JSON-Zeile an
~/.local/share/opencode-dashboard/claude-design-history/events.ndjsonl an (Verzeichnis 0700, Datei 0600;
überschreibe den Ordner mit CLAUDE_DESIGN_HISTORY_DIR), sodass eine Prompt-Historie über MCP-Neustarts hinweg erhalten bleibt.
Eine Zeile trägt v, eventId, seq, ts, tool, durationMs, ok, error, projectId, projects,
projectName, prompt (wörtlich, nie abgeschnitten), model, designSystem, withoutDesignSystem,
withoutDesignSystemReason, wait, attemptId, caller, pullKind, revision und eine Whitelist-result-Zusammenfassung (nur Zählungen und IDs – niemals Datei-
inhalte, Base64 oder Umgebungsvariablen). Die Aufzeichnung ist Best-Effort-Beobachtbarkeit: Ein fehlgeschlagenes Schreiben warnt nur
auf stderr und macht aus einem funktionierenden Tool-Aufruf nie einen Fehler. Der CLI-Pfad wird nicht aufgezeichnet.
Revisions-Snapshots
Ein erfolgreicher einfacher design_pull (pullKind: "default" – kein dir, kein zip) erstellt außerdem einen Snapshot
des abgerufenen Manifests in <CLAUDE_DESIGN_DIR>/.revisions/<projectId>/<revisionId>/, außerhalb des abgerufenen Baums, sodass
die Bearbeitungshistorie eines Designs später diffbar ist. revisionId ist <YYYYMMDDTHHmmssSSS>-<uuid8> in UTC, sodass die
Namensreihenfolge der Zeitreihenfolge entspricht. Jeder Ordner enthält eine .meta.json mit der SHA-256-Liste pro Datei, einem Gesamt-hash
und incomplete: true, wenn der Abruf partielle Dateifehler meldete. Der Snapshot wird in
.staging-<revisionId>/ bereitgestellt und atomar umbenannt, sodass Listener nur abgeschlossene Revisionen sehen (überspringe jeden Namen, der
mit . beginnt). Ein Abruf, dessen Inhalts-Hash und Vollständigkeit beide mit der vorherigen Revision übereinstimmen, wird übersprungen
und meldet revision: null, was „unverändert – die vorherige Revision ist weiterhin aktuell“ bedeutet. Snapshot-
Fehler sind auf dieselbe Weise nicht fatal: revision: null plus eine stderr-Warnung, Tool-Ergebnis unverändert.
Einrichtung
npm install # installs playwright-core (NO browser download — uses your Chrome)
node src/server.mjs login # opens Chrome once; log into claude.ai (session is then reused, invisibly)Als lokales MCP registrieren (opencode-Beispiel):
{ "mcp": { "claude-design": { "type": "local", "command": ["node", "/abs/path/claude.design-mcp/src/server.mjs"], "enabled": true } } }CLI
node src/server.mjs login
node src/server.mjs list
node src/server.mjs list-systems
node src/server.mjs create "simple pricing card" pricing --design-system "Frontend Design System"
node src/server.mjs create "minimal landing page for a coffee shop" coffee --model opus --without-design-system
node src/server.mjs iterate <projectId> "add a dark mode toggle to the header" --model sonnet
node src/server.mjs check <projectId>
node src/server.mjs pull <projectId|name>
node src/server.mjs preview <projectId|name> [outDir] [width]
node src/server.mjs delete <projectId>
node src/server.mjs sync <packageDir> [--timeout-ms 900000]Nach dem einmaligen login laufen list/create/iterate/pull ohne sichtbares Fenster
(Off-Screen-Chrome) und verwenden die gespeicherte Sitzung erneut.
Generierungsoptionen
design_create,design_iterateunddesign_variantsakzeptieren ein optionalesmodel. Verwende eine Familie (opus,sonnet,haikuoderfable), um die neueste Version dieser Familie aus dem Live-Menü von claude.ai/design auszuwählen. Pinne eine Version mit Formen wieopus-4.8,opus-5,opus 5.0,claude-opus-4-8oderanthropic/claude-opus-5. Neue Familienversionen werden automatisch verfügbar, sobald sie im Site-Menü erscheinen. Wenn eine angeforderte Version nicht verfügbar ist, listet der Fehler die Live-Menüoptionen auf. Für CLIcreateunditerateübergib denselben Wert an--model.design_create,design_iterateunddesign_variantsakzeptieren eindesignSystem(CLI--design-system), den Namen eines der Konten-Designsysteme, die vondesign_system_listgemeldet werden. Der Abgleich erfolgt ohne Beachtung der Groß-/Kleinschreibung, ein eindeutiger Teilname funktioniert, und ein unbekannter Name erzeugt einen Fehler mit der Liste, die der Composer anbietet. Das gewählte System ersetzt die Organisationsstandard-Einstellung, anstatt sie zu ergänzen, und das Ergebnis gibt den aufgelösten Namen zurück. claude.ai bietet den Auswähler nur solange ein Projekt noch kein Design erzeugt hat, daher gehörtdesignSystemzudesign_create; beidesign_iteratefunktioniert es nur für ein solches Projekt und erzeugt andernfalls einen Fehler, anstatt die Anfrage stillschweigend zu ignorieren.design_variantsverankert jede Variante im selben System.Grounding ist bei
design_createunddesign_variantsverpflichtend. Jeder Aufruf muss genau eines von einem nicht-leerendesignSystemoderwithoutDesignSystem: true(der boolesche Werttrue, nicht"true"oder1) enthalten – niemals beides, niemals keines. Ein Verstoß wird mit einer festen Meldung abgelehnt, dielist_claude_synced_systems/design_system_listals Weg zur Ermittlung der verfügbaren Namen nennt, und die Ablehnung erfolgt bevor eine Browsersitzung, eine Operationsseite oder ein Projekt existiert, sodass ein abgelehnter Aufruf das Konto unangetastet lässt. Beidesign_variantsläuft die Prüfung oberhalb des Fan-outs, sodass ein abgelehnter Aufruf null Projekte erstellt, anstatt pro Variante Fehler zurückzugeben. Ein Opt-out kann einen FreitextwithoutDesignSystemReasonenthalten, der nur zusammen mitwithoutDesignSystem: truegültig ist; beide werden im Ergebnis zurückgegeben und im Aufrufverlauf protokolliert. Das CLI-Äquivalent istcreate --without-design-system;iteratelehnt dieses Flag als unbekannt ab.design_iterateist bewusst nicht abgesichert: Ein Projekt, das bereits ein Design enthält, bietet den Auswähler nicht mehr an, daher gibt es dort nichts auszuwählen.design_variantserzwingtfresh: truefür jedes Projekt, das es erstellt. Jede Variante wird<base>-v<N>genannt, und ohnefreshwürde ein erneuter Lauf das gleichnamige Projekt aus einem früheren Fan-out wiederverwenden – ein Projekt, das bereits ein Design enthält, an dem das Designsystem nicht mehr angehängt werden kann.design_createunddesign_iterateakzeptierenwait(Standardtrue). Setzewait: false, um nach einem verifiziertenChat-POST und der begrenzten Frageformular-Überwachung mit{ submitted: true, pending: true }zurückzukehren; das CLI-Äquivalent ist--no-wait. Ein Klick oder Tastendruck, der keineChat-Anfrage erzeugt, schlägt fehl, anstatt einen Erfolg zu melden.design_createmit einem explizitennameist Finde-oder-Erstelle: Ein vorhandenes Projekt mit diesem exakten Namen wird wiederverwendet (bei Kollisionen gewinnt das neueste) und das Ergebnis trägtreused: true, sodass wiederholte Aufrufe ein Projekt iterieren, anstatt Duplikate anzuhäufen. Übergibfresh: true, um ein neues Projekt zu erzwingen. Ohnename(aus der Eingabeaufforderung abgeleiteter Name) erstellt jeder Aufruf wie zuvor ein neues Projekt.Frage eingereichte Arbeit mit
design_check({ projectId })ab, odernode src/server.mjs check <projectId>. Seinstatusistgenerating,awaiting_input,done,no_output,interrupted,stalledoderresume_exhausted. Jede Prüfung verwendet die gehaltene Besitzerseite erneut, solange ein Zug aktiv ist (ohne sie neu zu laden), beantwortet ein Frageformular, wenn möglich, und klickt automatisch dieResume-Schaltfläche des Unterbrechungsbanners.interruptedbedeutet, dass das Banner vorhanden war, aber nicht fortgesetzt werden konnte;stalledbedeutet, dass der Dateibaum stabil war, ohne generierte Dateien, und die letzte Nachricht immer noch die Eingabeaufforderung des Benutzers war.resume_exhaustedist endgültig nach drei aufeinanderfolgenden Resume-Versuchen und enthältresumeAttempts,maxResumeAttemptsundproblem: "resume_attempts_exhausted"._ds/**-Designsystem-Material wird nicht als generierte Ausgabe gezählt.
Asynchroner Workflow
# 1. Submit without waiting
node src/server.mjs create "카드 UI" my-card --no-wait --model opus
# → { projectId: "...", submitted: true, pending: true }
# 2. Continue with other work...
# 3. Poll for completion (every 2-5 minutes is recommended)
node src/server.mjs check <projectId>
# → { status: "done", files: [...] }
# 4. Pull and preview the finished design
node src/server.mjs pull <projectId>
node src/server.mjs preview <projectId>Anforderungen
Node.js 22+ (verwendet eingebautes
fetch/WebSocket;playwright-coreist die einzige npm-Abhängigkeit)Google Chrome (die Tools steuern ein dediziertes Chrome-Profil)
Ein claude.ai-Konto mit Design-Zugriff (du meldest dich einmalig über
design_loginan)
Env
CLAUDE_DESIGN_PROFILE– dediziertes Chrome-Profilverzeichnis (Standard~/.cache/claude-design-mcp/chrome-profile)CLAUDE_DESIGN_CHROME– Pfad zu Google Chrome (Standard: macOS Google Chrome)CLAUDE_DESIGN_CDP_PORT– Remote-Debugging-Port (Standard9377)CLAUDE_DESIGN_DIR– wohindesign_pull/design_previewschreiben, jeweils in einen eigenen<project>/-Ordner (Standard: der Arbeitsordner); ein explizitesdir-Argument wird unverändert verwendetCLAUDE_DESIGN_HISTORY_DIR– wohin dertools/call-Verlauf angehängt wird (Standard~/.local/share/opencode-dashboard/claude-design-history, Dateievents.ndjsonl)CLAUDE_DESIGN_HEADLESS– setze1, um headless Chrome anstelle von Off-Screen zu steuernCLAUDE_DESIGN_TURN_TIMEOUT_MS– harte Obergrenze pro Generierungszug (Standard: create ~360s, iterate ~240s)CLAUDE_DESIGN_QUIET_MS– wie lange das Zug-Netzwerk still bleiben muss, bevor eine Generierung als abgeschlossen beurteilt wird (Standard20000)CLAUDE_DESIGN_PAGE_LEASE_MS– unabhängige harte Obergrenze für eine asynchrone Besitzerseite, wenn ihr Abschlussmonitor hängt (Standard2700000, 45 Minuten)CLAUDE_DESIGN_CLAUDE_BIN– Claude-Code-Binärdatei, die vondesign_system_syncverwendet wird (Standardclaude)CLAUDE_DESIGN_SYNC_TIMEOUT_MS– harte Obergrenze für einen/design-sync-Lauf (Standard900000, 15 Minuten)
Designsystem-Synchronisierung
design_system_sync (CLI: sync <dir>) führt
claude -p "/design-sync <pre-approval>" --dangerously-skip-permissions --output-format stream-json --verbose
mit dem Paketordner als Arbeitsverzeichnis aus und meldet, was die Synchronisierung hochgeladen hat. Nach einer
erfolgreichen Nur-Tokens-Synchronisierung verwendet es die angemeldete Chrome/CDP-Sitzung, um den hochgeladenen
styles.css-Import-Shim durch das generierte Custom-Property-CSS aus ds-bundle/_ds_bundle.css zu ersetzen.
Der Ordner muss bereits ein Paket sein (
package.json+ ein CSS-Einstiegspunkt wiestyles.css, plustokens/*.json,guidelines/*.md,README.md). Komponenten sind optional – ein Nur-Tokens- Paket wird akzeptiert. Das Tool lehnt ab, bevor es startet, wennpackage.jsonfehlt.Der Exit-Status ist nicht das Erfolgssignal. Eine abgelehnte Synchronisierung beendet sich trotzdem mit
0undsubtype: "success", daher ist das Ergebnis nurok: true, wenn die Antwort einen echten Projektlink enthält; andernfalls erhältst du{ ok: false, error, raw }mit der vollständigen Ausgabe zur Diagnose.Ein erster Lauf erstellt das Projekt und schreibt
.design-sync/config.json, das spätere Läufe pinnt auf dasselbe Projekt (ein unveränderter erneuter Lauf ist dann ein No-op anstelle eines Duplikats). Wenn deine Pipeline den Ordner neu generiert, sichere.design-sync/, bevor du ihn ersetzt, und stelle ihn danach wieder her – dieses Tool schreibt niemals das Paket selbst.Die Eingabeaufforderung trägt eine Vorabgenehmigung (
SYNC_ARGSinsrc/sync.mjs), und sie ist bei einem ersten Lauf tragend./design-syncfragt nach zweiAskUserQuestion-Bestätigungen, wenn der Ordner keinen Pin hat – akzeptiere die Zeit/Kosten, bestätige dann den Namen des neuen Projekts vorcreate_project– undclaude -phat keinAskUserQuestion-Tool, daher würde der Zug mit der Frage enden und nichts hochladen (Exit0,subtype: "success", kein Projektlink). Die eigene Notluke des Skills („wenn ihre Anfrage die Zeit/Kosten bereits anerkannt hat … ohne erneutes Nachfragen fortfahren") ist das, was die Vorabgenehmigung aufruft, und sie nennt die Erstellung des frischen Projekts explizit. Ein gepinnter erneuter Sync trifft niemals auf eines der beiden Tore, weshalb dies nur bei einer Erst-Synchronisierung auftrat. Claude Code hängt den Text nach dem Slash-Befehl an den Skill-Body als umrahmten## Hint-Block an, daher muss er eine positionale Zeichenfolge ohne darin enthaltene dreifache Backticks bleiben.Eine erste Synchronisierung dauert ~10 Minuten; unveränderte erneute Läufe dauern ~2. Das CLI beendet sich bei einer fehlgeschlagenen Synchronisierung mit
1.Das Ergebnis fügt
flattened: true|falsehinzu. Ein Browser-/Schreibfehler nach der Synchronisierung wird alsflattenErrorgemeldet, während der abgeschlossene Uploadok: truebleibt.
design_system_list (CLI: list-systems) ist die Leseseite derselben Funktion. claude.ai hat keinen
separaten Designsystem-Endpunkt – Designsysteme werden vom gewöhnlichen Projektlisten-RPC zurückgegeben,
das mit PROJECT_TYPE_DESIGN_SYSTEM gekennzeichnet ist und 20 auf einmal seitenweise liefert, daher folgt das Tool jeder Seite und
gibt [{ name, id, publishedAt?, viewedAt? }] zurück (publishedAt erscheint nur, sobald ein System
veröffentlicht wurde). Verwende es, um zu bestätigen, was design_system_sync tatsächlich auf dem Konto gelandet ist.
scripts/probe-design-systems.mjs erfasst diese Live-Form erneut, falls sich die API ändert.
Wann ist eine Generierung „fertig"?
claude.ai/design steuert die Generierung als Züge: Deine Eingabeaufforderung streamt über einen Chat-RPC,
der durch RenewTurn-Keepalives (~alle 10s) am Leben gehalten und durch ein ReleaseTurn beendet wird. design_create /
design_iterate kehren zurück, sobald die Dateien sich beruhigt haben UND das Zug-Netzwerk still geworden ist für
CLAUDE_DESIGN_QUIET_MS – deutlich länger als das Keepalive-Intervall, sodass eine Generierung niemals
mitten im Schreiben abgeschnitten wird (du erhältst immer ein vollständiges, kohärentes Design, kein halb gerendertes).
Wenn eine Generierung ihre harte Frist erreicht, bevor die Ruhe-/Stabilitätsprüfungen abgeschlossen sind, enthält das Ergebnis
timedOut: true. Normale Abschlüsse lassen das Feld vollständig weg; behandle sein Vorhandensein als Signal, dass die
zurückgegebenen Dateien die beste verfügbare Momentaufnahme zum Zeitpunkt des Timeouts sind, anstatt eines vollständig ruhigen Zugs.
Beachte, dass claude.ai oft einen automatischen Verfeinerungslauf ausführt, der ~30s nachdem das erste Design
sich beruhigt hat, beginnt, sodass sich das Design auf dem Server weiter verbessert, nachdem das Tool seine erste vollständige
Version zurückgegeben hat. Um die am stärksten verfeinerte Ausgabe zu erhalten, rufen design_pull / design_preview immer den neuesten Stand
ab, oder erhöhe CLAUDE_DESIGN_QUIET_MS (z. B. 60000), damit create auf spätere Verfeinerungsläufe
wartet (auf Kosten einer längeren Wartezeit).
Available Tools
10 toolsdesign_createC
Create a Claude Design project and submit the initial prompt through the composer.
Inputs: prompt (required), name.
design_deleteC
Delete one Claude Design project.
Inputs: projectId (required).
design_editC
Apply direct string edits to one Claude Design project file.
Inputs: path (required), edits (required), projectId (required).
design_getC
Read one file from a Claude Design project.
Inputs: path (required), projectId (required).
design_iterateC
Submit a follow-up prompt to an existing Claude Design project.
Inputs: prompt (required), projectId (required).
design_listA
List Claude Design projects from the logged-in web account.
Inputs: no named parameters.
design_loginA
Open Chrome for claude.ai/design login and report the active account.
Inputs: no named parameters.
design_previewC
Render a project's self-contained HTML to a full-page PNG screenshot for visual review.
Inputs: dir, name, path, width, +2 more.
design_pullC
Pull one Claude Design project by projectId or exact name into a local directory.
Inputs: dir, zip, name, projectId.
design_statusC
Summarize project data, chat count, and last message role.
Inputs: projectId (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 10 tools
Each tool has a unique action (create, delete, edit, get, iterate, list, login, preview, pull, status) targeting distinct operations on projects or files, with no overlap in purpose.
All tools follow a uniform 'design_<verb>' pattern, using snake_case throughout, making naming predictable and easy to understand.
10 tools is well-scoped for a design-related server, covering essential operations from login to CRUD to preview and status without being excessive or insufficient.
The tool set covers core workflows (login, list, create, read, update, delete, preview, pull), but lacks explicit support for file deletion or project metadata updates, which are minor gaps.
Maintenance
Related MCP Connectors
Compare Figma designs against live websites and get visual + content QA reports, from inside Claude.
Let your AI agent operate any website through a real, logged-in browser session.
Control a real browser from AI agents: navigate, click, type, screenshot, read the page.
Read, edit, publish, and preview your pepita websites from Claude.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables automation of browser tasks using Playwright by interacting via Claude Desktop for executing user-defined prompts and operations.1212MIT
- AlicenseAqualityBmaintenanceA Model Context Protocol (MCP) integration that provides Claude Desktop with autonomous browser automation capabilities. This agent enables Claude to interact with web content, manipulate DOM elements, execute JavaScript, and perform API requests.1343TypeScriptMozilla Public 2.0
- AlicenseNot gradedqualityBmaintenanceLets Claude Code drive your own Chrome browser with human-like clicks, drags, and typing. It uses your real sessions and logins, and pauses for your confirmation on anything irreversible.8MIT
- AlicenseAqualityCmaintenanceBridges Claude Code with Claude Design, enabling sending design instructions, reading replies, and pulling generated files into the codebase.2344MIT