Serveur MCP pour Unity : configuration avec Claude Code, coût et options gratuites

Taper « ajoute un point d’apparition et corrige la référence nulle dans mon script d’inventaire » dans un terminal, puis regarder l’Éditeur Unity l’exécuter, ressemble à un tour de démonstration. Ce n’en est pas un. Un serveur MCP pour Unity donne à Claude Code la capacité d’agir dans l’Éditeur : il peut lire la Console, créer des GameObjects, modifier des scripts C# et lancer des tests sans que vous ayez à copier-coller quoi que ce soit. Ce que la plupart des tutoriels omettent, c’est que le terrain a changé. Unity a déprécié le serveur MCP intégré à son propre package AI Assistant, les serveurs communautaires gratuits se sont multipliés, et la facture dépend bien moins du serveur que du modèle auquel vous le connectez.

Cette page détaille la configuration de chaque solution, le coût réel en dollars et en tokens, ainsi que les options gratuites qui tiennent la route au quotidien. Les commandes, versions et prix ont été vérifiés en octobre 2026 à partir de la documentation d’Unity, des dépôts de projets et de la page tarifaire de Claude.

💡 Réponse courte : chaque serveur MCP pour Unity présenté ici est gratuit. Claude Code, lui, ne l’est pas : il nécessite un forfait Claude payant ou des crédits d’API. La configuration la moins chère et solide consiste en un serveur communautaire gratuit associé au forfait Claude que vous possédez peut-être déjà.

Quel serveur MCP pour Unity choisir

Quatre noms reviennent dans presque toutes les recherches. L’un est officiel et désormais déprécié. Les trois autres sont open source et ne sont pas concernés par cet avis. Le choix dépend de votre version d’Unity, de votre préférence entre Python et Node sur la machine, et de la proximité que vous souhaitez garder avec la feuille de route d’Unity.

Le serveur officiel et sa dépréciation

Unity intègre un serveur MCP dans le package com.unity.ai.assistant. Il nécessite Unity 6 (6000.0) ou une version ultérieure et se trouve dans Edit > Project Settings > AI > Unity MCP. La documentation actuelle s’ouvre sur une phrase sans détour : « Unity MCP server is deprecated. Use the Unity command-line interface (CLI) instead. »

Lisez attentivement la portée de cet avis, car elle est plus étroite qu’il n’y paraît :

L’Unity CLI embarque son propre serveur MCP, construit sur le package Unity Pipeline, et il parle le même protocole : votre client se connecte donc de la même manière qu’aujourd’hui. Unity indique que ce mode MCP ne fait pas partie de la dépréciation et qu’il « reste pleinement pris en charge ».

Trois serveurs communautaires comparés

MCP for Unity expose 48 points d’entrée d’outils pour les scènes, les GameObjects, les scripts C#, les assets, les tests, le profilage et les builds. Il fonctionne aussi avec Claude Desktop, VS Code, Cursor, Windsurf, Cline et Gemini CLI, si bien qu’une seule installation sert le client que vous testerez ensuite. Unity-MCP annonce plus de 70 outils intégrés, répartis entre projet et assets, scène et hiérarchie, scripting et éditeur, et profilage. mcp-unity ajoute des opérations par lots avec retour arrière, pratiques lorsqu’un agent modifie de nombreux objets à la fois.

Une règle empirique : sur Unity 2021 ou 2022, choisissez MCP for Unity. Sur Unity 6 avec Node déjà installé, mcp-unity est le choix le plus simple. Si vous voulez le plus grand nombre d’outils dès l’installation, regardez du côté de Unity-MCP.

Configurer Claude Code, étape par étape

Installez d’abord Claude Code si ce n’est pas déjà fait : npm install -g @anthropic-ai/claude-code, puis exécutez claude --version pour vérifier qu’il répond.

Voie 1 : l’Unity CLI, la voie d’Unity

