Dokumentation

KI-Assistenten (MCP)

Was du hier lernst

Claude Desktop, Claude Code oder einen anderen MCP-Client verbinden: Der Assistent gestaltet, übersetzt, prüft und exportiert im offenen Projekt – live und rücknehmbar.

Vitrine Studio hat einen eingebauten MCP-Server. Ein Assistent wie Claude arbeitet am Projekt, das du gerade geöffnet hast: Du siehst jede Änderung live auf der Leinwand, und jede Änderung ist ein Rückgängig-Schritt mit dem Namen des Assistenten – „Claude Desktop: Move title“.

Claude Desktop

  1. Starte Vitrine Studio.
  2. App-Einstellungen → KI-Assistenten (MCP) → Zu Claude Desktop hinzufügen… Der Dialog zeigt die Konfigurationsdatei, den Eintrag, der hinzukommt, und den Status (Noch nicht eingerichtet, Bereits eingerichtet, Mit anderem Pfad eingerichtet – wird aktualisiert). Konfiguration schreiben legt vorher eine Sicherungskopie an und lässt deine anderen Einträge in Ruhe.
  3. Starte Claude Desktop neu.

Claude Desktop startet dann vitrine mcp, das sich mit der laufenden App verbindet – oder sie startet, wenn sie geschlossen ist (Bei Bedarf starten).

Der Eintrag, falls du ihn lieber von Hand einträgst (der genaue Pfad steht in den Einstellungen):

{
  "mcpServers": {
    "vitrine-studio": {
      "command": "/Applications/Vitrine Studio.app/Contents/MacOS/vitrine",
      "args": ["mcp"]
    }
  }
}

Konfigurationsdatei: macOS ~/Library/Application Support/Claude/claude_desktop_config.json, Windows %APPDATA%\Claude\claude_desktop_config.json, Linux ~/.config/Claude/claude_desktop_config.json.

App-Einstellungen, Abschnitt KI-Assistenten (MCP): Verbindungsstatus, fester Port, Start bei Bedarf, die Befehle für andere MCP-Clients, Zu Claude Desktop hinzufügen und der Befehl für Claude Code. App-Einstellungen, Abschnitt KI-Assistenten (MCP): Verbindungsstatus, fester Port, Start bei Bedarf, die Befehle für andere MCP-Clients, Zu Claude Desktop hinzufügen und der Befehl für Claude Code.
App-Einstellungen → KI-Assistenten (MCP).

Claude Code

Kopiere den Befehl aus App-Einstellungen → KI-Assistenten (MCP) → Claude Code → Über den Befehl vitrine verbinden (empfohlen), z. B.:

claude mcp add vitrine-studio -- "/Applications/Vitrine Studio.app/Contents/MacOS/vitrine" mcp

(Mit installiertem Kommandozeilen-Tool: claude mcp add vitrine-studio -- vitrine mcp.) Direkt per HTTP gibt es auch, aber Port und Token ändern sich bei jedem Start der App.

Andere MCP-Clients

Jeder MCP-Client funktioniert. Am besten: ein stdio-Server namens vitrine-studio mit dem Befehl vitrine und dem Argument mcp (Andere MCP-Clients → Befehl (stdio) zeigt den vollständigen Pfad). Clients, die Streamable HTTP sprechen, können die URL http://127.0.0.1:<port>/mcp mit dem Header Authorization: Bearer <token> aus den Einstellungen nutzen – gültig bis zum Neustart der App; mit einem Festen Port bleibt der Port gleich.

So wird verbunden

  • Die App bietet den MCP-Zugang nur auf diesem Computer an (127.0.0.1), mit einem geheimen Token, das sich bei jedem Start ändert. Ausschalten kannst du ihn mit KI-Assistenten über MCP verbinden lassen.
  • vitrine mcp (das, was Claude Desktop startet) leitet an die laufende App weiter; läuft keine und ist Bei Bedarf starten an, startet es die App (und wartet bis zu 20 Sekunden).
  • Ohne App – CI, ein Server, Bei Bedarf starten aus – arbeitet vitrine mcp --headless --project <ordner> direkt auf dem Ordner, ohne Live-Ansicht.

Was du in der App siehst

  • Die Assistenten-Anzeige in der oberen Leiste: grau = aus, MCP = bereit, mit dem Namen des Clients, wenn einer verbunden ist. Ein Klick öffnet Assistenten-Aktivität – jeder Schritt mit Uhrzeit; Klick wählt die geänderten Elemente aus, der letzte Schritt lässt sich rückgängig machen.
  • Geänderte Elemente werden auf der Leinwand kurz hervorgehoben, mit einem kleinen Hinweis „Claude Desktop: …“ (Klick wählt sie aus).
  • Ein Projekt, das der Assistent öffnet oder anlegt, öffnet sich in der App.

