Dê um design system ao Claude Code

O Claude Code escreve código de produção, mas não tem memória da sua marca entre os prompts. Conecte o servidor MCP do Identity Forge e ele poderá escolher um kit, escrever os tokens e o DESIGN.md no seu repositório e construir cada tela com base neles.

Atualizado 2026-07-13

Por que o Claude Code precisa de um design system

O Claude Code não possui estado (stateless) em relação ao design. Cada prompt começa do zero, então ele recorre aos mesmos padrões seguros: Inter, um fundo slate-950, um destaque violeta e cards genéricos. Construa algumas telas e elas começarão a divergir porque nada fixa o visual. Um design system é esse fixador: um conjunto de tokens semânticos e um DESIGN.md escrito que o agente consulta em cada tarefa, para que a página cinco combine com a página um.

O Claude Code também é um ajuste natural para o MCP. Uma vez que o servidor esteja conectado, o agente não recebe apenas arquivos estáticos: ele pode navegar pelo catálogo, ler o briefing completo de um kit e aplicá-lo, tudo de dentro da sua sessão sem que você precise sair do terminal.

O kit que você vai instalar

Aqui está o kit gratuito ambient-sage renderizado a partir de seus tokens reais: o sistema exato que o agente escreve no seu repositório quando aplica este slug:

Ambient Sage

Live render

Rendered from the kit's actual tokens, fonts, and treatments

AmbientSage/Dashboard
Search...⌘K
AS

Dashboard

Welcome back — here's how AmbientSage is performing today.

Jan 1 – Jan 30, 2026
Overview
Analytics
Reports
Notifications

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

+3

Meets growth projections

Survey · n=1,204

Total revenue

Last 12 months

$49.1k+18.2%

12m30d7d
JanFebMarAprMayJunJulAugSepOctNovDec

Recent sales

You closed 265 deals this month.

AR

Alex Rivera

alex@ambientsage.com

+$1,999.00
MO

Mira Okonkwo

mira@ambientsage.com

+$39.00
JF

Jonas Feld

jonas@ambientsage.com

+$299.00
SQ

Sana Qureshi

sana@ambientsage.com

+$99.00
TL

Theo Lindgren

theo@ambientsage.com

+$2,400.00

Recent transactions

View all
CustomerStatusDateAmount
AR

Alex Rivera

Founder & CEO

Paid2m ago$1,999.00
MO

Mira Okonkwo

Head of Product

Pending1h ago$39.00
JF

Jonas Feld

Design Lead

Processing3h ago$299.00
SQ

Sana Qureshi

Engineering Lead

PaidYesterday$99.00
TL

Theo Lindgren

Brand Director

Refunded2d ago$2,400.00

Typography

Plus Jakarta Sans

Color system

28 semantic roles, light + dark

Agent outputs

DESIGN.md, CSS, Tailwind, shadcn

Ambient Sage: Plus Jakarta Sans, superfícies planas neutras e quentes, um destaque amarelo vívido. Troque o kit e todo o sistema muda.

Instale agora (MCP, recomendado)

  1. 1

    Escreva a configuração do MCP

    Execute isto na raiz do seu projeto. Isso mescla um servidor identityforge ao .mcp.json (não irá sobrescrever servidores existentes).

    npx --yes identityforge@latest install --client claude-code
  2. 2

    Reinicie o Claude Code

    Reinicie para que ele reconheça o novo servidor e, em seguida, confirme se as ferramentas estão disponíveis pedindo ao Claude para digitar /mcp ou listar suas ferramentas do Identity Forge.

  3. 3

    Faça login (opcional para kits gratuitos)

    Necessário apenas para dados de propriedade do usuário, cota de API maior ou kits Pro. Utiliza um fluxo PKCE via navegador.

    npx --yes identityforge@latest login
  4. 4

    Peça um visual e deixe o agente aplicá-lo

    Forneça o produto, o público e o clima (mood). Ele faz uma pré-seleção com search_themes, lê o briefing com get_design_md e escreve o DESIGN.md + tokens com apply_theme.

    Use Identity Forge to pick a calm, trustworthy theme for a
    fintech dashboard, apply it, and follow the DESIGN.md.

O que o `.mcp.json` contém

O comando de instalação escreve exatamente isto: um único servidor stdio que executa o pacote versionado. Você também pode adicioná-lo manualmente:

{
  "mcpServers": {
    "identityforge": {
      "command": "npx",
      "args": ["-y", "identityforge@latest", "mcp"]
    }
  }
}
.mcp.json: a entrada do servidor MCP identityforge

Prefere não usar MCP? Dois caminhos diretos

O Claude Code pode executar comandos de shell, então você não precisa estritamente do servidor MCP. Qualquer uma destas opções fornecerá os mesmos tokens e o DESIGN.md:

  1. 1

    Aplicação via CLI

    Escreve o DESIGN.md mais um arquivo de tokens no diretório atual. Diga ao Claude para ler o DESIGN.md e integrar os tokens na sua camada de estilização.

    identityforge apply ambient-sage
  2. 2

    Registro shadcn

    Se você estiver usando shadcn/ui, isso instala as variáveis CSS do kit diretamente no tema do seu projeto.

    npx shadcn add https://identityforge.io/r/ambient-sage.json

Um exemplo real

Com o servidor conectado, pergunte: Use o Identity Forge para tematizar este app para um produto de bem-estar, calmo e minimalista. O Claude pode chamar search_themes({ description: "wellness product, calm and minimal" }), escolher ambient-sage, ler seu DESIGN.md e executar apply_theme. Ele então refatora os componentes para usar tokens semânticos como bg-background, text-foreground e bg-primary, enquanto segue as regras do kit para cards, sombras e tipografia. As telas criadas posteriormente herdarão os mesmos arquivos e regras.

Próximo passo: faça o mesmo no Cursor, leia o que é um DESIGN.md ou navegue por kits por estilo visual para encontrar um slug que combine com seu produto.

FAQ

Como eu dou um design system ao Claude Code?

Execute `npx --yes identityforge@latest install --client claude-code` para adicionar o servidor MCP do Identity Forge ao .mcp.json, reinicie o Claude Code e peça para ele escolher e aplicar um kit. O agente escreve um DESIGN.md e tokens semânticos no seu repositório e constrói com base neles.

Onde fica a configuração?

No arquivo `.mcp.json` na raiz do seu projeto. O comando de instalação mescla o servidor identityforge em qualquer configuração MCP existente, em vez de sobrescrevê-la.

Preciso pagar ou fazer login?

Não para kits gratuitos: o servidor MCP, a aplicação via CLI e o registro shadcn funcionam sem conta. Faça login apenas para projetos de sua propriedade, mais cota de API ou kits Pro. Gerencie suas chaves em /account/api-keys.

Posso usar sem o MCP?

Sim. `identityforge apply <slug>` escreve o DESIGN.md e os tokens no diretório atual, e `npx shadcn add https://identityforge.io/r/<slug>.json` instala as variáveis CSS do kit se você usar shadcn/ui.