C’est là qu’Unity oriente désormais tout le monde, et c’est gratuit. Unity précise que la CLI « est gratuite et distincte de Unity AI » et ne nécessite aucun abonnement Unity AI. Pour piloter un Éditeur en cours d’exécution, le projet doit utiliser Unity 6.0 LTS ou une version ultérieure.

1. Installez l’Unity CLI depuis la documentation d’Unity.
2. Exécutez unity pipeline install pour ajouter le package Unity Pipeline.
3. Exécutez unity mcp configure claude pour écrire la configuration de Claude Code.
4. Exécutez unity mcp configure --list pour afficher chaque client pris en charge et son statut.
5. Exécutez unity skill install <agent-name> pour ajouter à votre agent les compétences Unity.

Le serveur de pipeline local n’accepte les connexions que sur localhost, et la CLI pilote un Éditeur local hors ligne.

💡 Claude Code peut exécuter des commandes shell, vous n’aurez donc peut-être pas besoin de MCP du tout. unity command et unity eval pilotent directement l’Éditeur et, selon Unity, sont plus rapides et consomment moins de tokens que MCP. Gardez le mode MCP pour les environnements qui ne peuvent pas exécuter de commandes shell.

Encore sur l’ancien serveur intégré à l’éditeur ? Ouvrez Edit > Project Settings > AI > Unity MCP, vérifiez que Unity Bridge affiche Running, dépliez Integrations, sélectionnez Claude Code et appuyez sur Configure. Pour une saisie manuelle, pointez Claude Code vers le binaire relais avec l’argument --mcp : %USERPROFILE%\.unity\relay\relay_win.exe sous Windows. La première connexion affiche une demande en attente dans Unity, et vous appuyez une fois sur Accept. La page d’Unity mentionne aussi qu’un essai ou un abonnement actif aux outils IA d’Unity est un prérequis pour ce serveur.

Voie 2 : MCP for Unity

1. Dans Unity, ouvrez Window > Package Manager, appuyez sur +, choisissez Add package from git URL et collez https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#main. L’alternative OpenUPM est openupm add com.coplaydev.unity-mcp.
2. Installez Python 3.10 ou une version plus récente, ainsi que uv.
3. Dans l’Éditeur, allez dans Window > MCP for Unity et choisissez Configure All Detected Clients.
4. Ouvrez Claude Code dans le dossier du projet et exécutez claude mcp list pour confirmer la connexion.

Voie 3 : Coplay MCP via uvx

Coplay publie un guide distinct pour Claude Code. Il demande Unity 2022 ou une version ultérieure, Node.js avec npm, et Python 3.11 ou une version plus récente. Ajoutez le package Unity depuis https://github.com/CoplayDev/unity-plugin.git#beta, puis enregistrez le serveur en une seule ligne :

claude mcp add --scope user --transport stdio coplay-mcp --env MCP_TOOL_TIMEOUT=720000 -- uvx --python ">=3.11" coplay-mcp-server@latest

Copier le prompt

La valeur MCP_TOOL_TIMEOUT=720000 accorde douze minutes à chaque appel d’outil, ce qui compte pour les builds et les tests longs. Ce guide n’indique aucun tarif : vérifiez le site de Coplay avant de vous y fier pour une équipe.

Configurations manuelles pour les autres

Unity-MCP s’enregistre avec une seule commande, le binaire se trouvant dans le dossier Library de votre projet :

claude mcp add ai-game-developer "<unityProjectPath>/Library/mcp-server/win-x64/gamedev-mcp-server.exe" port=<port> client-transport=stdio

Copier le prompt

mcp-unity s’installe depuis https://github.com/CoderGamester/mcp-unity.git, se lance depuis Tools > MCP Unity > Server Window et lit un fichier .mcp.json à la racine du projet :

{
  "mcpServers": {
    "mcp-unity": {
      "command": "node",
      "args": ["Library/PackageCache/com.gamelovers.mcp-unity@<hash>/Server~/build/index.js"]
    }
  }
}

