Claude Code peut connecter un serveur MCP en périmètre local, utilisateur ou projet. Pour une configuration de projet, le fichier .mcp.json se trouve à la racine du projet et Claude Code demande une approbation dans les sessions interactives avant d’utiliser le serveur. PhotoCraft ajoute une précaution concrète : si une opération par lot échoue, les étapes déjà réussies restent appliquées.
Choisir le bon périmètre MCP dans Claude Code
MCP, pour Model Context Protocol, est un protocole qui permet à Claude Code de se connecter à des outils externes. Le périmètre détermine où s’applique la configuration et qui peut la partager.
| Périmètre | Portée | Emplacement de la configuration | Particularité |
| Local | Projet en cours | ~/.claude.json | Lié au projet courant et privé à l’utilisateur |
| Utilisateur | Tous les projets de l’utilisateur | ~/.claude.json | N’est pas partagé avec l’équipe |
| Projet | Projet en cours | .mcp.json à la racine du projet | Partageable via le contrôle de version ; approbation demandée dans les sessions interactives |
Ces emplacements et règles sont décrits dans la documentation officielle de Claude Code sur MCP. Choisissez le périmètre local pour une configuration liée à votre projet, utilisateur pour la retrouver dans vos différents projets, et projet si la configuration doit être partagée avec l’équipe. Dans ce dernier cas, le partage du fichier ne dispense pas chaque utilisateur de l’approbation demandée par Claude Code.
Ajouter un serveur MCP et vérifier sa connexion
Pour un serveur local utilisant le transport stdio, Claude Code documente cette forme de commande :
claude mcp add [options] <name> -- <command> [args...]
Remplacez les éléments entre chevrons par le nom du serveur, sa commande et ses arguments. Le séparateur -- marque le début de la commande du serveur : tout ce qui le suit lui est transmis. Les CLI Craft et leurs options varient selon l’application, indique le compte rendu publié par pasqualepillitteri.it. Il faut donc reprendre la commande propre à l’application concernée plutôt que supposer qu’elles partagent toutes les mêmes arguments.
Après l’ajout, claude mcp list permet de gérer les serveurs configurés et /mcp d’examiner leur état dans Claude Code. Un message confirmant l’écriture de la configuration ne suffit pas à établir que la connexion fonctionne : vérifiez l’état du serveur dans la session.
Contrôler les résultats et les limites d’accès
Les observations publiées par pasqualepillitteri.it donnent des exemples utiles de vérifications à faire sur les fichiers produits : dans un essai de DeckCraft, un graphique chevauchait le titre d’une diapositive ; avec WordCraft, la lettre créée tenait d’abord sur deux pages. Ces résultats concernent les tâches décrites dans ce compte rendu, pas une mesure générale des performances des applications.
Les restrictions d’un serveur MCP ne s’étendent pas automatiquement aux autres outils de Claude Code. Dans un essai de FilmCraft rapporté par pasqualepillitteri.it, l’outil ne pouvait pas enregistrer une image rendue au chemin demandé ; Claude Code a alors utilisé son outil shell pour la sauvegarder. La documentation de Claude Code recommande par ailleurs de ne connecter que des serveurs auxquels vous faites confiance, notamment parce que des contenus externes peuvent contenir des tentatives d’injection de prompt.
Récupérer après l’échec d’un lot PhotoCraft
La documentation MCP de PhotoCraft précise que les racines de lecture et d’écriture configurées limitent l’accès aux fichiers de PhotoCraft aux chemins situés sous ces racines. Elle indique aussi que command_batch exécute les opérations dans l’ordre sans annuler les étapes déjà réussies si une étape ultérieure échoue.
Après un échec, inspectez l’état du document et son historique avant de relancer l’opération. Annuler des modifications du document ne supprime pas les fichiers déjà écrits sur le disque. Pour vos essais, PhotoCraft recommande de travailler sur un document dupliqué ou d’en créer un nouveau.
