# nano.design in Cursor

Cursor's agent designs in nano.design while you watch in the browser, then reads the finished frame back as code, tokens and assets to build it in your project.

## Add nano.design

Add nano.design to `~/.cursor/mcp.json` to use it in every project, or to `.cursor/mcp.json` in a project to share it with everyone who works on it:

```json ~/.cursor/mcp.json
{
  "mcpServers": {
    "nano": { "url": "https://nano.design/mcp" }
  }
}
```

If the file already lists other servers, add the `nano` entry next to them inside `mcpServers`.

## Sign in

Open Cursor's MCP settings and find **nano**. When it asks you to sign in, Cursor opens nano.design in your browser.

## Try it

- "Design an empty state and a first-run screen for this dashboard in nano.design. Send me the live link first."
- "Match our existing components: read `src/components` and design the new billing page in nano.design with them."
- After you've adjusted the design: "Build the billing frame from nano.design in `app/billing/page.tsx`."

## If something goes wrong

- **nano doesn't appear.** Check the JSON is valid, then reload the Cursor window.
- **The agent doesn't use the tools.** Make sure nano's tools are switched on in Cursor's MCP settings, then ask again and name nano.design.
- **You signed in with the wrong account.** Log out of nano in Cursor's MCP settings and sign in again.

## What signing in looks like

Your client opens nano.design in the browser. Sign in with Google, GitHub or an emailed link, then click **Allow access**. Keep **Open nano in a new tab** checked to watch the design appear as it's made.

No account yet? Choose **Try without an account**. The agent gets a guest workspace for 2 hours, with room for 10 designs, and gives you a link to keep them. Sign in from that link and the designs move into your account. Otherwise they're deleted.

Every change an agent makes is saved as a version, so you can go back to any earlier state.

## Better designs from the start

Agents design better with taste. In Claude Code, Cursor, Codex, opencode and other agents that support skills, install the free design-taste skill:

```bash
npx skills add nano-design-org/skills --skill design-taste
```

In Claude, [download the skill](https://nano.design/skills/design-taste.zip) and upload it under **Settings → Capabilities**. People can read the same guidance as the [design guide](/guide).