Copier le prompt

Remplacez <hash> par le nom de dossier réel de votre cache de packages.

Vérifier que tout fonctionne

Exécutez claude mcp list. Une entrée saine ressemble à coplay-mcp: ✓ Connected. Testez ensuite toute la chaîne avec le prompt que suggère Unity lui-même : « Read the Unity console messages and summarize any warnings or errors. » Si Claude vous restitue le contenu réel de votre Console, le pont fonctionne.

Ce que cela coûte réellement

Le serveur est la partie bon marché. C’est le modèle sous-jacent qui fait grimper la facture.

Le serveur est gratuit

MCP for Unity et mcp-unity utilisent la licence MIT. Unity-MCP utilise Apache-2.0. L’Unity CLI est également gratuite, et son installation ne nécessite pas d’abonnement Unity AI. Aucun de ces outils ne facture à l’appel, au siège ou à la scène.

Forfait Claude Code ou API

Claude Code est inclus dans tous les forfaits Claude payants et partage les limites d’usage de ce forfait, ce qui exclut le forfait Free.

Le calcul API se vérifie facilement. Une session qui lit 400 000 tokens en entrée et en écrit 40 000 en sortie avec Sonnet 5.5 coûte 0,80 $ plus 0,40 $, soit 1,20 $. Les hiérarchies de scènes et les dumps de Console gonflent le côté entrée : demandez donc des lectures ciblées, par exemple une scène ou un script à la fois.

Crédits Unity AI sur la voie officielle

Le produit IA d’Unity est un achat distinct. Les utilisateurs personnels bénéficient d’un essai de 14 jours avec 1 000 crédits, puis de 10 $ par mois, sauf s’ils résilient. Les sièges Pro, Enterprise et Industry incluent une allocation mensuelle de crédits qui ne se reporte pas. La passerelle IA d’Unity permet à Claude Code de se connecter avec votre abonnement Anthropic existant sans consommer de crédits Unity AI : un forfait Claude associé à la CLI évite donc de payer deux fois.

Les options gratuites qui fonctionnent vraiment

Le mot « gratuit » demande une définition ici. Les serveurs sont gratuits. Le modèle, lui, se paie, sauf si vous le payez déjà.

Serveur gratuit, forfait que vous possédez déjà

Comme MCP for Unity fonctionne avec Claude Desktop, VS Code, Cursor, Windsurf, Cline et Gemini CLI, vous pouvez le rattacher à l’assistant que vous payez déjà. La couche MCP ajoute 0 $. Si vous avez un forfait Claude Pro, Claude Code y est déjà inclus, et l’ensemble ne vous coûte que les 20 $ que vous dépensiez de toute façon.

Modèles ouverts, avec réserves

Certains clients MCP peuvent router les requêtes vers un modèle à poids ouverts hébergé chez vous. Considérez cela comme un projet de week-end, et non comme une configuration prête à l’emploi : l’appel d’outils est le point où les petits modèles locaux trébuchent, et Unity lui-même note que certains modèles ne composent pas les lignes de commande de manière fiable. Testez avec le prompt de résumé de Console ci-dessus avant de confier une scène à un modèle.

L’Unity CLI fonctionne aussi sans aucun agent. Elle installe et gère les versions de l’Éditeur, gère les projets, lance des builds en mode headless et exécute des suites de tests, ce qui en fait, à elle seule, un outil d’intégration continue gratuit.

Pour la seule partie réflexion, par exemple la rédaction d’un script C# ou la lecture d’un texte d’erreur, les modèles de chat hébergés sur PicassoIA comme GPT OSS 20B ou Granite 8B Code Instruct 128K peuvent faire l’affaire. Ils ne touchent jamais à votre Éditeur : vous recopiez donc le code à la main.

Corriger les erreurs de connexion courantes

La plupart des échecs viennent d’une incompatibilité de version ou d’un chemin, et non de Claude. Parcourez cette liste dans l’ordre.

