Agentes · Codex CLI
Dê ao Codex acesso SSH — sem entregar suas chaves.
O Codex executa comandos de shell em um sandbox na sua máquina — dê a ele uma chave em ~/.ssh e ele já consegue sair por ssh, sem limites e sem registro. O Termalin é o caminho mais seguro.
O Codex CLI da OpenAI fala MCP, e o Termalin é um cliente SSH com um servidor MCP integrado. Uma entrada no config.toml e o Codex trabalha de verdade nos seus servidores: executa comandos, lê e grava arquivos, abre as próprias sessões ou entra na sua. O agente nunca recebe suas chaves, e você acompanha cada passo.
Plano Free · 14 dias de teste do Pro · Windows, macOS, Linux e iOS
01 / configuração em 3 passos
Conecte o Codex aos seus servidores em três passos.
O Termalin traz um servidor MCP de verdade — um binário termalin-mcp incluído que dá a um agente acesso SSH e SFTP aos hosts que você escolher, autenticado pelo agente de chaves do app. Veja a lista completa de ferramentas MCP (em inglês).
- 1Escolha os hosts. Instale o Termalin e escolha o que expor em Configurações → Acesso do agente (MCP) — cada host é gravado com autenticação apenas pelo agente, então nenhuma senha vai parar no disco. Aproveite para definir a política de cada host para o agente: total, uma lista de comandos permitidos ou bloqueado.
- 2Registre o servidor. O Codex lê os servidores MCP da seção
mcp_serversde~/.codex/config.toml— aponte uma entrada para o binário:
[mcp_servers.termalin] command = "<path>/termalin-mcp"
Versões recentes do Codex também permitem registrá-lo pela linha de comando — codex mcp add termalin -- <path>/termalin-mcp — e a mesma configuração vale para o Codex na IDE.
- 3Peça algo real. O agente lista seus hosts e começa a trabalhar — acompanhar um log, reiniciar um serviço, verificar o disco, editar uma configuração, fazer deploy.
Prefere a versão longa? Siga o guia completo de configuração do Codex (em inglês).
02 / as próprias sessões — ou a sua
O agente abre as próprias sessões — ou entra na sua.
A maioria dos servidores MCP encapsula uma API. O do Termalin encapsula seus servidores — o agente trabalha neles como você, com sessões, arquivos e túneis de verdade:
- ▸As próprias sessões — o agente abre uma sessão e trabalha nela em segundo plano, uma aba que brilha e que você pode acompanhar. Incluído no plano Free.
- ▸Ou entra na sua — o agente entra em uma sessão que você já tem aberta e trabalha ao seu lado, com a borda brilhando enquanto age. Exige seu consentimento, com uma opção própria.
- ▸O fluxo de trabalho inteiro — comandos avulsos, sessões SSH persistentes que ele pode reutilizar, leitura e gravação por SFTP e encaminhamento de portas: um túnel local até um serviço atrás do servidor, ou um proxy SOCKS.
03 / custódia de chaves e consentimento
As chaves ficam com você. Nada é executado sem consentimento.
O Codex executa comandos de terminal na sua máquina — então, se suas chaves estão desbloqueadas em ~/.ssh ou em um ssh-agent em execução, ssh prod já funciona, e você concedeu acesso total ao servidor sem ter decidido isso. A custódia de chaves do Termalin substitui esse arranjo: o agente pede, o custodiante de chaves autentica. Você desbloqueia uma vez, o Termalin assina em nome do agente e não há arquivo de chave para o agente ler — nada para vazar, e nenhuma chave solta no seu disco para os hosts que merecem proteção. O acesso do agente vem desativado por padrão; permitir que um agente digite nas suas sessões ao vivo é outra opção, separada; e só os hosts que você exporta em Configurações → Acesso do agente (MCP) ficam acessíveis — cada um com o próprio nível de acesso: total, uma lista de comandos permitidos ou bloqueado.
04 / supervisão
Acompanhe cada passo — ao vivo, gravado e no registro.
A grade de monitoramento (watch grid) espelha cada sessão aberta lado a lado como um bloco ao vivo, e as sessões que um agente está conduzindo brilham — para você vê-lo trabalhar em tempo real, em uma frota inteira se for preciso.
- ▸Marcado na gravação — cada comando do agente ganha um marcador verde próprio na linha do tempo da reprodução, então “O que o agente fez?” tem uma resposta navegável. Mais sobre gravação →
- ▸Gravado no registro de auditoria — cada login, conexão a host, operação de arquivo e comando do agente, com o local (IP · país) e o dispositivo.
05 / sem app aberto
Um endpoint MCP hospedado para agentes que vivem na nuvem.
Para servidores cadastrados com um Connector, o Codex pode usar o servidor hospedado do Termalin sem nenhum app de desktop aberto: adicione-o por URL — codex mcp add termalin --url https://termal.in/mcp — e o Codex abre o login do Termalin no seu navegador na hora (depois, codex mcp login termalin entra de novo). O lado hospedado precisa de uma conta no Pro ou nos 14 dias de teste.
Seu agente roda em um lugar onde ninguém pode fazer login, como a CI? Crie uma chave de API no painel web e aponte-a para https://termal.in/api/v1/mcp com Authorization: Bearer tk_live_…. Ela executa comandos e lê ou grava arquivos nos seus servidores com túnel — os que rodam o agente instalado com uma linha (cadastre em termal.in/account → Adicionar Connector; hosts do app de desktop não contam) — mesmo quando nada está aberto na sua máquina, autenticando com um certificado de curta duração, para que nenhuma chave seja distribuída. As chaves podem ser restritas a servidores específicos, ter uma política de comandos (total, uma lista de comandos permitidos ou somente leitura), receber uma validade (30 / 90 / 365 dias) e ser revogadas a qualquer momento; as execuções hospedadas têm limite de taxa e de tempo. Os dois caminhos alcançam hosts diferentes — o servidor local trabalha com o inventário que você exporta do app, o endpoint hospedado com seus servidores de túnel cadastrados. A ideia é nova para você? Comece por SSH para agentes de IA ou vá direto à referência MCP completa.
Perguntas frequentes
Como conecto o Codex aos meus servidores?
O Codex acessa os servidores por meio de um servidor MCP — um MCP SSH autônomo que mantém uma chave onde é executado (por exemplo, tufantunc/ssh-mcp), ou aquele integrado a um cliente SSH. Com o Termalin: instale o Termalin, escolha quais hosts expor em Configurações → Acesso do agente (MCP) e aponte a configuração MCP do Codex para o binário termalin-mcp incluído — uma entrada na seção mcp_servers de ~/.codex/config.toml. A partir daí, o Codex pode listar esses hosts, executar comandos e ler ou gravar arquivos por SSH e SFTP. Para servidores cadastrados com um Connector, você pode pular o app de desktop e adicionar o servidor hospedado em https://termal.in/mcp. Referência completa →
O Codex recebe minhas chaves SSH?
Não. O agente se autentica pela custódia de chaves do Termalin — você desbloqueia uma vez e o Termalin assina em nome do agente, então nenhuma chave privada é entregue ao agente ou ao modelo. O endpoint hospedado vai além e usa um certificado de curta duração em vez de uma chave. Mais sobre segurança →
Posso limitar o que o Codex executa em um host?
Sim. O acesso do agente vem desativado por padrão, só os hosts que você exporta em Configurações → Acesso do agente (MCP) ficam acessíveis, e cada host tem a própria política para o agente: acesso total, uma lista de comandos permitidos ou bloqueado. A lista de comandos permitidos é o ponto de partida certo para tudo o que importa para você.
Posso acompanhar o que o agente está fazendo?
Sim — cada sessão aberta é espelhada ao vivo na grade de monitoramento, as sessões que um agente está conduzindo brilham, cada comando do agente fica marcado na gravação da sessão e tudo é gravado no registro de auditoria.
O servidor MCP é gratuito?
Sim — o plano Free é o app de desktop completo, apenas local e sem limite de hosts, e inclui o agente MCP abrindo as próprias sessões. O agente também pode entrar em uma sessão que você já tem aberta. O Pro (US$ 8/mês no plano anual, US$ 10 no mensal) acrescenta a nuvem criptografada e o servidor MCP hospedado. Toda conta nova começa com 14 dias de teste do Pro — sem cartão. Ver preços →
Dê ao seu agente um terminal de verdade — grátis.
O plano Free é o app de desktop completo — sem limite de hosts, com o servidor MCP incluído. Contas novas ganham o Pro grátis por 14 dias.
Plano Free · 14 dias de teste do Pro · Referência MCP · SSH para agentes de IA