MCP-agents

MCP laat Codex, Claude Code of Antigravity CLI de tools van DR-Terminal gebruiken. Een agent kan sessies en opgeslagen verbindingen inspecteren, een verbinding openen, terminaluitvoer lezen, opdrachten typen, bestanden overdragen en door de app navigeren. MCP-modus is beschikbaar tijdens een actieve proefperiode en met Pro.

DR-Terminal aan een agent toevoegen

1. Klik op MCP in de titelbalk van DR-Terminal.
2. Kies Add to Codex, Add to Claude of Add to Antigravity. Dit maakt op gebruikersniveau een dr-terminal-vermelding aan die de meegeleverde DR-Terminal-bridge start; er wordt geen token of endpoint in de clientconfiguratie opgeslagen. Antigravity 2.0, Antigravity IDE en agy delen deze vermelding in ~/.gemini/config/mcp_config.json.
3. Kies Openen of open de client op de gewone manier. Bij de eerste verbinding komt DR-Terminal naar voren en vraagt het je om Allow of Weigeren.
4. Plak na het toestaan van de verbinding de eerste prompt en verstuur die.

Toon mijn actieve DR-Terminal-sessies.

De gekozen CLI moet geïnstalleerd zijn en beschikbaar in PATH. Installatie wordt ondersteund vanuit een geïnstalleerd DR-Terminal-pakket; ontwikkelruns vanuit Gradle of een IDE maken bewust geen permanente vermelding aan. Remove verwijdert alleen een vermelding die exact van DR-Terminal is en vraagt om bevestiging. Een andere bestaande dr-terminal-vermelding wordt als conflict gemeld en nooit overschreven.

Handige prompts

• Toon mijn actieve DR-Terminal-sessies.
• Toon mijn opgeslagen verbindingen en vraag welke ik wil openen.
• Lees de nieuwste terminaluitvoer uit de sessie met de naam server.
• Typ uptime in de sessie met de naam server.
• Download /var/log/app.log uit de sessie met de naam server.

Gebruik een sessienaam of -id wanneer er meer dan één sessie open is. Als een agent meldt dat er geen sessie bestaat, open dan een verbinding in DR-Terminal of vraag de agent eerst de opgeslagen verbindingen te tonen.

Goedkeuringen en indicatoren

Het lezen van sessiemetadata en terminaluitvoer onderbreekt je werk normaal gesproken niet. Gevoelige acties zoals typen, toetsen indrukken, bestanden overdragen en de verbinding verbreken vereisen jouw goedkeuring.

Wanneer goedkeuring nodig is, pulseert de MCP-chip en krijgt de bevestigingsdialoog de toetsenbordfocus. Bekijk de doelsessie en de payload, en kies dan Eén keer toestaan, Toestaan voor deze sessie of Weigeren. Het tabblad van de betrokken sessie draagt een statische MCP-markering zolang een actie loopt; de kleur van de chip toont de globale MCP-status.

De agent ontvangt nooit wachtwoorden of privésleutels die door DR-Terminal zijn opgeslagen. Een goedkeuring voor een sessie geldt alleen zolang de huidige MCP-serverrun actief blijft.

Beveiliging van de lokale verbinding

De MCP-server luistert alleen op de loopback-interface en is dus niet blootgesteld aan het netwerk. Elk verzoek vereist toch een bearer-token dat in een lokaal bestand staat dat alleen voor de eigenaar toegankelijk is. De popover in de titelbalk toont of kopieert dat token nooit.

Het endpoint wordt alleen getoond onder Endpoint en recente acties, voor diagnostiek. Deel het tokenbestand niet en kopieer de inhoud ervan niet naar prompts, chatberichten, logs of schermafbeeldingen.

MCP stoppen

Kies Stoppen in de MCP-popover om een wachtende goedkeuring af te wijzen, geen toolaanroepen meer te accepteren en clients te sluiten die door de huidige MCP-run zijn gestart. MCP opnieuw starten maakt een verse run aan; eerdere sessiegoedkeuringen gaan niet mee.

Klikken op de MCP-badge opent alleen de popover. Het start de server nooit impliciet. Gebruik de expliciete actie Start MCP voor een handmatige run; een geregistreerde client kan de server ook starten via de zichtbare goedkeuringsflow voor de verbinding.

Problemen oplossen

CLI niet gevonden

Installeer de gekozen Codex-, Claude Code- of Antigravity-CLI (agy) en zorg dat het uitvoerbare bestand beschikbaar is in PATH. Herstart DR-Terminal nadat je je shell-omgeving hebt gewijzigd en kies daarna Opnieuw controleren.

Poort is al in gebruik

Een ander proces gebruikt de geconfigureerde MCP-poort. Stop dat proces of kies een andere poort onder Instellingen → MCP-modus, en start MCP daarna opnieuw.

Geen actieve sessie

Open eerst een SSH-, Telnet-, seriële of lokale terminalsessie. Je kunt de agent ook vragen de opgeslagen verbindingen te tonen en er een te openen nadat je de actie hebt goedgekeurd.

Client draait, maar MCP is niet bevestigd

Het CLI-proces is gestart, maar DR-Terminal heeft nog geen MCP-toolaanroep ontvangen. Controleer het nieuwe terminaltabblad op fouten bij aanmelding, configuratie of handshake. Verstuur daarna de voorbeeldprompt opnieuw. Wordt uitgevoerd beschrijft het lokale proces, niet een bevestigde MCP-verbinding.

Er wacht een goedkeuringsdialoog

Keer terug naar DR-Terminal en bekijk de dialoog met focus. De agent kan die gevoelige actie niet voortzetten totdat je die toestaat of weigert. MCP stoppen wijst het wachtende verzoek af.