Agents MCP

MCP permet à Codex, Claude Code ou la CLI Antigravity d'utiliser les outils de DR-Terminal. Un agent peut inspecter les sessions et les connexions enregistrées, ouvrir une connexion, lire la sortie du terminal, taper des commandes, transférer des fichiers et naviguer dans l'application. Le Mode MCP est disponible pendant un essai actif et avec Pro.

Ajouter DR-Terminal à un agent

1. Cliquez sur MCP dans la barre de titre de DR-Terminal.
2. Choisissez Add to Codex, Add to Claude ou Add to Antigravity. Cela crée une entrée dr-terminal au niveau utilisateur qui lance le bridge livré avec DR-Terminal ; aucun token ni endpoint n'est stocké dans la configuration du client. Antigravity 2.0, Antigravity IDE et agy partagent cette entrée dans ~/.gemini/config/mcp_config.json.
3. Choisissez Ouvrir ou ouvrez le client normalement. La première connexion fait passer DR-Terminal au premier plan et vous demande de l'autoriser avec Allow ou de la refuser avec Refuser.
4. Après avoir autorisé la connexion, collez le premier prompt et envoyez-le.

Affiche mes sessions DR-Terminal actives.

La CLI choisie doit être installée et disponible dans le PATH. L'installation est prise en charge depuis un paquet DR-Terminal installé ; les exécutions de développement depuis Gradle ou un IDE ne créent délibérément pas d'entrée persistante. Remove ne supprime qu'une entrée appartenant exactement à DR-Terminal et demande confirmation. Une entrée dr-terminal différente déjà présente est signalée comme un conflit et n'est jamais écrasée.

Prompts utiles

• Affiche mes sessions DR-Terminal actives.
• Affiche mes connexions enregistrées et demande-moi laquelle ouvrir.
• Lis la dernière sortie du terminal de la session nommée server.
• Tape uptime dans la session nommée server.
• Télécharge /var/log/app.log depuis la session nommée server.

Utilisez un nom ou un identifiant de session lorsque plusieurs sessions sont ouvertes. Si un agent signale qu'aucune session n'existe, ouvrez une connexion dans DR-Terminal ou demandez-lui d'abord de lister les connexions enregistrées.

Approbations et indicateurs

La lecture des métadonnées de session et de la sortie du terminal n'interrompt normalement pas votre travail. Les actions sensibles telles que la saisie, l'appui sur des touches, le transfert de fichiers et la déconnexion requièrent votre approbation.

Lorsqu'une approbation est nécessaire, la puce MCP pulse et la boîte de dialogue de confirmation reçoit le focus clavier. Vérifiez la session cible et le payload, puis choisissez Autoriser une fois, Autoriser pour cette session ou Refuser. L'onglet de la session concernée porte un marqueur MCP statique pendant qu'une action s'exécute ; la couleur de la puce reflète l'état global de MCP.

L'agent ne reçoit jamais les mots de passe ni les clés privées enregistrés par DR-Terminal. L'approbation d'une session ne vaut que tant que l'exécution en cours du serveur MCP reste active.

Sécurité de la connexion locale

Le serveur MCP n'écoute que sur l'interface de loopback ; il n'est donc pas exposé au réseau. Chaque requête exige néanmoins un token bearer stocké dans un fichier local accessible au seul propriétaire. Le popover de la barre de titre n'affiche ni ne copie jamais ce token.

L'endpoint n'apparaît que sous Endpoint et actions récentes, à des fins de diagnostic. Ne partagez pas le fichier du token et ne copiez pas son contenu dans des prompts, des messages de chat, des journaux ou des captures d'écran.

Arrêter MCP

Choisissez Arrêter dans le popover MCP pour rejeter toute approbation en attente, cesser d'accepter les appels d'outils et fermer les clients lancés par l'exécution MCP en cours. Redémarrer MCP crée une exécution neuve ; les approbations de session précédentes ne sont pas reprises.

Cliquer sur le badge MCP ne fait qu'ouvrir le popover. Cela ne démarre jamais le serveur implicitement. Utilisez l'action explicite Start MCP pour un démarrage manuel ; un client enregistré peut aussi le démarrer via le flux visible d'approbation de la connexion.

Dépannage

CLI introuvable

Installez la CLI choisie — Codex, Claude Code ou Antigravity (agy) — et assurez-vous que son exécutable est disponible dans le PATH. Redémarrez DR-Terminal après avoir modifié l'environnement de votre shell, puis choisissez Vérifier à nouveau.

Port déjà utilisé

Un autre processus utilise le port MCP configuré. Arrêtez ce processus ou sélectionnez un autre port sous Paramètres → Mode MCP, puis démarrez MCP à nouveau.

Aucune session active

Ouvrez d'abord une session SSH, Telnet, série ou de terminal local. Vous pouvez aussi demander à l'agent d'afficher les connexions enregistrées et d'en ouvrir une après votre approbation de l'action.

Le client tourne mais MCP n'est pas confirmé

Le processus de la CLI a démarré, mais DR-Terminal n'a pas encore reçu d'appel d'outil MCP. Vérifiez dans le nouvel onglet de terminal les erreurs de connexion, de configuration ou de handshake. Puis renvoyez le prompt d'exemple. En cours d’exécution décrit le processus local, pas une connexion MCP confirmée.

Une boîte de dialogue d'approbation attend

Revenez dans DR-Terminal et examinez la boîte de dialogue qui a le focus. L'agent ne peut pas poursuivre cette action sensible tant que vous ne l'avez pas autorisée ou refusée. Arrêter MCP refuse la demande en attente.