Serveurs MCP dans Moon CLI

Un serveur MCP ajoute des outils à l’agent : interroger un service, piloter une application de votre ordinateur, lire une documentation. Dans Moon CLI, vous les ajoutez depuis l’agent, depuis le terminal ou dans un fichier de configuration.

Ajouter un serveur depuis l’agent#Lien vers la section Ajouter un serveur depuis l’agent

1. Dans l’agent, tapez /mcp. La fenêtre « Serveurs MCP » liste vos « Serveurs configurés » avec leur état.
2. Dans « Ajouter », choisissez « Ajouter depuis le catalogue » ou « Ajouter un serveur personnalisé (URL ou commande) ».
3. Si le serveur demande une connexion à votre compte du service, la page de connexion s’ouvre dans votre navigateur.
4. Le serveur se connecte tout de suite, sans redémarrer Moon CLI.

Catalogue#Lien vers la section Catalogue

Serveur personnalisé#Lien vers la section Serveur personnalisé

1. Choisissez « Ajouter un serveur personnalisé (URL ou commande) ».
2. Saisissez le « Nom du serveur MCP » : lettres, chiffres et tirets. Les outils du serveur s’appelleront <nom>_<outil>.
3. Saisissez l’adresse du serveur (https://…) ou la commande qui le lance (par exemple npx -y @org/serveur-mcp).

Gérer un serveur#Lien vers la section Gérer un serveur

Sélectionnez un serveur dans la liste de /mcp :

Les serveurs déclarés ailleurs que dans votre configuration personnelle (dans un projet, par exemple) portent la mention « non modifiable ici ».

/mcps active ou désactive vos serveurs, et /status affiche leur état.

Se connecter quand le navigateur ne s’ouvre pas#Lien vers la section Se connecter quand le navigateur ne s’ouvre pas

Sous WSL, en SSH ou sur un serveur sans écran, la fenêtre de connexion affiche le lien dès qu’il est prêt.

Si le serveur ne répond pas, Moon CLI abandonne au bout de 30 secondes et dit pourquoi. La fenêtre affiche le temps écoulé.

Depuis le terminal#Lien vers la section Depuis le terminal

moon mcp list
moon mcp add context7 --url https://mcp.context7.com/mcp
moon mcp auth linear

Déclarer un serveur dans un fichier#Lien vers la section Déclarer un serveur dans un fichier

Un serveur se déclare aussi sous la clé mcp de la configuration de l’agent :

• dans votre configuration personnelle, ~/.config/moon/opencode.json (Windows : %USERPROFILE%\.config\moon\opencode.json), pour tous vos projets. C’est là que /mcp écrit ;
• dans le fichier opencode.json d’un projet, pour ce projet seulement. Moon CLI ne le charge qu’après votre accord : voir Configuration d’un dépôt.

Serveur qui tourne sur votre ordinateur :

{
  "mcp": {
    "mon-serveur": {
      "type": "local",
      "command": ["npx", "-y", "nom-du-paquet-mcp"],
      "enabled": true
    }
  }
}

Serveur distant avec un jeton lu dans une variable d’environnement :

{
  "mcp": {
    "mon-service": {
      "type": "remote",
      "url": "https://exemple.com/mcp",
      "headers": { "Authorization": "Bearer {env:MON_SERVICE_TOKEN}" },
      "enabled": true
    }
  }
}

Relancez Moon CLI après avoir modifié le fichier, puis tapez /mcp pour vérifier l’état du serveur. Toutes les clés : Serveurs MCP dans la configuration.

Les serveurs MCP de Moon CLI sont distincts de ceux ajoutés dans le chat web (« Connecteurs » › « Serveurs MCP », voir Serveurs MCP).

Confirmation des outils#Lien vers la section Confirmation des outils

Chaque outil d’un serveur MCP demande votre accord avant de s’exécuter, comme une commande. Vous pouvez choisir de toujours l’autoriser. En mode approbation automatique, les outils s’exécutent sans demander : voir Modes de permission.

Pour autoriser d’avance tous les outils d’un serveur dans un projet, ajoutez une règle à la configuration du projet :

{
  "permission": { "context7_*": "allow" }
}

Vos données et les serveurs MCP#Lien vers la section Vos données et les serveurs MCP

• Ce que renvoie un outil passe par Moon Blur avant d’être envoyé au modèle, comme le reste de la conversation.
• Ce que reçoit un outil contient les vraies valeurs : Moon CLI remet en clair les valeurs masquées avant l’appel, pour que l’outil fonctionne. Avec Moon Guard activé, un appel qui enverrait un vrai secret à un outil MCP est bloqué.
• Un serveur local tourne sur votre machine avec vos droits. N’ajoutez que des serveurs dont vous connaissez l’éditeur.
• Un serveur distant reçoit ce que l’agent lui envoie. Vérifiez ce que vous l’autorisez à faire.

Voir aussi#Lien vers la section Voir aussi

• Configuration
• Moon Guard
• Référence des commandes