> ## Documentation Index
> Fetch the complete documentation index at: https://developer.dittowords.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Install the Ditto MCP server, always-on instructions, and skills in one step with the agent setup package

For Claude Code and Cursor, the [agent setup package](https://github.com/dittowords/ditto-agent-setup) 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](/mcp-reference/installation) if you only want the MCP server without the instructions and skills.

## Install in Claude Code

Send each command as its own prompt:

```text theme={null}
/plugin marketplace add dittowords/ditto-agent-setup
```

```text theme={null}
/plugin install ditto@ditto
```

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:

<img src="https://mintcdn.com/ditto/5zth-7kfxkxk-RFM/images/claude-step-1.png?fit=max&auto=format&n=5zth-7kfxkxk-RFM&q=85&s=2cb1f2b8fbc682c8683dc482d2ae53f2" alt="Claude Step 1" width="1054" height="584" data-path="images/claude-step-1.png" />

Find the Plugin tab -> Add -> Add marketplace:

<img src="https://mintcdn.com/ditto/5zth-7kfxkxk-RFM/images/claude-step-2.png?fit=max&auto=format&n=5zth-7kfxkxk-RFM&q=85&s=a0878ca96fc62338e887313030c084ef" alt="Claude Step 2" width="2624" height="2090" data-path="images/claude-step-2.png" />

Paste `https://github.com/dittowords/ditto-agent-setup`:

<img src="https://mintcdn.com/ditto/5zth-7kfxkxk-RFM/images/claude-step-3.png?fit=max&auto=format&n=5zth-7kfxkxk-RFM&q=85&s=96768a9092c1cd5620124167ca9741bd" alt="Claude Step 3" width="2624" height="2090" data-path="images/claude-step-3.png" />

Install Ditto:

<img src="https://mintcdn.com/ditto/5zth-7kfxkxk-RFM/images/claude-step-4.png?fit=max&auto=format&n=5zth-7kfxkxk-RFM&q=85&s=4453779bb097c02dea935eb076bc251d" alt="Claude Step 4" width="2624" height="2090" data-path="images/claude-step-4.png" />

Finally, go to Connectors -> Ditto -> Connect/Reconnect to complete authorization:

<img src="https://mintcdn.com/ditto/5zth-7kfxkxk-RFM/images/claude-step-5.png?fit=max&auto=format&n=5zth-7kfxkxk-RFM&q=85&s=aefe5c1ff767fb970d00303bc0983e16" alt="Claude Step 5" width="2624" height="2090" data-path="images/claude-step-5.png" />

## 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**.

<img src="https://mintcdn.com/ditto/laCjxQwcBt02wjt8/images/cursor-step-1.png?fit=max&auto=format&n=laCjxQwcBt02wjt8&q=85&s=a5c92b09f89f4517d97277c405c37a91" alt="Cursor Step 1" width="3164" height="1688" data-path="images/cursor-step-1.png" />

Next go to **Tools & MCPs** and authenticate with the ditto Plugin MCP Server.

<img src="https://mintcdn.com/ditto/laCjxQwcBt02wjt8/images/cursor-step-2.png?fit=max&auto=format&n=laCjxQwcBt02wjt8&q=85&s=b86e5ac8cba71e54553dc7a3695ee1f7" alt="Cursor Step 2" width="2012" height="1940" data-path="images/cursor-step-2.png" />

## Optional: set up Ditto Specs

[Ditto Specs](https://developer.dittowords.com/ditto-specs-cli-reference/overview) 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.