Connecter Claude ou Cursor à Cinevva (serveur MCP)

Cinevva fournit un serveur MCP hébergé qui permet à Claude, Claude Code, Cursor ou tout autre client MCP de créer vos jeux. L’IA que vous utilisez déjà devient le cerveau de l’opération : elle lit et modifie directement les fichiers de vos jeux sur nos serveurs, sans qu’aucun onglet de navigateur soit nécessaire. Ouvrez également votre jeu dans le créateur Cinevva pour activer la session en direct : l’IA peut alors importer des ressources depuis notre bibliothèque CC0, rigger et animer des modèles 3D, prendre des captures d’écran, simuler des entrées pour tester le jeu en cours d’exécution et actualiser l’aperçu, tandis que chaque modification s’affiche instantanément sur votre écran.

Ce qu’il vous faut

Un compte Cinevva (l’offre gratuite convient, mais le rigging 3D consomme les crédits de votre solde) et un client MCP prenant en charge les serveurs distants avec OAuth. L’URL du serveur est :

https://api.cinevva.com/create/mcp

Il utilise le protocole Streamable HTTP et s’authentifie avec OAuth 2.0. Lorsque vous vous connectez, votre client ouvre une page de connexion Cinevva dans le navigateur. Autorisez-le une fois et le client restera connecté.

Modifiez où que vous soyez. Passez en direct pour observer et tester.

La modification des fichiers ne nécessite rien d’autre que la connexion. Les outils de fichiers lisent et modifient la copie de référence de vos jeux sur nos serveurs. Votre assistant peut donc corriger un bug ou ajouter une fonctionnalité même si aucun onglet Cinevva n’est ouvert. Indiquez le nom du jeu souhaité (ou laissez l’IA choisir parmi vos jeux), puis formulez votre demande.

Le mode direct est une amélioration, pas une obligation. Ouvrez le jeu sur cinevva.com/create, attendez que l’aperçu se charge, puis cliquez sur Agent externe dans la barre d’outils du créateur (l’icône de prise, également disponible dans le menu « Plus » sur les petits écrans). Le panneau affiche « Agent en direct » une fois la connexion établie. Une session en direct donne à l’IA des yeux et des mains sur le jeu en cours d’exécution : captures d’écran, journaux de console, entrées simulées, importation de ressources et rigging 3D. Elle affiche également chaque modification sur votre écran dès son arrivée, qu’elle provienne de cet onglet ou d’une session sans interface. Le lien direct reste actif lors de vos prochaines visites, jusqu’à ce que vous cliquiez sur « Arrêter la session en direct ».

L’outil list_live_sessions indique les sessions connectées et, lorsqu’un seul jeu est ouvert, celui-ci est ciblé automatiquement.

Configuration dans Claude (claude.ai et application de bureau)

1. Ouvrez les paramètres, puis les connecteurs, et choisissez « Ajouter un connecteur personnalisé ».
2. Nommez-le Cinevva et collez https://api.cinevva.com/create/mcp comme URL. Vérifiez qu’aucun caractère indésirable ne s’est glissé dedans : l’URL doit se terminer par /create/mcp.
3. Cliquez sur Ajouter, puis sur Connecter. Connectez-vous avec votre compte Cinevva lorsque la page d’autorisation s’ouvre (le même compte que celui utilisé dans l’onglet de votre jeu).
4. Demandez par exemple à Claude « liste les fichiers de mon jeu Cinevva » pour vérifier la connexion. Pour effectuer des tests en direct, ouvrez votre jeu sur cinevva.com/create dans un autre onglet et cliquez sur Agent externe dans la barre d’outils.

Configuration dans Claude Code

claude mcp add --transport http cinevva https://api.cinevva.com/create/mcp

Claude Code vous guide dans la connexion OAuth lors de la première utilisation. Vous pouvez ensuite lui demander de lire les fichiers de votre jeu ou d’effectuer une modification. Il fonctionne directement depuis le terminal, sans qu’aucun onglet de navigateur soit ouvert.

Configuration dans Cursor

Ajoutez ceci à .cursor/mcp.json (pour un projet) ou à ~/.cursor/mcp.json (globalement) :

{
  "mcpServers": {
    "cinevva": {
      "url": "https://api.cinevva.com/create/mcp"
    }
  }
}

Cursor détecte le serveur, lance le processus OAuth dans votre navigateur et répertorie les outils dans ses paramètres MCP.

Fonctionnement des outils

Groupe	Outils	Nécessite une session en direct ?
Lire le jeu	list_game_files, read_files, search_game_file	Non, lit la copie serveur de n’importe lequel de vos jeux
Modifier le jeu	edit_files, write_files, delete_files, rename_files	Non, les modifications sont enregistrées côté serveur et transmises à tout onglet ouvert
Aperçu	game_ready	Actualise l’aperçu d’un onglet en direct, ou enregistre sans interface dans le cas contraire
Observer le jeu	read_console_logs, take_screenshot	Oui
Tests	execute_js, simulate_input, get_task_status	Oui
Ressources	search_assets, list_asset_packs, import_asset, search_fonts	Oui. Environ 7 000 objets, fichiers audio et HDRI sous licence CC0
Rigging 3D	rig_model, apply_animation	Oui, consomme des crédits
Documentation	list_library_docs, search_library_docs, read_library_docs, list_animations	Oui

Le rigging coûte le même nombre de crédits que dans le créateur de jeux intégré à l’application. Tout le reste est gratuit. Le créateur intégré permet également de générer avec l’IA des images, de la musique, des effets sonores et des skyboxes. Ces outils se trouvent directement dans l’application Cinevva et ne font pas partie du connecteur MCP.

Résolution des problèmes

Le message « Aucun serveur MCP n’a été trouvé à l’URL fournie » pendant la configuration signifie généralement que l’URL contient une faute de frappe ou un caractère supplémentaire à la fin. Elle doit être exactement https://api.cinevva.com/create/mcp.

Le message « Aucune session en direct » provient uniquement des outils d’exécution (captures d’écran, console, entrées, ressources et rigging). Il signifie qu’aucun onglet de navigateur n’a ouvert ce jeu avec le lien direct activé. Ouvrez votre jeu, cliquez sur Agent externe dans la barre d’outils, puis réessayez. Les outils de fichiers n’en ont jamais besoin : sans session, ils fonctionnent sur n’importe lequel de vos jeux grâce à son gameId et répertorient vos jeux si vous n’en fournissez aucun.

Si les outils restent bloqués lors d’une nouvelle connexion, actualisez l’onglet du jeu afin qu’il se reconnecte, puis appelez list_live_sessions.

Pour toute question ou tout problème : [email protected].