Dokumentation
KI-Assistenten (MCP)
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
- Starte Vitrine Studio.
- 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.
- 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.

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_previewliefert 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_reportzeigt, 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_statusnach, 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.