Agenti MCP

MCP consente a Codex, Claude Code o Antigravity CLI di usare gli strumenti di DR-Terminal. Un agente può ispezionare le sessioni e le connessioni salvate, aprire una connessione, leggere l'output del terminale, digitare comandi, trasferire file e navigare nell'app. La Modalità MCP è disponibile durante un periodo di prova attivo e con Pro.

Aggiungere DR-Terminal a un agente

1. Fai clic su MCP nella barra del titolo di DR-Terminal.
2. Scegli Add to Codex, Add to Claude o Add to Antigravity. Viene creata una voce dr-terminal a livello utente che esegue il bridge del pacchetto DR-Terminal installato; nella configurazione del client non viene salvato alcun token né endpoint. Antigravity 2.0, Antigravity IDE e agy condividono questa voce in ~/.gemini/config/mcp_config.json.
3. Scegli Apri oppure apri il client normalmente. La prima connessione porta in primo piano DR-Terminal e ti chiede di scegliere Allow o Nega.
4. Dopo aver consentito la connessione, incolla il primo prompt e invialo.

Mostra le mie sessioni DR-Terminal attive.

Il CLI selezionato deve essere installato e disponibile nel PATH. L'installazione è supportata da un pacchetto DR-Terminal installato; le esecuzioni di sviluppo da Gradle o da un IDE deliberatamente non creano una voce persistente. Remove elimina solo una voce riconosciuta esattamente come appartenente a DR-Terminal e chiede conferma. Una voce dr-terminal diversa già esistente viene segnalata come conflitto e non viene mai sovrascritta.

Prompt utili

• Mostra le mie sessioni DR-Terminal attive.
• Mostra le mie connessioni salvate e chiedimi quale aprire.
• Leggi l'ultimo output del terminale dalla sessione chiamata server.
• Digita uptime nella sessione chiamata server.
• Scarica /var/log/app.log dalla sessione chiamata server.

Usa un nome o un identificatore di sessione quando è aperta più di una sessione. Se un agente segnala che non esiste alcuna sessione, apri una connessione in DR-Terminal oppure chiedi prima all'agente di elencare le connessioni salvate.

Approvazioni e indicatori

Leggere i metadati delle sessioni e l'output del terminale di norma non interrompe il tuo lavoro. Le azioni sensibili come digitare, premere tasti, trasferire file e disconnettere richiedono la tua approvazione.

Quando serve un'approvazione, il chip MCP pulsa e la finestra di conferma riceve il focus della tastiera. Controlla la sessione di destinazione e il payload, poi scegli Consenti una volta, Consenti per questa sessione o Nega. La scheda della sessione interessata mostra un contrassegno MCP statico mentre un'azione è in corso; il colore del chip indica lo stato MCP globale.

L'agente non riceve mai le password o le chiavi private salvate da DR-Terminal. L'approvazione per una sessione vale solo finché resta attiva l'esecuzione corrente del server MCP.

Sicurezza della connessione locale

Il server MCP è in ascolto solo sull'interfaccia di loopback, quindi non è esposto alla rete. Ogni richiesta richiede comunque un token bearer conservato in un file locale accessibile solo al proprietario. Il popover della barra del titolo non mostra né copia mai quel token.

L'endpoint è mostrato solo sotto Endpoint e azioni recenti a scopo diagnostico. Non condividere il file del token e non copiarne il contenuto in prompt, messaggi di chat, log o screenshot.

Fermare MCP

Scegli Ferma nel popover MCP per rifiutare qualsiasi approvazione in sospeso, smettere di accettare chiamate agli strumenti e chiudere i client avviati dall'esecuzione MCP corrente. Riavviare MCP crea una nuova esecuzione; le approvazioni delle sessioni precedenti non vengono ereditate.

Fare clic sul badge MCP apre soltanto il popover. Non avvia mai il server in modo implicito. Per un avvio manuale usa l'azione esplicita Start MCP; anche un client registrato può avviarlo tramite il flusso visibile di approvazione della connessione.

Risoluzione dei problemi

CLI non trovato

Installa il CLI selezionato tra Codex, Claude Code o Antigravity (agy) e assicurati che il suo eseguibile sia disponibile nel PATH. Riavvia DR-Terminal dopo aver modificato l'ambiente della shell, poi scegli Controlla di nuovo.

Porta già in uso

Un altro processo sta usando la porta MCP configurata. Ferma quel processo oppure seleziona un'altra porta in Impostazioni → Modalità MCP, poi avvia di nuovo MCP.

Nessuna sessione attiva

Apri prima una sessione SSH, Telnet, seriale o di terminale locale. Puoi anche chiedere all'agente di mostrare le connessioni salvate e di aprirne una dopo la tua approvazione.

Il client è in esecuzione ma MCP non è confermato

Il processo CLI è partito, ma DR-Terminal non ha ancora ricevuto una chiamata a uno strumento MCP. Controlla nella nuova scheda del terminale eventuali errori di login, configurazione o handshake. Poi invia di nuovo il prompt di esempio. Lo stato in esecuzione descrive il processo locale, non una connessione MCP confermata.

Una finestra di approvazione è in attesa

Torna a DR-Terminal e controlla la finestra di dialogo con il focus. L'agente non può proseguire con quell'azione sensibile finché non la consenti o la neghi. Fermare MCP rifiuta la richiesta in sospeso.