Configuration MCP : connecter Merlin Project à Claude Desktop

Aujourd'hui, poser une question sur son projet à une IA suppose d'exporter le plan et de téléverser le fichier ; la semaine suivante, le plan a changé et tout recommence. C'est pourquoi Merlin Project embarque un serveur MCP, un petit programme sur votre Mac grâce auquel un client IA lit directement le plan ouvert au lieu de travailler sur une copie. Claude Desktop est la voie la plus confortable, car un bloc dans un fichier de configuration suffit. Cet article parcourt les trois étapes dans l'ordre, de l'installation du serveur à la première question posée à votre plan.

La vidéo de cet article

La vidéo (en allemand) est intégrée à la version allemande de cet article. Elle déroule la configuration sur le projet d'exemple « Produktlaunch Phoenix », un petit lancement de produit avec cinq phases, une vingtaine de tâches et huit ressources. À la fin, Claude interroge le plan sur les jalons atteints et les prochaines échéances, et la réponse provient du projet tel qu'il est ouvert dans Merlin. Les étapes ci-dessous se suffisent à elles-mêmes.

Ce qu'il vous faut

• Merlin Project dans sa version actuelle
• Claude Desktop pour Mac ; un compte Claude gratuit suffit
• un projet ouvert que Claude a le droit de lire

Rien de plus. Ni terminal ni paquets Node, et pas une demi-heure de documentation. MCP signifie Model Context Protocol, un standard ouvert que tous les grands fournisseurs d'IA prennent désormais en charge. Il décrit comment un client IA appelle les outils d'un programme, ici les requêtes en lecture du serveur Merlin.

Étapes 1 et 2 : préparer Merlin Project

1. Installez le serveur. Dans Merlin Project, ouvrez le menu Merlin Project et choisissez Install MCP Server. Merlin dépose un petit programme sur votre Mac, le pont entre le client IA et le plan. L'installateur affiche le chemin ; il s'agit de /usr/local/bin/merlinproject-mcp.
2. Partagez le projet. Ouvrez le projet et cliquez sur AI Tools dans la barre d'outils. Cochez Autoriser les outils d’IA à interagir avec le document ; le symbole s'affiche plein. Le partage ne vaut que pour ce projet, tous les autres restent invisibles pour le serveur. Dès qu'un client est connecté, le symbole passe au bleu.

local · lecture seule · inaccessible à distance. Le serveur ne lit que les projets que vous partagez, ne modifie rien dans vos données, et personne ne l'atteint depuis l'extérieur. Ce qu'un client dans le nuage voit des données lues est expliqué dans l'article sur la protection des données.

Ces deux étapes sont identiques pour tous les clients. Si vous connectez plus tard Claude Code, Codex ou Antigravity, elles seront déjà faites.

Étape 3 : faire connaître le serveur à Claude Desktop

Merlin est prêt, mais Claude ignore encore que ce serveur existe. C'est la seule étape où vous touchez brièvement à un fichier.

1. Dans Claude Desktop, ouvrez Settings puis Developer.
2. Cliquez sur Edit Config. Claude met en évidence le fichier claude_desktop_config.json dans le Finder.
3. Ouvrez le fichier avec un éditeur de texte, TextEdit par exemple.
4. Collez le bloc suivant et enregistrez.

Bloc de configuration pour merlin-project claude_desktop_config.json

{
  "mcpServers": {
    "merlin-project": {
      "command": "/usr/local/bin/merlinproject-mcp"
    }
  }
}

Contentez-vous d'ajouter. Si le fichier contient déjà quelque chose, n'en supprimez rien, sinon Claude perd les autres outils que vous avez configurés. Si une entrée mcpServers existe déjà, n'ajoutez que le bloc intérieur merlin-project.

5. Quittez Claude Desktop complètement (Cmd+Q) et relancez-le. Claude ne lit le fichier de configuration qu'au démarrage.

Après le redémarrage, merlin-project apparaît dans la liste des outils. La connexion tient, et le symbole AI Tools dans Merlin Project passe au bleu dès que Claude lit le plan pour la première fois.

La première question posée à votre plan

Demandez à Claude où en est votre projet. Le prompt de la vidéo figure dans notre bibliothèque de prompts et se copie directement ici :

Prompt: Où en est actuellement mon projet ?

Résume le statut actuel du projet actif. Procède en trois étapes : indique d'abord l'avancement global et la date de fin prévue, puis les derniers jalons atteints, et enfin les prochaines échéances. Mets en évidence ce qui a changé par rapport au planning et limite-toi aux dix points les plus importants.

Voir ce prompt dans la bibliothèque ›

Claude lit les tâches, les jalons et les dates du projet partagé et les résume. Pas d'export, pas de copie, et si vous déplacez une date demain, Claude vous donnera demain la nouvelle réponse. D'autres questions, de la charge des ressources au point pour les parties prenantes, se trouvent dans la bibliothèque de prompts.

Si Claude ne voit pas le serveur

L'erreur la plus fréquente est aussi la plus simple : Claude Desktop n'a pas été quitté complètement après l'enregistrement. Fermer la fenêtre ne suffit pas. Quittez l'application avec Cmd+Q et relancez-la. Trois autres points à vérifier :

• Vérifiez le chemin. L'installateur dans Merlin Project affiche le chemin du serveur. Il doit correspondre exactement à la valeur du bloc de configuration.
• Vérifiez le JSON. Une virgule ou une accolade manquante suffit pour que Claude ignore tout le fichier. Copiez le bloc depuis cette page au lieu de le saisir.
• Vérifiez le partage. Le projet est-il partagé via « AI Tools » ? Le serveur ne lit que les projets dont l'accès est activé. Un serveur installé sans projet partagé répond par une liste vide.

La liste de contrôle

Pour s'exercer : le projet d'exemple

Si vous voulez d'abord vous exercer sans projet à vous, téléchargez Produktlaunch Phoenix, le projet d'exemple de la vidéo. Il est déjà en cours, les premières phases sont terminées, et Claude y trouve jalons et échéances, exactement comme dans la vidéo.

Les autres clients

Claude Desktop est l'entrée la plus confortable. Si vous travaillez dans un éditeur ou dans le terminal, ou si vos données ne doivent pas quitter le Mac, le guide correspondant est ici :

• Claude Desktop (cet article): Un bloc dans un fichier, redémarrage
• LM Studio: Télécharger un modèle, un bloc dans un fichier
• Claude Code: Une commande
• Codex: Une commande
• Antigravity: Un bloc dans un fichier, redémarrage complet
• ChatGPT: Pont de copie ou Assistant Intelligent
• Quel client IA vous convient ?

La référence complète de tous les clients se trouve dans la documentation MCP.

Si vous avez des questions sur cet article de blog ou si vous souhaitez en discuter, nous attendons avec impatience votre contribution dans notre forum.