💡 Modifiez une seule chose à la fois et relancez le prompt de résumé de Console après chaque changement. Tester trois réglages à la fois, c’est ainsi qu’une correction de dix minutes se transforme en soirée.

L’art du jeu autour de votre flux MCP

Un serveur MCP déplace des objets dans l’Éditeur. Il ne peint pas vos textures et ne sculpte pas vos accessoires : ces assets viennent donc d’ailleurs.

Concept art et textures avec l’IA

Les modèles d’image comblent l’écart entre « il me faut un mur de pierre couvert de mousse » et un fichier dans votre dossier Assets. Générez des images de référence ou des candidats de texture plate avec Seedream 4.5, Qwen Image 3 ou GPT Image 2, corrigez les défauts avec PicassoIA Image Editor Pro, puis importez les fichiers et demandez à Claude, via MCP, de créer un matériau et de l’assigner aux bons objets.

Vérifiez les raccords avant de répéter une texture. Une image générée isolée n’est pas garantie de se répéter proprement : testez donc le matériau sur une grande surface en premier.

Où placer les modèles 3D

Le catalogue de PicassoIA est construit autour des modèles d’image, de vidéo, d’audio et de langage, et une recherche dans sa catégorie 3D n’a renvoyé aucun modèle au moment de la rédaction : il ne vous fournira donc pas de maillage. Il peut en revanche produire les références dont a besoin un artiste 3D ou un outil de maillage, comme des vues de face, de côté et de trois quarts d’un accessoire. En attendant, Claude peut ébaucher un niveau avec des formes de base via MCP, et vous remplacez ces formes par de vrais maillages au fur et à mesure de leur arrivée.

Comment utiliser Sonnet 5 sur PicassoIA

Claude Sonnet 5 ne pilotera pas votre Éditeur, mais c’est un moyen rapide de rédiger et de déboguer du C# avant même qu’un script n’arrive dans Unity.

1. Ouvrez la page du modèle Claude Sonnet 5.
2. Remplissez une fois le System Prompt : « You write C# for Unity 6. Return one script per code block. No placeholders. »
3. Collez l’erreur de Console et le script dans Prompt. Vous pouvez aussi joindre une capture d’écran de la Console dans l’entrée facultative Image.
4. Réglez l’Effort. La valeur par défaut est low, qui désactive la réflexion étendue pour une réponse plus rapide et moins chère. Utilisez high lorsqu’un bug couvre plusieurs scripts, et max pour les problèmes récalcitrants.
5. Laissez Max Tokens à la valeur par défaut de 8 192, sauf si un long script est coupé.
6. Copiez la sortie dans Unity, ou collez-la dans Claude Code comme spécification de ce qu’il faut construire.

💡 Par défaut, l’entrée image réduit les images à 0,5 mégapixel. Si le texte de la Console paraît flou dans la réponse, recadrez la capture sur les lignes d’erreur au lieu d’envoyer la fenêtre entière.

Vous préférez un autre modèle ? Claude Opus 4.7, Claude 4.5 Haiku et Claude Fable 5 figurent tous dans la même collection de grands modèles de langage.

Créez vos propres visuels de jeu

Vous disposez désormais d’un chemin fonctionnel, de la phrase tapée dans un terminal à une scène modifiée, ainsi que d’une vue claire du coût de chaque étape. La moitié manquante, c’est l’art qui remplit la scène.

Ouvrez Picasso IA et essayez-le sur votre propre projet. Commencez par un accessoire que vous repoussez sans cesse, rédigez un court prompt pour lui dans Seedream 4.5, comparez-le avec le même prompt dans Qwen Image 3, et gardez celui qui s’intègre à votre scène. Laissez ensuite votre serveur MCP pour Unity le placer. Parcourez la liste complète sur picassoia.com/en/all-models et lancez quelques expériences avant votre prochain build.