Le paquet yesilcam-studios amène Yeşilçam Studios dans votre terminal et dans les assistants IA qui parlent MCP (Model Context Protocol). Il installe deux commandes : yesilcam, la ligne de commande pour les scripts et les chaînes de production, et yesilcam-mcp, un serveur qui permet à Claude Code, Claude Desktop, Cursor, VS Code, Windsurf et aux autres clients MCP d’utiliser les studios comme des outils. La version 0.3 couvre tous les studios avec 131 opérations : Image, Film, Animation, Cinema, Design, Website, Fashion Try-On, Maket et AI Influencer Studio, ainsi que votre compte et votre bibliothèque. Elle utilise le même compte, le même solde de jetons et les mêmes prix que l’application web. Ce guide vous accompagne de l’installation jusqu’à une première conversation qui fonctionne. Pour une vue d’ensemble, consultez la page Développeurs.

De quoi ai-je besoin ?

  • Node.js 18 ou plus récent, qui fournit la commande npm.
  • Un compte Yeşilçam Studios. Free, Basic et Pro conviennent tous ; certaines fonctions demandent Basic ou Pro, exactement comme dans l’application.
  • Un terminal. Pour la partie assistant, un client MCP comme Claude Code, Claude Desktop ou Cursor.

Comment l’installer ?

Installez le paquet globalement depuis le site de Yeşilçam Studios :

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

yesilcam --version doit afficher 0.3.0. yesilcam --help liste les groupes de commandes, un par studio, et yesilcam <group> --help (par exemple yesilcam image --help) affiche les commandes et options de chaque groupe.

Comment me connecter ?

La méthode recommandée est une clé API. Vous la créez dans l’application, sous Compte → Développeur. Lors de la création, vous choisissez :

  • Un nom, pour distinguer vos clés plus tard (par exemple « Portable » ou « Serveur de build »).
  • L’accès : Lecture seule (solde, prix, bibliothèque, statut des travaux) ou Lecture et création, qui peut aussi lancer des travaux et consommer des jetons.
  • La validité : 30, 90 ou 365 jours, ou sans expiration.

La clé commence par ysk_ et n’est affichée qu’une seule fois : copiez-la immédiatement. Lancez ensuite yesilcam login et collez-la. La saisie est masquée, la clé n’est jamais affichée et elle est enregistrée dans ~/.config/yesilcam/config.json, avec des droits qui la rendent lisible par votre seul utilisateur. Vérifiez que tout fonctionne :

yesilcam login
yesilcam account show

Si vous n’avez pas encore de clé, vous pouvez vous connecter avec votre e-mail et votre mot de passe : yesilcam login --password. Une session est alors enregistrée dans le même fichier. Sur un serveur ou en CI, n’enregistrez rien sur le disque : placez la clé dans la variable d’environnement YESILCAM_API_KEY, ou transmettez-la avec yesilcam login --key-stdin.

Comment connecter Claude Code ?

Une seule commande enregistre le serveur :

claude mcp add yesilcam -- yesilcam-mcp

Le serveur lit les identifiants enregistrés par yesilcam login : il n’y a donc aucune clé dans la commande, ni dans la configuration de Claude Code.

Comment connecter Claude Desktop, Cursor, VS Code ou Windsurf ?

Ces clients lisent leurs serveurs MCP dans un fichier de configuration JSON : claude_desktop_config.json pour Claude Desktop, ~/.cursor/mcp.json pour Cursor, et les réglages MCP de VS Code et de Windsurf. Ajoutez cette entrée :

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

Si le fichier contient déjà d’autres serveurs, ajoutez "yesilcam" à l’intérieur de l’objet mcpServers existant au lieu d’en créer un second. Redémarrez ensuite le client. Inutile de retenir tout cela : yesilcam mcp affiche les extraits prêts à l’emploi pour chaque client.

Puis-je charger moins d’outils ?

Oui. 131 outils, c’est une longue liste, et si vous n’utilisez que quelques studios, une liste plus courte aide l’assistant à rester concentré. Indiquez les studios voulus dans args :

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

Les noms disponibles sont image, film, animation, cinema, design, website, fashion, maket et influencer. Les outils du compte et de la bibliothèque sont toujours chargés. Ajoutez "--read-only" pour ne charger que les outils de lecture, par exemple pour un assistant qui doit rendre compte de votre bibliothèque sans jamais lancer de travail.

À quoi doit ressembler ma première conversation ?

Commencez par quelque chose de gratuit : « Quel est mon solde de jetons Yeşilçam, et combien coûte une image en brouillon avec mon offre ? » L’assistant appelle les outils de solde et de prix, puis répond. Essayez ensuite un petit travail : « Crée une image brouillon en 16:9 d’un phare au coucher du soleil. Donne-moi d’abord le prix, puis enregistre-la sur mon bureau. » L’assistant reçoit d’abord un devis, et rien n’est débité. Il vous montre le prix et, seulement après votre accord, rappelle l’outil avec l’approbation, attend l’image et la télécharge. Le guide sur la validation des jetons détaille cette étape, et les recettes par studio vous montrent quoi demander ensuite.

Dépannage

  • « command not found ». Le dossier où npm place les commandes globales n’est pas dans votre PATH. npm prefix -g indique son emplacement ; ajoutez son dossier bin au PATH et ouvrez un nouveau terminal.
  • « not signed in » (code de sortie 2). Aucun identifiant enregistré n’a été trouvé. Relancez yesilcam login, ou vérifiez que YESILCAM_API_KEY est bien définie dans l’environnement où la commande s’exécute.
  • L’assistant n’affiche pas les outils Yeşilçam. Redémarrez le client après avoir modifié sa configuration. S’il ne parvient toujours pas à lancer le serveur, indiquez le chemin complet de la commande (affiché par which yesilcam-mcp sous macOS et Linux) comme "command".
  • La clé est refusée. Elle a peut-être expiré ou été révoquée. Créez une nouvelle clé dans Compte → Développeur et relancez yesilcam login.
  • La création est refusée, ou l’assistant n’a aucun outil de création. La clé a été créée avec l’accès Lecture seule, ou le serveur a été lancé avec --read-only.

Questions fréquentes

La CLI ou le serveur MCP coûtent-ils quelque chose en plus ? Non. Les opérations coûtent exactement le même prix que dans l’application, selon les tarifs de votre offre, et rien n’est débité avant que vous n’approuviez un devis.

Ma clé se retrouve-t-elle dans la configuration de l’assistant ? Non. La configuration ne nomme que la commande yesilcam-mcp ; le serveur lit la clé que yesilcam login a enregistrée sur votre ordinateur.

Comment me déconnecter d’un ordinateur ? Lancez yesilcam logout. Les identifiants enregistrés sont supprimés de cet ordinateur. Une clé API reste toutefois valable ailleurs jusqu’à ce que vous la révoquiez dans Compte → Développeur.

Puis-je utiliser l’application et la CLI en même temps ? Oui. Les travaux lancés depuis le terminal ou un assistant apparaissent dans la même bibliothèque et utilisent le même solde que l’application.