Claude Design
Drive Anthropic's Claude Design through the claude-design MCP server. Designs live in real claude.ai/design projects: rendered previews, shareable links, editable in the web UI.
Prerequisites
The claude-design MCP tools (claude-design_*) must be available. If the server is not connected, connect it (mcp({ connect: "claude-design" })). If connecting fails with an auth error, tell the user to run /design-login and stop.
Workflow
- Load Anthropic's design guidance first. Call
claude-design_get_claude_design_promptand follow it — it is the same system prompt the claude.ai/design agent uses (file conventions, artboard structure, quality bar). Consultclaude-design_read_design_skillfor specific design-quality topics when relevant. Do not improvise your own conventions when theirs conflict. - Pick a project.
claude-design_list_projectsto reuse an existing project when the user is iterating; otherwiseclaude-design_create_project. Checkclaude-design_list_design_systemsand apply the user's design system when one exists. - Gather local context. When designing for the current codebase, scan it for design tokens (tailwind config, CSS variables), existing components, and brand assets, and reflect them in the design files.
- Write the design.
claude-design_finalize_planwith the exact paths, thenclaude-design_write_files. For multiple directions, produce distinct labeled variations (A/B/C) as separate artboards/files, per the loaded design prompt's conventions. - Show it.
claude-design_render_previewand give the user theserve_url(and project URL) to open. Do not describe the design in prose as a substitute for the preview. - Iterate. Apply feedback with further
finalize_plan→write_filesrounds against the same project. Checkclaude-design_list_commentsfor inline comments left in the web UI andclaude-design_ack_commentsafter addressing them. - Implement (optional). When the user picks a direction and wants it built,
claude-design_read_filethe chosen files and implement them in the codebase using its real components and conventions.
Notes
- Auth is lazy; the first tool call may take a moment while the server connects and refreshes the token. A 401 after a long idle session means reconnect; a persistent auth failure means
/design-login. - Sharing:
claude-design_update_sharing/claude-design_add_memberwhen the user asks to share.