claude.design-mcp
claude.design-mcp
エディタやエージェントから本物の Claude Design Web アプリを操作する MCP です。一度ログインすれば、claude.ai/design があなた自身のアカウント上で生成するデザインを作成・反復・取得できます(ローカルの模倣ではありません)。
仕組み
あなた自身のログイン済み Chrome(専用プロファイル)を CDP 経由で
playwright-coreを使って操作し、実際のclaude.ai/designの "Omelette" API とあなたとして、ブラウザセッションを通じて通信します。生成は Web サイトと同じ方法でトリガーされます。プロンプトがデザインコンポーザーに入力されて送信され、ツールはターンが終了するのを待って(
ReleaseTurnネットワークシグナル + ファイルツリーの安定性)、Claude Design が書き込んだファイルを報告します。ファイルは要求に応じてローカルに取得されます。プロジェクトのメタデータ、ファイル、削除、直接ファイル編集は、文書化された JSON RPC(
CreateProject/ListFiles/GetFile/EditFile/DeleteProject)を使用し、ページ内で実行されるため、セッションと Cloudflare のクリアランスを共有します。claude -pの模倣ではありません。 すべてのデザインは claude.ai/design 自体によって生成されます。
Related MCP server: Browser Agent MCP
公式 Design MCP とプロトコルに関する見解(2026-08-12)
このプロジェクトは独立した CDP ブラウザ自動化 MCP です。公式の api.anthropic.com/v1/design/mcp エンドポイントは呼び出しません。仕組み で説明したように、playwright-core と CDP を使用して、実際の claude.ai/design Web アプリにログイン済みの実際の Chrome セッションを操作します。
claude.ai/design UI の Create prompt for Claude Code エクスポートメッセージは、https://claude.ai/design/p/<projectId> 形式のプロジェクト URL を引き渡します。このサーバーでは、対応するフローはその URL から <projectId> を抽出して design_pull を呼び出すことです。生成されたファイルを受け取るために公式の Design MCP は必要ありません。
2026-07-28 頃に議論された MCP プロトコル改訂(一部の MCP エコシステムで採用されたステートレスなワイヤープロトコル変更を含む)は、現在の OpenCode stdio クライアント統合やツール契約には実質的な影響を与えません。このサーバーは、固定の protocolVersion: "2024-11-05" ハンドシェイクで初期化に応答します。
次のいずれかの条件が発生した場合は、この見解を再評価してください。
OpenCode MCP クライアントが、このサーバーが返す古いハンドシェイクバージョンのサポートを廃止した場合。
プロジェクトが CDP ブラウザ自動化アプローチを公式の
api.anthropic.com/v1/design/mcpエンドポイントに置き換えることを決定した場合。claude.ai が認証またはセッションモデルを変更し、CDP 駆動のログインフローに影響を与える場合。
ツール
ツール | 機能 |
| 一度だけ: claude.ai/design にログインするために Chrome を開く(セッションは永続化) |
| あなたの claude.ai/design プロジェクトを一覧表示 |
| プロジェクトを作成し、プロンプトからデザインを生成 — |
| 1 つのプロンプトの複数のデザインバリアントを並行して生成 — |
| デザインを変更するためのフォローアッププロンプトを送信 — |
| プロジェクトのファイルをローカルにダウンロード — |
| プロジェクトの自己完結型 HTML を全ページ PNG にレンダリングしてレビュー — |
| プロジェクトから 1 つのファイルを読み取る — |
| プロジェクトのチャット/ターン状態を報告 — |
| 非同期生成をポーリングして回復 — |
| 直接ファイル編集を適用 — |
| プロジェクトを削除 — |
| 具体化されたデザインシステムパッケージフォルダを デザインシステム として claude.ai にアップロード。Claude Code |
| アカウント上のデザインシステム(名前 + ID)を、プロジェクトリストのすべてのページにわたって一覧表示 |
すべてのツールは、オプションの caller オブジェクト — { directory, sessionID, agent, project? } — も受け入れます。これは MCP クライアントが誰が呼び出しているかを示すために注入する場合があります。これは生成引数ではありません。ディスパッチャはハンドラが実行される前にそれを取り除き、呼び出し履歴にのみ記録します。
呼び出し履歴
tools/call のディスパッチごとに、~/.local/share/opencode-dashboard/claude-design-history/events.ndjsonl(ディレクトリ 0700、ファイル 0600; フォルダは CLAUDE_DESIGN_HISTORY_DIR で上書き可能)に JSON 行が 1 行追加されるため、プロンプト履歴は MCP の再起動をまたいで保持されます。行には v、eventId、seq、ts、tool、durationMs、ok、error、projectId、projects、projectName、prompt(逐語的、決して切り詰められない)、model、designSystem、withoutDesignSystem、withoutDesignSystemReason、wait、attemptId、caller、pullKind、revision、およびホワイトリストに登録された result サマリー(カウントと ID のみ — 決してファイル内容、base64、環境値は含まれません)が含まれます。記録はベストエフォートの可観測性です。書き込みに失敗しても stderr に警告が出るだけで、正常なツール呼び出しがエラーになることはありません。CLI パスは記録されません。
リビジョンスナップショット
成功した通常の design_pull(pullKind: "default" — dir なし、zip なし)は、取得したマニフェストを取得ツリーの外の <CLAUDE_DESIGN_DIR>/.revisions/<projectId>/<revisionId>/ にスナップショットするため、デザインの編集履歴を後で差分比較できます。revisionId は UTC で <YYYYMMDDTHHmmssSSS>-<uuid8> なので、名前の順序は時間順です。各フォルダには、ファイルごとの SHA-256 リスト、合計 hash、およびプルが部分的なファイルエラーを報告した場合の incomplete: true を含む .meta.json が含まれます。スナップショットは .staging-<revisionId>/ にステージングされ、アトミックに名前が変更されるため、リスナーは完了したリビジョンだけを認識します(. で始まる名前はスキップ)。コンテンツハッシュと完全性の両方が前のリビジョンと一致するプルはスキップされ、revision: null を報告します。これは「変更なし — 前のリビジョンがまだ最新です」を意味します。スナップショットの失敗も同様に致命的ではありません。revision: null と stderr 警告が発生し、ツールの結果は変更されません。
セットアップ
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)ローカル MCP として登録(opencode の例):
{ "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]一度限りの login の後、list/create/iterate/pull は表示ウィンドウなし(オフスクリーン Chrome)で実行され、永続化されたセッションを再利用します。
生成オプション
design_create、design_iterate、design_variantsはオプションのmodelを受け付けます。 ファミリー名(opus、sonnet、haiku、fable)を使うと、claude.ai/design のライブメニューからそのファミリーの最新バージョンが選択されます。opus-4.8、opus-5、opus 5.0、claude-opus-4-8、anthropic/claude-opus-5のような形式でバージョンを固定できます。新しいファミリーバージョンは、サイトメニューに表示されると自動的に利用可能になります。要求したバージョンが利用できない場合、エラーにはライブメニューの選択肢が一覧表示されます。CLI のcreateとiterateでは、同じ値を--modelに渡します。design_create、design_iterate、design_variantsはdesignSystem(CLI では--design-system)を受け付けます。これはdesign_system_listが報告するアカウントのデザインシステムのいずれかの名前です。大文字小文字を区別せずに照合され、曖昧でない部分名でも機能し、不明な名前の場合はコンポーザーが提供するリストとともにエラーになります。選択したシステムは組織のデフォルトに追加されるのではなく置き換えられ、結果には解決された名前がエコーされます。claude.ai はプロジェクトがまだデザインを生成していない間だけピッカーを提供するため、designSystemはdesign_createに指定するのが正しく、design_iterateではそのようなプロジェクトに対してのみ機能し、それ以外の場合は黙って無視するのではなくエラーになります。design_variantsはすべてのバリアントを同じシステムに基づかせます。design_createとdesign_variantsではグラウンディングが必須です。 各呼び出しは、空でないdesignSystemまたはwithoutDesignSystem: true(ブール値のtrueであり、"true"や1ではない)のうち、正確に1つだけを保持しなければなりません。両方指定も、どちらも指定しないのも禁止です。違反は、利用可能な名前を調べる方法としてlist_claude_synced_systems/design_system_listを挙げる1つの固定メッセージで拒否され、その拒否はブラウザセッション、操作ページ、プロジェクトが存在する前に発生するため、拒否された呼び出しはアカウントに影響を与えません。design_variantsではチェックがファンアウトの前で実行されるため、拒否された呼び出しはバリアントごとのエラーを返す代わりに、プロジェクトをゼロ件作成します。オプトアウトには自由記述のwithoutDesignSystemReasonを含めることができ、これはwithoutDesignSystem: trueと一緒の場合にのみ有効です。両方とも結果にエコーされ、呼び出し履歴に記録されます。CLI での同等の指定はcreate --without-design-systemです。iterateはそのフラグを不明なものとして拒否します。design_iterateは意図的にゲートされていません。すでにデザインを保持しているプロジェクトではピッカーが提供されなくなるため、そこで選択するものは何もありません。design_variantsは作成するすべてのプロジェクトにfresh: trueを強制します。各バリアントは<base>-v<N>という名前になり、freshがないと再実行時に以前のファンアウトから同じ名前のプロジェクトを再利用することになります。そのプロジェクトはすでにデザインを保持しており、デザインシステムを後からアタッチできません。design_createとdesign_iterateはwait(デフォルトtrue)を受け付けます。wait: falseを設定すると、検証済みのChatPOST と、{ submitted: true, pending: true }を伴う制限付き質問フォーム監視の後に戻ります。CLI での同等の指定は--no-waitです。Chatリクエストを生成しないクリックや Enter キー押下は、成功を報告する代わりに失敗します。明示的な
nameを指定したdesign_createは検索または作成です。その正確な名前を持つ既存のプロジェクトがあれば再利用され(衝突時は最新が優先)、結果にはreused: trueが含まれるため、繰り返し呼び出すと重複が積み重なる代わりに1つのプロジェクトを反復処理します。fresh: trueを渡すと新しいプロジェクトを強制します。nameがない場合(プロンプトから派生した名前)、これまでどおり毎回新しいプロジェクトが作成されます。送信済みの作業は
design_check({ projectId })またはnode src/server.mjs check <projectId>でポーリングします。そのstatusはgenerating、awaiting_input、done、no_output、interrupted、stalled、resume_exhaustedのいずれかです。各チェックは、ターンがアクティブな間は保持しているオーナーページを再利用し(再読み込みなし)、可能な場合は質問フォームに回答し、中断バナーのResumeボタンを自動的にクリックします。interruptedはバナーが存在したが再開できなかったことを意味し、stalledはファイルツリーが安定していて生成ファイルがなく、最後のメッセージが依然としてユーザーのプロンプトであることを意味します。resume_exhaustedは Resume の試行が3回連続で失敗した後の終端状態で、resumeAttempts、maxResumeAttempts、problem: "resume_attempts_exhausted"を含みます。_ds/**のデザインシステム素材は生成された出力としてカウントされません。
非同期ワークフロー
# 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>要件
Node.js 22+(組み込みの
fetch/WebSocketを使用。playwright-coreが唯一の npm 依存関係)Google Chrome(ツールは専用の Chrome プロファイルを操作します)
Design アクセス権を持つ claude.ai アカウント(
design_loginで一度ログインします)
環境変数
CLAUDE_DESIGN_PROFILE— 専用 Chrome プロファイルディレクトリ(デフォルト~/.cache/claude-design-mcp/chrome-profile)CLAUDE_DESIGN_CHROME— Google Chrome へのパス(デフォルト: macOS の Google Chrome)CLAUDE_DESIGN_CDP_PORT— リモートデバッグポート(デフォルト9377)CLAUDE_DESIGN_DIR—design_pull/design_previewが書き込む場所。それぞれ独自の<project>/フォルダに書き込まれます(デフォルト: 作業フォルダ)。明示的なdir引数はそのまま使用されますCLAUDE_DESIGN_HISTORY_DIR—tools/call履歴が追記される場所(デフォルト~/.local/share/opencode-dashboard/claude-design-history、ファイルevents.ndjsonl)CLAUDE_DESIGN_HEADLESS—1を設定すると、オフスクリーンではなくヘッドレス Chrome を操作しますCLAUDE_DESIGN_TURN_TIMEOUT_MS— 生成ターンごとのハード上限(デフォルト: create 約360秒、iterate 約240秒)CLAUDE_DESIGN_QUIET_MS— 生成が完了と判定されるまでにターンのネットワークが沈黙していなければならない時間(デフォルト20000)CLAUDE_DESIGN_PAGE_LEASE_MS— 完了モニターがハングした場合の非同期オーナーページの独立したハード上限(デフォルト2700000、45分)CLAUDE_DESIGN_CLAUDE_BIN—design_system_syncが使用する Claude Code バイナリ(デフォルトclaude)CLAUDE_DESIGN_SYNC_TIMEOUT_MS— 1回の/design-sync実行のハード上限(デフォルト900000、15分)
デザインシステム同期
design_system_sync(CLI: sync <dir>)は、パッケージフォルダを作業ディレクトリとして
claude -p "/design-sync <pre-approval>" --dangerously-skip-permissions --output-format stream-json --verbose
を実行し、同期がアップロードした内容を報告します。トークンのみの同期が成功した後、ログイン済みの Chrome/CDP セッションを使用して、アップロードされた styles.css インポートシムを ds-bundle/_ds_bundle.css から生成されたカスタムプロパティ CSS に置き換えます。
フォルダはすでにパッケージである必要があります(
package.json+styles.cssなどの CSS エントリ、さらにtokens/*.json、guidelines/*.md、README.md)。コンポーネントはオプションです。トークンのみのパッケージも受け付けられます。package.jsonがない場合、ツールはスパウンする前に拒否します。終了ステータスは成功のシグナルではありません。 拒否された同期でも
subtype: "success"で終了コード0で終了するため、結果がok: trueになるのは、応答に実際のプロジェクトリンクが含まれている場合のみです。それ以外の場合は、診断用の完全な出力とともに{ ok: false, error, raw }が返されます。初回実行ではプロジェクトが作成され、
.design-sync/config.jsonが書き込まれます。これにより、以降の実行は同じプロジェクトに固定されます(変更のない再実行は重複ではなく no-op になります)。パイプラインがフォルダを再生成する場合は、置き換える前に.design-sync/をスナップショットし、後で復元してください。このツールはパッケージ自体を書き込むことはありません。プロンプトには事前承認(
src/sync.mjsのSYNC_ARGS)が含まれており、初回実行ではこれが重要な役割を果たします。 フォルダにピンがない場合、/design-syncは2つのAskUserQuestion確認を求めます。時間/コストを受け入れてから、create_projectの前に新しいプロジェクトの名前を確認します。claude -pにはAskUserQuestionツールがないため、ターンは質問を残したまま終了し、何もアップロードされません(終了コード0、subtype: "success"、プロジェクトリンクなし)。スキル自身の逃げ道(「リクエストがすでに時間/コストを認識している場合は…再確認せずに続行する」)が事前承認によって呼び出され、新しいプロジェクトの作成を明示的に指定します。ピンされた再同期はどちらのゲートにも該当しないため、これは初回同期でのみ発生します。Claude Code はスラッシュコマンドの後のテキストをフェンス付きの## Hintブロックとしてスキル本文に追加するため、トリプルバッククォートを含まない単一の位置文字列である必要があります。初回同期には約10分かかります。変更のない再実行は約2分です。CLI は同期失敗時に終了コード
1で終了します。結果には
flattened: true|falseが追加されます。同期後のブラウザ/書き込み失敗はflattenErrorとして報告されますが、完了したアップロードはok: trueのままです。
design_system_list(CLI: list-systems)は同じ機能の読み取り側です。claude.ai には独立したデザインシステムエンドポイントはありません。デザインシステムは、PROJECT_TYPE_DESIGN_SYSTEM というタグが付いた通常のプロジェクトリスト RPC によって返され、一度に20件ずつページングされるため、ツールはすべてのページをたどり、[{ name, id, publishedAt?, viewedAt? }] を返します(publishedAt はシステムが公開された後にのみ表示されます)。これを使用して、design_system_sync が実際にアカウントに何を配置したかを確認できます。API が変更された場合、scripts/probe-design-systems.mjs がそのライブの形状を再キャプチャします。
生成はいつ「完了」になるのか?
claude.ai/design は生成をターンとして駆動します。プロンプトは Chat RPC を通じてストリーミングされ、RenewTurn キープアライブ(約10秒ごと)によって維持され、ReleaseTurn によって終了します。design_create / design_iterate は、ファイルが安定し、かつターンネットワークが CLAUDE_DESIGN_QUIET_MS の間沈黙した後に戻ります。これはキープアライブ間隔よりも十分に長いため、生成が書き込み途中で中断されることは決してありません(常に完全で一貫性のあるデザインが得られ、半分レンダリングされたものは得られません)。
生成が静穏/安定性チェックの完了前にハードデッドラインに達した場合、結果には timedOut: true が含まれます。通常の完了ではこのフィールドは完全に省略されます。その存在は、返されたファイルが完全に静かなターンではなく、タイムアウト時点での最良のスナップショットであることを示すシグナルとして扱ってください。
claude.ai は最初のデザインが安定してから約30秒後に自動リファインパスを実行することが多いため、ツールが最初の完全なバージョンを返した後もサーバー上でデザインは改善され続けます。最も洗練された出力を得るには、design_pull / design_preview は常に最新の状態を取得します。または CLAUDE_DESIGN_QUIET_MS(例: 60000)を上げて、create が後続のリファインパスを待つようにします(待ち時間は長くなります)。
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