Conecte o Codex

A ferramenta de código da OpenAI, no terminal. Siga os passos abaixo: cada imagem mostra a tela que vai aparecer e onde clicar.

6 passos Cerca de 4 minSem chave para colar

Antes de começar

  • O Codex instalado e com login feito na sua conta da OpenAI.
  • Sua conta na RTCloud.
  1. 1

    Abra o terminal

    No seu computador

    No Windows, aperte a tecla Windows, digite PowerShell e dê Enter. No Mac, abra o app Terminal. É uma janela de texto, com a linha começando em PS C:\ no Windows.

    Os comandos deste tutorial vão nessa janela. Se você colar em uma conversa com a IA, eles viram mensagem e nada acontece.

    Windows PowerShellWindows PowerShellCopyright (C) Microsoft Corporation.PS C:\Users\voce>
  2. 2

    Adicione a RTCloud

    No terminal

    Cole o comando abaixo. O Codex guarda a RTCloud na configuração dele e ela passa a valer em qualquer pasta.

    Cole no terminal

    codex mcp add rtcloud --url https://rtcloud.com.br/mcp
    Windows PowerShellPS C:\Users\voce> codex mcp add rtcloud --urlrtcloud.com.br/mcp

    Apareceu que codex não é reconhecido?

    O Codex ainda não está neste computador. Com o Node.js instalado, cole o comando abaixo, espere terminar e abra um terminal novo.

    O erroPS C:\Users\voce> codex mcp add rtcloud --urlrtcloud.com.br/mcpcodex : O termo 'codex' não é reconhecido como nome decmdlet, função, arquivo de script ou programaoperável.

    Cole no terminal

    npm install -g @openai/codex

    No terminal novo, faça o login no Codex e volte a este passo.

  3. 3

    Entre na RTCloud

    No terminal

    Cole o comando abaixo. O navegador abre sozinho na página da RTCloud.

    Cole no terminal

    codex mcp login rtcloud
    Windows PowerShellPS C:\Users\voce> codex mcp login rtcloudAbrindo o navegador...
  4. 4

    Autorize na RTCloud

    No navegador

    A página da RTCloud abre sozinha. Entre na sua conta se ela pedir. As permissões de leitura já vêm marcadas: para o primeiro teste, é só clicar em Autorizar. Para a ferramenta poder alterar algo, use Liberar tudo ou marque uma a uma.

    rtcloud.com.br/oauth/autorizarAutorizar CodexVer aplicaçõesLer arquivosVer nomes das variáveisRecusarAutorizar
  5. 5

    Abra o Codex numa pasta de trabalho

    No terminal

    Entre na pasta de um projeto seu e rode o comando abaixo. Dentro dele, /mcp mostra os servidores ativos.

    Cole no terminal

    codex
    Windows PowerShellPS ...\meu-projeto> codex
  6. 6

    Faça o primeiro pedido

    Dentro do Codex

    Peça: Liste minhas aplicações. A ferramenta pode pedir sua aprovação antes de agir. Se aparecerem as suas aplicações, está tudo certo.

    CodexListe minhas aplicaçõesrtcloud · list_applicatio…meu-bot · no arloja-online · no arapi-pedidos · parada

Pronto, está conectado

A conexão aparece em Ferramentas MCP, no painel. Toda alteração feita pela ferramenta fica registrada na sua Atividade. Quando quiser liberar mais, desconecte e autorize de novo com outras permissões.

Prefere usar uma chave?

Sem navegador: gere uma chave MCP, salve na variável RTCLOUD_MCP_KEY e coloque isto no arquivo ~/.codex/config.toml:

~/.codex/config.toml

[mcp_servers.rtcloud]
url = "https://rtcloud.com.br/mcp"
bearer_token_env_var = "RTCLOUD_MCP_KEY"

Deu algo errado?

Apareceu “Pedido não aceito” na página da RTCloud

Nada foi liberado na sua conta. Confira se o endereço está exato, sem espaço nem barra no fim, e conecte de novo. Se continuar, fale com o suporte e mande o print.

O terminal diz que codex não é reconhecido

O Codex ainda não está instalado neste computador. Siga a correção do passo Adicione a RTCloud, com imagem.

O PowerShell diz que a execução de scripts foi desabilitada

Rode Set-ExecutionPolicy -Scope CurrentUser RemoteSigned, confirme com S e tente de novo.

O navegador não abriu

Rode codex mcp login rtcloud --no-browser, abra o endereço que aparecer e cole no terminal o endereço final da página.

Como vejo se a RTCloud foi adicionada?

Rode codex mcp list no terminal.

Conectou, mas ela não vê as minhas aplicações

Confira se a permissão Ver aplicações ficou marcada ao autorizar. Se precisar mudar, desconecte em Ferramentas MCP e conecte de novo.

Para desconectar

No painel da RTCloud, abra Ferramentas MCP e clique em Desconectar: o acesso acaba na hora. No terminal, rode codex mcp remove rtcloud.

Outras ferramentas

Coloque a sua IA para cuidar do deploy

Crie a conta, publique a aplicação e conecte a sua ferramenta em poucos minutos.