Das Paket yesilcam-studios bringt Yeşilçam Studios in Ihr Terminal und zu KI-Assistenten, die MCP (Model Context Protocol) sprechen. Es installiert zwei Befehle: yesilcam, die Kommandozeile für Skripte und Pipelines, und yesilcam-mcp, einen Server, über den Claude Code, Claude Desktop, Cursor, VS Code, Windsurf und andere MCP-Clients die Studios als Werkzeuge nutzen. Version 0.3 deckt mit 131 Operationen jedes Studio ab: Image, Film, Animation, Cinema, Design, Website, Fashion Try-On, Maket und AI Influencer Studio, dazu Ihr Konto und Ihre Bibliothek. Es gelten dasselbe Konto, dasselbe Token-Guthaben und dieselben Preise wie in der Web-App. Dieser Leitfaden führt Sie von der Installation bis zum ersten funktionierenden Gespräch. Einen Überblick finden Sie auf der Entwicklerseite.

Was brauche ich?

  • Node.js 18 oder neuer; damit steht der Befehl npm zur Verfügung.
  • Ein Konto bei Yeşilçam Studios. Free, Basic und Pro funktionieren gleichermaßen; manche Funktionen setzen wie in der App Basic oder Pro voraus.
  • Ein Terminal. Für den Assistenten zusätzlich einen MCP-Client wie Claude Code, Claude Desktop oder Cursor.

Wie installiere ich das Paket?

Installieren Sie das Paket global von der Website von Yeşilçam Studios:

npm install -g https://yesilcamstudios.com/downloads/yesilcam-studios.tgz
yesilcam --version
yesilcam --help

yesilcam --version sollte 0.3.0 ausgeben. yesilcam --help listet die Befehlsgruppen auf, eine pro Studio, und yesilcam <group> --help (zum Beispiel yesilcam image --help) zeigt die Befehle und Optionen der jeweiligen Gruppe.

Wie melde ich mich an?

Empfohlen ist ein API-Schlüssel. Sie erstellen ihn in der App unter Konto → Entwickler. Beim Erstellen legen Sie fest:

  • Einen Namen, damit Sie Ihre Schlüssel später auseinanderhalten (zum Beispiel „Laptop“ oder „Build-Server“).
  • Die Berechtigung: Nur lesen (Guthaben, Preise, Bibliothek, Auftragsstatus) oder Lesen und erstellen, womit auch Arbeiten gestartet und Tokens verbraucht werden können.
  • Die Gültigkeit: 30, 90 oder 365 Tage oder unbegrenzt.

Der Schlüssel beginnt mit ysk_ und wird nur einmal angezeigt; kopieren Sie ihn also sofort. Führen Sie dann yesilcam login aus und fügen Sie ihn ein. Die Eingabe ist verdeckt, der Schlüssel wird nie angezeigt und in ~/.config/yesilcam/config.json mit Rechten gespeichert, die nur Ihr Benutzer lesen kann. Prüfen Sie, ob es geklappt hat:

yesilcam login
yesilcam account show

Haben Sie noch keinen Schlüssel, können Sie sich stattdessen mit E-Mail und Passwort anmelden: yesilcam login --password. Dabei wird eine Sitzung in derselben Datei gespeichert. Auf einem Server oder in CI sollte nichts auf der Festplatte liegen: Hinterlegen Sie den Schlüssel in der Umgebungsvariablen YESILCAM_API_KEY oder übergeben Sie ihn per Pipe mit yesilcam login --key-stdin.

Wie verbinde ich Claude Code?

Ein Befehl registriert den Server:

claude mcp add yesilcam -- yesilcam-mcp

Der Server liest die mit yesilcam login gespeicherten Zugangsdaten. Im Befehl steht also kein Schlüssel, und auch in der Konfiguration von Claude Code landet keiner.

Wie verbinde ich Claude Desktop, Cursor, VS Code oder Windsurf?

Diese Clients lesen MCP-Server aus einer JSON-Konfigurationsdatei: claude_desktop_config.json bei Claude Desktop, ~/.cursor/mcp.json bei Cursor und die MCP-Einstellungen bei VS Code und Windsurf. Fügen Sie diesen Eintrag hinzu:

{"mcpServers":{"yesilcam":{"command":"yesilcam-mcp","args":[]}}}

