Gib Windsurf ein Design System

Der Cascade-Agent von Windsurf ist stark im Coding, kennt aber deine Marke nicht. Füge den Identity Forge MCP-Server zu deiner Windsurf-Konfiguration hinzu, damit er eine echte DESIGN.md und ein Token-Set durchsuchen, anwenden und befolgen kann.

Aktualisiert 2026-07-13

Warum Windsurf ein Design System braucht

Cascade baut Features von Ende zu Ende, aber wie jeder Agent entscheidet er bei jedem Schritt das Styling neu: hier eine leicht andere Akzentfarbe, dort ein neuer Abstand, beim nächsten Screen eine neue Schriftart. Ein Design System nimmt das Raten aus dem Prozess: Ein Satz semantischer Tokens und eine geschriebene DESIGN.md, der Cascade folgt, sorgen dafür, dass die gesamte App wie ein einziges Produkt aussieht und nicht wie zehn verschiedene Prompts.

Windsurf erfordert (aktuell) eine manuelle Installation

Der Befehl identityforge install --client … unterstützt Windsurf noch nicht. Windsurf akzeptiert jedoch dieselbe Standard-MCP-Struktur, also füge den Server wie unten gezeigt manuell hinzu. Die CLI- und shadcn-Pfade funktionieren auch ohne MCP.

Das Kit, das du installieren wirst

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

Das kostenlose Ambient Sage Kit, gerendert aus seinen echten Tokens: das System, das Cascade in dein Repo schreibt.

Installation (manuelle MCP-Konfiguration)

  1. 1

    Öffne die Windsurf-MCP-Konfiguration

    Öffne in Windsurf Settings → Cascade → MCP servers und wähle die Option, die Rohkonfiguration zu bearbeiten (~/.codeium/windsurf/mcp_config.json).

  2. 2

    Füge den identityforge-Server hinzu

    Füge den unten stehenden Eintrag in das mcpServers-Objekt ein (mergi ihn mit eventuell vorhandenen Servern).

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

    MCP-Server aktualisieren

    Gehe zurück zum MCP-Panel in Cascade und klicke auf Refresh, damit die identityforge-Tools geladen werden.

  4. 4

    Cascade anweisen, die App zu thematisieren

    Gib Produkt, Zielgruppe und Stimmung vor; Cascade nutzt dann search_themes, get_design_md und apply_theme.

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

Oder überspringe MCP komplett

Da Windsurf Terminal-Befehle ausführen kann, funktionieren die clientunabhängigen Wege auch ohne Konfigurationsänderung: Cascade (oder du) führt einfach einen Befehl aus:

  1. 1

    CLI apply

    Schreibt DESIGN.md + eine Tokens-Datei in das aktuelle Verzeichnis. Bitte Cascade, die DESIGN.md zu lesen und die Tokens einzubinden.

    identityforge apply ambient-sage
  2. 2

    shadcn-Registry

    Installiert die CSS-Variablen des Kits direkt für shadcn/ui Projekte.

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

Der Cursor-Guide beschreibt denselben MCP-Workflow mit einem unterstützten Installationsbefehl, und der Pillar-Guide verknüpft alle Tools. Um die Payload zu verstehen, lies was eine DESIGN.md ist.

FAQ

Wie gebe ich Windsurf ein Design System?

Füge den Identity Forge MCP-Server mit dem Standard-mcpServers-Eintrag (Befehl `npx`, Args `-y identityforge@latest mcp`) zu ~/.codeium/windsurf/mcp_config.json hinzu, aktualisiere die MCP-Server in Cascade und bitte Cascade dann, ein Kit auszuwählen und anzuwenden. Oder überspringe MCP und führe `identityforge apply <slug>` aus.

Gibt es einen `install --client windsurf` Befehl?

Noch nicht. Der Install-Befehl des CLI unterstützt derzeit claude-code, cursor, codex, gemini, vscode, opencode und pi. Windsurf nutzt dieselbe MCP-Struktur, also fügst du die Server-Konfiguration manuell ein.

Kann ich das Bearbeiten von Konfigurationsdateien vermeiden?

Ja. Führe `identityforge apply <slug>` aus, um DESIGN.md und Tokens in das aktuelle Verzeichnis zu schreiben, oder nutze `npx shadcn add https://identityforge.io/r/<slug>.json` für shadcn/ui Projekte. Beides benötigt keine MCP-Konfiguration.