Por que o Cursor precisa de um design system
O Agente e o Composer do Cursor geram funcionalidades inteiras rapidamente, mas cada geração pode tomar decisões de estilo novas. Sem um sistema fixo, o espaçamento, as cores e os formatos dos componentes variam entre os arquivos. Um design system fornece ao Agente um conjunto de tokens semânticos e um DESIGN.md escrito, para que os componentes posteriores sigam as mesmas regras do primeiro.
O Cursor suporta MCP nativamente. O Agente pode usar ferramentas para pesquisar, buscar e aplicar um kit enquanto trabalha, além de ler os arquivos que o kit instala.
O kit que você vai instalar
Abaixo está o kit gratuito ambient-sage, renderizado a partir dos tokens exatos que o Agente escreve no seu projeto:
Ambient Sage
Live renderRendered from the kit's actual tokens, fonts, and treatments
Dashboard
Welcome back — here's how AmbientSage is performing today.
Active users
15.1k
+5%Trending up this month
vs. previous 30 days
MRR
$49.1k
+3%Strong recurring growth
Net of churn
Retention
89%
+2%Engagement above target
Rolling 28-day window
NPS
69
+3Meets growth projections
Survey · n=1,204
Total revenue
Last 12 months
$49.1k+18.2%
Recent sales
You closed 265 deals this month.
Alex Rivera
alex@ambientsage.com
Mira Okonkwo
mira@ambientsage.com
Jonas Feld
jonas@ambientsage.com
Sana Qureshi
sana@ambientsage.com
Theo Lindgren
theo@ambientsage.com
Recent transactions
View all| Customer | Status | Date | Amount |
|---|---|---|---|
AR Alex Rivera Founder & CEO | Paid | 2m ago | $1,999.00 |
MO Mira Okonkwo Head of Product | Pending | 1h ago | $39.00 |
JF Jonas Feld Design Lead | Processing | 3h ago | $299.00 |
SQ Sana Qureshi Engineering Lead | Paid | Yesterday | $99.00 |
TL Theo Lindgren Brand Director | Refunded | 2d ago | $2,400.00 |
Typography
Plus Jakarta Sans
Color system
28 semantic roles, light + dark
Agent outputs
DESIGN.md, CSS, Tailwind, shadcn
Instale-o (MCP)
- 1
Escreva a configuração do MCP
Execute isto na raiz do seu projeto para mesclar o servidor no
.cursor/mcp.json.npx --yes identityforge@latest install --client cursor - 2
Habilite o servidor no Cursor
Abra Settings → MCP (ou o painel MCP) e ative o servidor
identityforge. Reinicie o Cursor se as ferramentas não aparecerem. - 3
Faça login (opcional para kits gratuitos)
npx --yes identityforge@latest login - 4
Peça ao Agente para tematizar seu app
Informe o produto, o público e o clima; ele fará uma lista com
search_themes, lerá o briefing comget_design_mde aplicará comapply_theme.Use Identity Forge to pick a minimal, warm theme for a wellness app, apply it, and follow the DESIGN.md.
A entrada no `.cursor/mcp.json`
O comando de instalação escreve este servidor stdio. Você também pode colá-lo manualmente:
{
"mcpServers": {
"identityforge": {
"command": "npx",
"args": ["-y", "identityforge@latest", "mcp"]
}
}
}Reforce com uma regra do Cursor (opcional)
Para tornar o Agente consistente mesmo fora de uma rodada de aplicação de kit, adicione uma regra curta de projeto (.cursor/rules) dizendo a ele para estilizar apenas com base nos tokens semânticos e seguir o DESIGN.md. Isso combina bem com o kit: os tokens definem os valores, e a regra garante que o código gerado sempre os utilize.
Always style against the semantic design tokens defined in the
project (bg-background, text-foreground, bg-primary, bg-muted,
border-border, …) and follow the rules and motifs in DESIGN.md.
Never hardcode raw hex colors or introduce a new font.Prefere não usar MCP? Caminhos diretos
- 1
Aplicação via CLI
Escreve o DESIGN.md + um arquivo de tokens no diretório atual; peça ao Cursor para conectá-los.
identityforge apply ambient-sage - 2
Registro shadcn
Instala as variáveis CSS do kit diretamente se você usa shadcn/ui.
npx shadcn add https://identityforge.io/r/ambient-sage.json
Veja a mesma configuração para Claude Code e Windsurf, ou comece pelo guia fundamental.
FAQ
Como eu dou um design system ao Cursor?
Execute `… identityforge install --client cursor` para adicionar o servidor MCP do Identity Forge ao .cursor/mcp.json, habilite-o em Settings → MCP e então peça ao Agente do Cursor para escolher e aplicar um kit. Ele escreverá um DESIGN.md e tokens semânticos no projeto.
Onde fica a configuração?
No arquivo `.cursor/mcp.json` na raiz do seu projeto. Após a instalação, habilite o servidor identityforge nas configurações de MCP do Cursor.
Devo usar uma regra do Cursor também?
Ajuda bastante. Uma nota curta no .cursor/rules dizendo ao Agente para estilizar apenas com base nos tokens semânticos e seguir o DESIGN.md mantém o código gerado dentro do sistema, mesmo quando você não estiver aplicando um kit explicitamente.
Posso fazer isso sem MCP?
Sim. `identityforge apply <slug>` escreve o DESIGN.md e os tokens no diretório atual, ou `npx shadcn add https://identityforge.io/r/<slug>.json` instala as variáveis CSS do kit para projetos shadcn/ui.