Agentes MCP

MCP permite que Codex, Claude Code o la CLI de Antigravity usen las herramientas de DR-Terminal. Un agente puede inspeccionar sesiones y conexiones guardadas, abrir una conexión, leer la salida de la terminal, escribir comandos, transferir archivos y navegar por la aplicación. El Modo MCP está disponible durante una prueba activa y con Pro.

Añadir DR-Terminal a un agente

1. Haz clic en MCP en la barra de título de DR-Terminal.
2. Elige Add to Codex, Add to Claude o Add to Antigravity. Esto crea una entrada dr-terminal a nivel de usuario que ejecuta el bridge incluido con DR-Terminal; en la configuración del cliente no se guarda ningún token ni endpoint. Antigravity 2.0, Antigravity IDE y agy comparten esta entrada en ~/.gemini/config/mcp_config.json.
3. Elige Abrir o abre el cliente normalmente. La primera conexión trae DR-Terminal al frente y te pide permitirla con Allow o rechazarla con Denegar.
4. Después de permitir la conexión, pega el primer prompt y envíalo.

Muestra mis sesiones activas de DR-Terminal.

La CLI elegida debe estar instalada y disponible en PATH. La instalación se admite desde un paquete instalado de DR-Terminal; las ejecuciones de desarrollo desde Gradle o un IDE deliberadamente no crean una entrada persistente. Remove elimina solo una entrada que pertenece exactamente a DR-Terminal y pide confirmación. Una entrada dr-terminal distinta ya existente se notifica como conflicto y nunca se sobrescribe.

Prompts útiles

• Muestra mis sesiones activas de DR-Terminal.
• Muestra mis conexiones guardadas y pregúntame cuál abrir.
• Lee la última salida de la terminal de la sesión llamada server.
• Escribe uptime en la sesión llamada server.
• Descarga /var/log/app.log de la sesión llamada server.

Usa un nombre o identificador de sesión cuando haya más de una sesión abierta. Si un agente informa de que no existe ninguna sesión, abre una conexión en DR-Terminal o pide al agente que primero liste las conexiones guardadas.

Aprobaciones e indicadores

Leer metadatos de sesión y la salida de la terminal normalmente no interrumpe tu trabajo. Las acciones sensibles, como escribir, pulsar teclas, transferir archivos y desconectar, requieren tu aprobación.

Cuando se necesita aprobación, el chip MCP pulsa y el diálogo de confirmación recibe el foco del teclado. Revisa la sesión de destino y el payload, y luego elige Permitir una vez, Permitir en esta sesión o Denegar. La pestaña de la sesión afectada muestra un marcador MCP estático mientras se ejecuta una acción; el color del chip indica el estado global de MCP.

El agente nunca recibe contraseñas ni claves privadas guardadas por DR-Terminal. La aprobación de una sesión se aplica solo mientras la ejecución actual del servidor MCP siga activa.

Seguridad de la conexión local

El servidor MCP escucha solo en la interfaz de loopback, por lo que no está expuesto a la red. Cada solicitud sigue requiriendo un token bearer guardado en un archivo local accesible solo para el propietario. El popover de la barra de título nunca muestra ni copia ese token.

El endpoint se muestra únicamente bajo Endpoint y acciones recientes con fines de diagnóstico. No compartas el archivo del token ni copies su contenido en prompts, mensajes de chat, registros o capturas de pantalla.

Detener MCP

Elige Detener en el popover de MCP para rechazar cualquier aprobación pendiente, dejar de aceptar llamadas a herramientas y cerrar los clientes lanzados por la ejecución actual de MCP. Iniciar MCP de nuevo crea una ejecución nueva; las aprobaciones de sesión anteriores no se conservan.

Hacer clic en la insignia MCP solo abre el popover. Nunca inicia el servidor de forma implícita. Usa la acción explícita Start MCP para un inicio manual; un cliente registrado también puede iniciarlo a través del flujo visible de aprobación de la conexión.

Solución de problemas

CLI no encontrada

Instala la CLI elegida de Codex, Claude Code o Antigravity (agy) y asegúrate de que su ejecutable esté disponible en PATH. Reinicia DR-Terminal tras cambiar el entorno de tu shell y luego elige Comprobar de nuevo.

El puerto ya está en uso

Otro proceso está usando el puerto MCP configurado. Detén ese proceso o selecciona otro puerto en Ajustes → Modo MCP, y luego inicia MCP de nuevo.

No hay ninguna sesión activa

Abre primero una sesión SSH, Telnet, serie o de terminal local. También puedes pedir al agente que muestre las conexiones guardadas y abra una después de que apruebes la acción.

El cliente está en ejecución pero MCP no está confirmado

El proceso de la CLI se inició, pero DR-Terminal aún no ha recibido ninguna llamada a herramientas MCP. Comprueba en la nueva pestaña de terminal si hay errores de inicio de sesión, configuración o handshake. Luego envía el prompt de ejemplo otra vez. En ejecución describe el proceso local, no una conexión MCP confirmada.

Un diálogo de aprobación está esperando

Vuelve a DR-Terminal y revisa el diálogo con el foco. El agente no puede continuar esa acción sensible hasta que la permitas o la deniegues. Detener MCP deniega la solicitud pendiente.