Skip to main content
For Claude Code and Cursor, the agent setup package is the default way to integrate Ditto. It bundles:
  • The Ditto MCP server, preconfigured
  • Session instructions that tell the agent to check Ditto styleguide rules and reuse existing text when writing user-facing text
  • Skills:
    • /ditto-review: check the current diff’s user-facing strings against your styleguide rules and existing Ditto text; returns a fix-list.
    • /ditto-audit [path]: check the path for user-facing strings against your styleguide rules and existing Ditto text; returns a fix-list.
    • /ditto-spec-audit [component]: (for repos using Ditto specs) audit every instance of a specced component across the codebase against its spec’s rules.
    • /ditto-spec-component <component>: (for repos using Ditto specs) analyze a component, create or update its Ditto spec file (and specs for child components that lack one), and sync styleguide rules from the platform.
    • /ditto-spec-gaps [component]: (for repos using Ditto specs) find text patterns across component instances that should be styleguide rules but aren’t; create approved ones on the platform.
Use the manual setup if you only want the MCP server without the instructions and skills.

​
Install in Claude Code

Send each command as its own prompt:
Then:
  1. Restart Claude Code and approve the ditto MCP server (if not approved already).
  2. Run /mcp, select ditto, and choose Authenticate. A browser tab opens for you to log in to Ditto and approve access.

​
Claude Desktop

Click Customize: Claude Step 1 Find the Plugin tab -> Add -> Add marketplace: Claude Step 2 Paste https://github.com/dittowords/ditto-agent-setup: Claude Step 3 Install Ditto: Claude Step 4 Finally, go to Connectors -> Ditto -> Connect/Reconnect to complete authorization: Claude Step 5

​
Cursor

In Cursor Settings go to Plugins and paste https://github.com/dittowords/ditto-agent-setup in the “Search or Paste Link” input. Click on Ditto -> Add to Cursor. Cursor Step 1 Next go to Tools & MCPs and authenticate with the ditto Plugin MCP Server. Cursor Step 2

​
Optional: set up Ditto Specs

Ditto Specs are *.ditto.md files that co-locate text rules with your components. Run /ditto-spec-setup and the agent will ask for confirmation, then install the specs CLI if missing, create dittospec.config.json and workspace.ditto.md, and scaffolds component spec files. With specs in place /ditto-spec-audit, /ditto-spec-component, and /ditto-spec-gaps become usable.