Integration
Claude Code edits everywhere. Windcraft keeps the design language fixed.
Claude Code is happy to refactor ten files in one run. That reach is the point — and the risk: design choices ripple. Windcraft gives Claude Code a local MCP server to read tokens and contracts from instead of inventing them.
Why agentic edits amplify drift
A single-file assistant drifts one component at a time. Claude Code touches whole features in a run, so a guessed radius or an off-brand blue propagates across every file it edits. Your CLAUDE.md describes the look in prose, but prose is re-interpreted each turn. Without values to read, the agent fills the gaps with plausible-but-inconsistent choices, and it does it at scale.
How Windcraft plugs into Claude Code
Windcraft runs as a local MCP server. You register it with one command, and from then on Claude Code can pull the exact tokens, the component contract, and the page pattern before it writes — no prose interpretation in the loop.
- Run npx windcraft init in your repo to generate the config.
- Register the server: claude mcp add windcraft -- npx windcraft mcp.
- Claude Code calls get_design_tokens / get_component_contract / get_page_pattern as it works.
- Run npx windcraft check to flag any drift before you commit.
Register the Windcraft MCP server with Claude Code
claude mcp add windcraft -- npx windcraft mcpFAQ
- How is this different from a CLAUDE.md file?
- CLAUDE.md is prose the model re-reads and re-interprets each turn. Windcraft serves machine-readable values over MCP, so Claude Code reads the actual radius and hex — not an adjective. Keep CLAUDE.md for conventions; let Windcraft own the measurable design language.
- Do I run a separate server?
- No long-running process to babysit. The claude mcp add command tells Claude Code to launch npx windcraft mcp on demand; it runs locally for the duration of the session.
- Does my source code leave my machine?
- No. The MCP server and the analyzer run locally. Only metadata — tokens, contracts, rule violations — is ever synced to the cloud.