Agentes MCP

O MCP permite que o Codex, o Claude Code ou a Antigravity CLI utilizem as ferramentas do DR-Terminal. Um agente pode inspecionar sessões e ligações guardadas, abrir uma ligação, ler a saída do terminal, escrever comandos, transferir ficheiros e navegar na aplicação. O Modo MCP está disponível durante um período de teste 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. É criada uma entrada dr-terminal ao nível do utilizador que executa o bridge incluído no DR-Terminal; nenhum token ou endpoint fica guardado na configuração do cliente. O Antigravity 2.0, o Antigravity IDE e o agy partilham esta entrada em ~/.gemini/config/mcp_config.json.
  3. Escolha Abrir ou abra o cliente normalmente. A primeira ligação traz o DR-Terminal para primeiro plano e pede que escolha Allow ou Recusar.
  4. Depois de permitir a ligação, cole o primeiro prompt e envie-o.
Mostra as minhas sessões ativas do DR-Terminal.

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

Prompts úteis

Utilize um nome ou identificador de sessão quando estiver aberta mais do que uma sessão. Se um agente indicar que não existe nenhuma sessão, abra uma ligação no DR-Terminal ou peça primeiro ao agente que liste as ligações guardadas.

Aprovações e indicadores

A leitura dos metadados da sessão e da saída do terminal normalmente não interrompe o seu trabalho. As ações sensíveis — escrever, premir teclas, transferir ficheiros e desligar — exigem a sua aprovação.

Quando é necessária uma aprovação, o chip MCP pulsa e a caixa de diálogo de confirmação recebe o foco do teclado. Reveja a sessão de destino e o conteúdo, e escolha Permitir uma vez, Permitir nesta sessão ou Recusar. O separador da sessão afetada apresenta um marcador MCP estático enquanto uma ação decorre; a cor do chip mostra o estado global do MCP.

O agente nunca recebe palavras-passe nem chaves privadas guardadas pelo DR-Terminal. Uma aprovação para uma sessão só se aplica enquanto a execução atual do servidor MCP permanecer ativa.

Segurança da ligação local

O servidor MCP escuta apenas na interface de loopback, pelo que não fica exposto à rede. Cada pedido exige, ainda assim, um token bearer guardado num ficheiro local acessível apenas ao proprietário. O popover da barra de título nunca mostra nem copia esse token.

O endpoint é mostrado apenas em Endpoint e ações recentes, para diagnóstico. Não partilhe o ficheiro do token nem copie o seu conteúdo para prompts, mensagens de chat, registos ou capturas de ecrã.

Parar o MCP

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

Clicar no emblema MCP apenas abre o popover. Nunca inicia o servidor implicitamente. Utilize a ação explícita Start MCP para uma execução manual; um cliente registado também o pode iniciar através do fluxo visível de aprovação da ligação.

Resolução de problemas

CLI não encontrada

Instale a CLI escolhida — Codex, Claude Code ou Antigravity (agy) — e certifique-se de que o respetivo executável está disponível no PATH. Reinicie o DR-Terminal depois de alterar o ambiente da shell e escolha depois Verificar novamente.

A porta já está em uso

Outro processo está a usar a porta MCP configurada. Pare esse processo ou selecione outra porta em Definições → Modo MCP, e inicie o MCP novamente.

Nenhuma sessão ativa

Abra primeiro uma sessão SSH, Telnet, série ou de terminal local. Também pode pedir ao agente que mostre as ligações guardadas e abra uma delas depois de aprovar a ação.

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

O processo da CLI arrancou, mas o DR-Terminal ainda não recebeu nenhuma chamada de ferramenta MCP. Verifique no novo separador do terminal se há erros de login, configuração ou handshake. Depois envie de novo o prompt de exemplo. Em execução descreve o processo local, não uma ligação MCP confirmada.

Uma caixa de diálogo de aprovação está à espera

Volte ao DR-Terminal e reveja a caixa de diálogo com o foco. O agente não pode continuar essa ação sensível até que a permita ou recuse. Parar o MCP recusa o pedido pendente.

Previous
Telnet