Dê um design system ao Windsurf

O agente Cascade do Windsurf é forte em código, mas não conhece sua marca. Adicione o servidor MCP Identity Forge à configuração do Windsurf e ele poderá navegar, aplicar e seguir um DESIGN.md real e um conjunto de tokens.

Atualizado 2026-07-13

Por que o Windsurf precisa de um design system

O Cascade constrói funcionalidades de ponta a ponta, mas como todo agente, ele redefine a estilização a cada turno: uma cor de destaque ligeiramente diferente aqui, um espaçamento novo ali, uma fonte nova na próxima tela. Um design system elimina as suposições: um conjunto de tokens semânticos e um DESIGN.md escrito que o Cascade segue, para que todo o aplicativo pareça um único produto em vez de dez prompts diferentes.

O Windsurf requer instalação manual (por enquanto)

O comando identityforge install --client … ainda não suporta o Windsurf. O Windsurf aceita o mesmo formato padrão de MCP, então adicione o servidor manualmente como mostrado abaixo. Os caminhos via CLI e shadcn funcionam sem o MCP.

O kit que você vai instalar

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

O kit gratuito Ambient Sage, renderizado a partir de seus tokens reais: o sistema que o Cascade escreve no seu repositório.

Instale-o (configuração manual de MCP)

  1. 1

    Abra a configuração de MCP do Windsurf

    No Windsurf, abra Settings → Cascade → MCP servers e escolha editar a configuração bruta (~/.codeium/windsurf/mcp_config.json).

  2. 2

    Adicione o servidor identityforge

    Cole a entrada abaixo no objeto mcpServers (mescle-a com quaisquer servidores existentes).

    {
      "mcpServers": {
        "identityforge": {
          "command": "npx",
          "args": ["-y", "identityforge@latest", "mcp"]
        }
      }
    }
  3. 3

    Atualize os servidores MCP

    De volta ao painel de MCP do Cascade, atualize para que as ferramentas do identityforge sejam carregadas.

  4. 4

    Peça ao Cascade para tematizar o app

    Forneça o produto, o público e o clima; ele usará search_themes, get_design_md e apply_theme.

    Use Identity Forge to pick a clean, editorial theme for a
    recipe site, apply it, and follow the DESIGN.md.

Ou pule o MCP inteiramente

Como o Windsurf pode executar comandos de terminal, os caminhos agnósticos de cliente funcionam sem qualquer edição de configuração: o Cascade (ou você) apenas executa um comando:

  1. 1

    Aplicação via CLI

    Escreve o DESIGN.md + um arquivo de tokens no diretório atual. Peça ao Cascade para ler o DESIGN.md e conectar os tokens.

    identityforge apply ambient-sage
  2. 2

    Registro shadcn

    Instala as variáveis CSS do kit diretamente para projetos shadcn/ui.

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

O guia do Cursor cobre o mesmo fluxo de MCP com um comando de instalação suportado, e o guia principal conecta todas as ferramentas. Para entender o conteúdo enviado, leia o que é um DESIGN.md.

FAQ

Como eu dou um design system ao Windsurf?

Adicione o servidor MCP Identity Forge ao ~/.codeium/windsurf/mcp_config.json usando a entrada mcpServers padrão (comando `npx`, args `-y identityforge@latest mcp`), atualize os servidores MCP do Cascade e, em seguida, peça ao Cascade para escolher e aplicar um kit. Ou pule o MCP e execute `identityforge apply <slug>`.

Existe um comando install --client windsurf?

Ainda não. O comando de instalação da CLI suporta atualmente claude-code, cursor, codex, gemini, vscode, opencode e pi. O Windsurf usa o mesmo formato de MCP, então você cola a configuração do servidor manualmente.

Posso evitar editar arquivos de configuração?

Sim. Execute `identityforge apply <slug>` para escrever o DESIGN.md e os tokens no diretório atual, ou `npx shadcn add https://identityforge.io/r/<slug>.json` para projetos shadcn/ui. Nenhum dos dois precisa de uma configuração de MCP.