Was ein Assistent kann

  • Anlegen und strukturieren: Projekte (auch aus Vorlagen), Leinwände, Ziele, Banner, Sprachen, Varianten.
  • Gestalten: Elemente hinzufügen, verschieben, skalieren, drehen, gruppieren und umstylen; Stile bearbeiten; Overrides pro Variante und pro Sprache.
  • Übersetzen: fehlende Texte finden, Übersetzungen schreiben, CSV/XLIFF austauschen.
  • Das Ergebnis sehen: render_preview liefert das gerenderte Bild – ein exportiertes Bild, die ganze Leinwand mit Lücken oder die Store-Galerie – plus die Probleme dieses Ziels und dieser Sprache. layout_report zeigt, wie jeder Text eingepasst wurde. Die Galerie lässt sich auf der dunklen Store-Seite zeigen (background: dark), für große Sets als JPEG schicken oder ins Projekt speichern (out_file, z. B. für eine README).
  • Prüfen und erzeugen: prüfen, exportieren, Screenshots und Schriften importieren. Ein Export, der länger als etwa 45 Sekunden dauert, läuft im Hintergrund weiter; der Assistent fragt mit export_status nach, bis er fertig ist.
  • Vorlagen: auflisten, speichern, einfügen.
  • Uploads: planen und – mit deiner Bestätigung – ausführen (siehe unten).

Werkzeuge richten sich nach dem, was du gerade ansiehst: Ohne Ziel oder Sprache nehmen sie die aktuelle Ansicht der App, und selection_get liest deine Auswahl – so funktioniert „mach das hier 20 % kleiner“.

Prompts zum Ausprobieren

  • „Leg ein Vitrine-Studio-Projekt in ~/Screens/Fernwood (en, de) für einen Gartenplaner an, drei iPhone-Seiten mit je Überschrift und Phone, und zeig mir die Galerie.“
  • „Übersetze alles Fehlende ins Französische und prüf dann Seite 2 auf Französisch auf Überläufe.“
  • „Ich habe den Titel ausgewählt – mach ihn nur auf Deutsch 20 % kleiner.“
  • „Füge ein Ziel iPad 13″ quer mit zwei Seiten pro Bild hinzu und behebe alles, was sich überlappt.“
  • „Exportiere iPhone und iPad für alle Sprachen.“

Agent-Skill

Mit der MCP-Verbindung kann ein Assistent alles bearbeiten – der Agent-Skill bringt ihm zusätzlich bei, wie gute Store-Screenshots für deine eigene App mit Vitrine Studio entstehen: die Vorteile deiner App finden, kurze Überschriften schreiben, die Seiten aufbauen (auch Panoramen über mehrere Seiten), Sprachen, die Store-Regeln, die Prüfungen, der Export und – nur nach deiner Bestätigung – der Upload. Es ist ein herstellerneutraler Skill im offenen Agent-Skills-Format, das viele Assistenten und Coding-Agents lesen; er braucht nur einen MCP-Client, der mit Vitrine Studio verbunden ist (siehe oben).

Installiere ihn mit dem Kommandozeilen-Tool skills, das viele Agents kennt (Node.js):

npx skills add vitrinestudio-app/vitrine-agent-skill            # Agents interaktiv auswählen
npx skills add vitrinestudio-app/vitrine-agent-skill -g -a <agent>   # global, für einen bestimmten Agent
npx skills add vitrinestudio-app/vitrine-agent-skill@v1.0.0     # auf ein Release festlegen

Ohne das Tool: Kopiere den Ordner skills/vitrine-store-screenshots/ in den Skills-Ordner deines Agents (Ordnername beibehalten), oder lade ihn – bei Clients, die Skill-Uploads annehmen – als Zip hoch. Ein fertiges Zip kommt mit dem ersten Release auf die Releases-Seite des Repositorys. Dann bitte z. B. um „Mach App-Store-Screenshots für meine App in Vitrine Studio“.

Quelltext, Hinweise je Client und Lizenz (MIT): github.com/vitrinestudio-app/vitrine-agent-skill.

Uploads

Einen Upload-Plan (upload_plan) kann ein Assistent immer erstellen – das ist ein Probelauf. Um ihn auszuführen, zeigt dir Vitrine Studio einen Dialog „Claude Desktop möchte in die Stores hochladen“ mit dem Plan; nur dein Klick auf Upload bestätigen startet ihn. Abgelehnt oder 5 Minuten unbeantwortet → es passiert nichts.

Headless (vitrine mcp --headless) sind Uploads durch Assistenten aus. Sie lassen sich nur einschalten, indem du mcp_allow_headless_upload: true in die settings.yaml der App schreibst – überleg dir das gut.

Datenschutz und Sicherheit

  • Die MCP-Werkzeuge machen keine eigenen Netzwerkanfragen – nur die Store-Upload-Werkzeuge sprechen mit den Stores. Dateien werden nur im Projektordner geschrieben und an Pfaden, die der Assistent ausdrücklich nennt (Exportordner, Übersetzungsdateien).
  • Store-Schlüssel lassen sich über MCP weder lesen noch importieren noch ändern; die Store-Zuordnung ist für Assistenten schreibgeschützt.
  • Installierte Geräterahmen sind schreibgeschützt.
  • Was der Assistent von deinem Projekt sieht, geht wie jeder andere Gesprächsinhalt an seinen Anbieter – es gelten die üblichen Regeln deines KI-Anbieters.

Diese Seite auf GitHub verbessern