Stehen in der Datei bereits andere Server, ergänzen Sie "yesilcam" im vorhandenen Objekt mcpServers, statt ein zweites anzulegen. Starten Sie den Client danach neu. Merken müssen Sie sich nichts davon: yesilcam mcp gibt die fertigen Ausschnitte für jeden Client aus.

Kann ich weniger Werkzeuge laden?

Ja. 131 Werkzeuge sind eine lange Liste, und wenn Sie nur einige Studios nutzen, bleibt der Assistent mit einer kürzeren Liste fokussierter. Geben Sie die gewünschten Studios in args an:

{"mcpServers":{"yesilcam":{"command":"yesilcam-mcp","args":["--studios","image,film,influencer"]}}}

Verfügbar sind image, film, animation, cinema, design, website, fashion, maket und influencer. Die Werkzeuge für Konto und Bibliothek werden immer geladen. Mit "--read-only" laden Sie nur lesende Werkzeuge, etwa für einen Assistenten, der über Ihre Bibliothek berichten, aber nie selbst Arbeiten starten soll.

Wie sieht ein erstes Gespräch aus?

Beginnen Sie mit etwas Kostenlosem: „Wie hoch ist mein Yeşilçam-Token-Guthaben, und was kostet ein Entwurfsbild in meinem Tarif?“ Der Assistent ruft die Werkzeuge für Guthaben und Preis auf und antwortet. Probieren Sie dann einen kleinen Auftrag: „Erstelle ein Entwurfsbild im Format 16:9 von einem Leuchtturm bei Sonnenuntergang. Nenne mir zuerst den Preis und speichere es dann auf meinem Schreibtisch.“ Der Assistent erhält zunächst ein Angebot, und nichts wird abgebucht. Er zeigt Ihnen den Preis, und erst nach Ihrer Zustimmung ruft er das Werkzeug erneut mit Freigabe auf, wartet auf das Bild und lädt es herunter. Der Leitfaden zur Token-Freigabe erklärt diesen Schritt im Detail, und die Rezepte für die Studios zeigen, worum Sie als Nächstes bitten können.

Fehlerbehebung

  • „command not found“. Der Ordner, in dem npm globale Befehle ablegt, ist nicht in Ihrem PATH. npm prefix -g zeigt den Ort; nehmen Sie dessen Ordner bin in den PATH auf und öffnen Sie ein neues Terminal.
  • „not signed in“ (Exit-Code 2). Es wurden keine gespeicherten Zugangsdaten gefunden. Führen Sie yesilcam login erneut aus oder prüfen Sie, ob YESILCAM_API_KEY in der Umgebung gesetzt ist, in der der Befehl läuft.
  • Der Assistent zeigt die Yeşilçam-Werkzeuge nicht an. Starten Sie den Client nach dem Bearbeiten der Konfiguration neu. Kann er den Server weiterhin nicht starten, tragen Sie den vollständigen Pfad des Befehls (unter macOS und Linux mit which yesilcam-mcp zu ermitteln) als "command" ein.
  • Der Schlüssel wird abgelehnt. Er ist möglicherweise abgelaufen oder wurde widerrufen. Erstellen Sie unter Konto → Entwickler einen neuen Schlüssel und führen Sie yesilcam login erneut aus.
  • Erstellen wird abgelehnt, oder dem Assistenten fehlen die erstellenden Werkzeuge. Der Schlüssel wurde mit der Berechtigung Nur lesen erstellt, oder der Server wurde mit --read-only gestartet.

Häufige Fragen

Kosten die CLI oder der MCP-Server extra? Nein. Jede Operation kostet genau so viel wie in der App, zu den Preisen Ihres Tarifs, und nichts wird abgebucht, bevor Sie ein Angebot freigeben.

Landet mein Schlüssel in der Konfiguration des Assistenten? Nein. Die Konfiguration nennt nur den Befehl yesilcam-mcp; der Server liest den Schlüssel, den yesilcam login auf Ihrem Computer gespeichert hat.

Wie melde ich mich auf einem Computer ab? Mit yesilcam logout. Damit werden die gespeicherten Zugangsdaten von diesem Computer entfernt. Ein API-Schlüssel funktioniert an anderer Stelle weiter, bis Sie ihn unter Konto → Entwickler widerrufen.

Kann ich App und CLI gleichzeitig nutzen? Ja. Arbeiten, die Sie im Terminal oder über einen Assistenten starten, erscheinen in derselben Bibliothek und nutzen dasselbe Guthaben wie die App.