Agentes MCP

O MCP permite que o Codex, o Claude Code ou a Antigravity CLI usem as ferramentas do DR-Terminal. Um agente pode inspecionar sessões e conexões salvas, abrir uma conexão, ler a saída do terminal, digitar comandos, transferir arquivos e navegar pelo aplicativo. O Modo MCP está disponível durante um período de avaliação ativo e com o Pro.

Adicionar o DR-Terminal a um agente

  1. Clique em MCP na barra de título do DR-Terminal.
  2. Escolha Add to Codex, Add to Claude ou Add to Antigravity. Isso cria uma entrada dr-terminal no nível do usuário que executa o bridge empacotado do DR-Terminal; nenhum token ou endpoint é armazenado na configuração do cliente. O Antigravity 2.0, o Antigravity IDE e o agy compartilham essa entrada em ~/.gemini/config/mcp_config.json.
  3. Escolha Abrir ou abra o cliente normalmente. A primeira conexão traz o DR-Terminal para a frente e pede que você escolha Allow ou Negar.
  4. Depois de permitir a conexão, cole o primeiro prompt e envie-o.
Mostre minhas sessões ativas do DR-Terminal.

A CLI selecionada precisa estar instalada e disponível no PATH. A instalação é suportada a partir de um pacote instalado do DR-Terminal; execuções de desenvolvimento a partir do Gradle ou de uma IDE deliberadamente não criam uma entrada persistente. Remove exclui apenas uma entrada que pertence exatamente ao DR-Terminal e pede confirmação. Uma entrada dr-terminal diferente já existente é reportada como conflito e nunca é sobrescrita.

Prompts úteis

Use um nome ou identificador de sessão quando mais de uma sessão estiver aberta. Se um agente informar que nenhuma sessão existe, abra uma conexão no DR-Terminal ou peça ao agente para listar primeiro as conexões salvas.

Aprovações e indicadores

Ler metadados de sessão e a saída do terminal normalmente não interrompe seu trabalho. Ações sensíveis, como digitar, pressionar teclas, transferir arquivos e desconectar, exigem sua aprovação.

Quando uma aprovação é necessária, o chip MCP pulsa e o diálogo de confirmação recebe o foco do teclado. Revise a sessão de destino e o payload, e então escolha Permitir uma vez, Permitir nesta sessão ou Negar. A aba da sessão afetada exibe um marcador MCP estático enquanto uma ação está em andamento; a cor do chip mostra o estado global do MCP.

O agente nunca recebe senhas ou chaves privadas salvas pelo DR-Terminal. A aprovação para uma sessão vale apenas enquanto a execução atual do servidor MCP permanecer ativa.

Segurança da conexão local

O servidor MCP escuta apenas na interface de loopback, portanto não fica exposto à rede. Toda requisição ainda exige um token bearer armazenado em um arquivo local acessível somente ao proprietário. O popover da barra de título nunca exibe nem copia esse token.

O endpoint é mostrado apenas em Endpoint e ações recentes, para fins de diagnóstico. Não compartilhe o arquivo do token nem copie seu conteúdo para prompts, mensagens de chat, logs ou capturas de tela.

Parar o MCP

Escolha Parar no popover do MCP para rejeitar qualquer aprovação pendente, parar de aceitar chamadas de ferramentas e fechar os clientes iniciados pela execução atual do MCP. Iniciar o MCP novamente cria uma execução nova; as aprovações de sessão anteriores não são mantidas.

Clicar no badge do MCP apenas abre o popover. Ele nunca inicia o servidor implicitamente. Use a ação explícita Start MCP para um início manual; um cliente registrado também pode iniciá-lo por meio do fluxo visível de aprovação de conexão.

Solução de problemas

CLI não encontrada

Instale a CLI escolhida — Codex, Claude Code ou Antigravity (agy) — e verifique se o executável dela está disponível no PATH. Reinicie o DR-Terminal depois de alterar o ambiente do seu shell e então escolha Verificar novamente.

Porta já em uso

Outro processo está usando a porta MCP configurada. Encerre esse processo ou selecione outra porta em Configurações → Modo MCP e então inicie o MCP novamente.

Nenhuma sessão ativa

Abra primeiro uma sessão SSH, Telnet, serial ou de terminal local. Você também pode pedir ao agente para mostrar as conexões salvas e abrir uma delas depois que você aprovar a ação.

O cliente está em execução, mas o MCP não está confirmado

O processo da CLI foi iniciado, mas o DR-Terminal ainda não recebeu uma chamada de ferramenta MCP. Verifique na nova aba do terminal erros de login, configuração ou handshake. Depois envie o prompt de exemplo novamente. A indicação está em execução descreve o processo local, não uma conexão MCP confirmada.

Um diálogo de aprovação está aguardando

Volte ao DR-Terminal e revise o diálogo em foco. O agente não pode continuar essa ação sensível até que você a permita ou negue. Parar o MCP nega a solicitação pendente.

Previous
Telnet