# Serveurs MCP dans Moon CLI > Donner de nouveaux outils à l’agent avec des serveurs MCP : catalogue vérifié, serveur personnalisé, connexion même sans navigateur et confirmation des outils. 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 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. > [!NOTE] > L’ajout et la suppression rechargent l’agent : une réponse en cours est interrompue. Ajoutez vos serveurs entre deux demandes. ### Catalogue | Serveur | Usage | Connexion | | --- | --- | --- | | Context7 | Documentation à jour des bibliothèques et frameworks. | Aucune. | | GitHub | Dépôts, issues, pull requests. | Jeton GitHub dans la variable `GITHUB_TOKEN`. | | Linear | Tickets, projets et cycles. | Compte du service, dans le navigateur. | | Sentry | Erreurs et performances de vos applications. | Compte du service, dans le navigateur. | | Notion | Pages et bases de données. | Compte du service, dans le navigateur. | | Atlassian | Jira et Confluence. | Compte du service, dans le navigateur. | | Cloudflare docs | Documentation de Cloudflare. | Aucune. | ### 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 `_`. 3. Saisissez l’adresse du serveur (`https://…`) ou la commande qui le lance (par exemple `npx -y @org/serveur-mcp`). ### Gérer un serveur Sélectionnez un serveur dans la liste de `/mcp` : | Action | Effet | | --- | --- | | « Se connecter (navigateur) » | Relance la connexion au compte du service. | | « Connecter », « Déconnecter » | Active ou coupe le serveur. | | « Supprimer » | Retire le serveur de votre configuration personnelle et efface ses identifiants, après confirmation « Supprimer « nom » ? ». | Les serveurs déclarés ailleurs que dans votre configuration personnelle (dans un projet, par exemple) portent la mention « non modifiable ici ». | État | Signification | | --- | --- | | « connecté » | Les outils du serveur sont disponibles. | | « à authentifier » | Le serveur attend votre connexion au compte du service. | | « désactivé » | Le serveur est coupé. | | « erreur » | Le serveur n’a pas pu démarrer ; la raison suit. | | « connexion impossible (client non enregistré) » | Le service n’accepte pas l’enregistrement automatique de Moon CLI. | `/mcps` active ou désactive vos serveurs, et `/status` affiche leur état. ### 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. | Touche | Effet | | --- | --- | | `c` | Copie le lien. Sous WSL, il va dans le presse-papiers de Windows. | | `o` | Rouvre le lien dans le navigateur. | | `v` | Colle l’adresse de la page de retour (`http://127.0.0.1:19876/mcp/oauth/callback?code=…`), quand vous vous êtes connecté avec le navigateur d’une autre machine. Validez avec `Entrée`. | | `Échap` | Annule la connexion. | 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 ```bash title="Terminal" moon mcp list moon mcp add context7 --url https://mcp.context7.com/mcp moon mcp auth linear ``` | Commande | Effet | | --- | --- | | `moon mcp list` | Liste les serveurs et leur état. | | `moon mcp add --url ` | Ajoute un serveur distant ; `--header CLÉ=VALEUR` ajoute un en-tête. | | `moon mcp add -- ` | Ajoute un serveur local ; `--env CLÉ=VALEUR` lui passe une variable. | | `moon mcp auth [nom]` | Connecte un serveur à votre compte du service. | | `moon mcp logout [nom]` | Efface les identifiants enregistrés d’un serveur. | ## 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](https://realmoon.ai/documentation/moon-cli/utiliser/#confiance). Serveur qui tourne sur votre ordinateur : ```json title="opencode.json" { "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 : ```json title="opencode.json" { "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](https://realmoon.ai/documentation/moon-cli/configuration/#mcp). > [!TIP] > **Applications de votre ordinateur** > > Pour Blender, Photoshop, Revit et d’autres applications, Moon AI fournit des blocs prêts à copier : « Connecteurs » › « Serveurs MCP », section « Applications sur votre ordinateur », puis « Configurer avec Moon CLI » sur [chat.realmoon.ai](https://chat.realmoon.ai/connectors?tab=mcp). Voir [Logiciels de votre ordinateur](https://realmoon.ai/documentation/agents/logiciels/). Les serveurs MCP de Moon CLI sont distincts de ceux ajoutés dans le chat web (« Connecteurs » › « Serveurs MCP », voir [Serveurs MCP](https://realmoon.ai/documentation/agents/serveurs-mcp/)). ## 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](https://realmoon.ai/documentation/moon-cli/utiliser/#modes). Pour autoriser d’avance tous les outils d’un serveur dans un projet, ajoutez une règle à la configuration du projet : ```json title="opencode.json du projet" { "permission": { "context7_*": "allow" } } ``` ## 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](https://realmoon.ai/documentation/moon-cli/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 - [Configuration](https://realmoon.ai/documentation/moon-cli/configuration/#mcp) - [Moon Guard](https://realmoon.ai/documentation/moon-cli/moon-guard/) - [Référence des commandes](https://realmoon.ai/documentation/moon-cli/commandes/#agent) --- Documentation Moon AI › Moon CLI › Serveurs MCP. Page : https://realmoon.ai/documentation/moon-cli/serveurs-mcp/. Modifiée le 5 novembre 2026. © 2026 Stellarr Studio SAS. Tous droits réservés. Moon AI, Moon Blur et Stellarr Studio sont des marques déposées à l’INPI.