Leve seus formulários
para o OpenAI Codex.

Antes de começar

Do que você precisa

• Uma versão recente da Codex CLI, com login pelo ChatGPT ou por chave de API. A OpenAI lista MCP para Plus, Pro, Business, Edu e Enterprise, e para login com chave de API.
• Um navegador na mesma máquina para o login. Se você usa SSH, tem uma alternativa mais abaixo.
• Uma conta do trulyform. Se precisar, dá para criar uma na página de login.

O plano Free do trulyform inclui MCP. Você não vai precisar de chave de API nem de token em variável de ambiente.

Passo 1

Adicione o trulyform pelo terminal

Em qualquer pasta, rode:

codex mcp add trulyform --url 'https://trulyform.com/mcp'

O Codex confirma com Added global MCP server 'trulyform'. e salva esta entrada em ~/.codex/config.toml:

[mcp_servers.trulyform]
url = "https://trulyform.com/mcp"

Prefere editar o arquivo? Cole essas duas linhas no config.toml você mesmo. Nos dois casos, o próximo passo é o login.

Passo 2

Entre no trulyform

Adicionar o servidor só salva a configuração. Para fazer login, rode:

codex mcp login trulyform

Se a sua versão do Codex já abriu o trulyform no navegador quando você adicionou o servidor, termine esse login; não precisa fazer os dois.

1. Entre no trulyform, ou crie uma conta e confirme o e-mail no mesmo navegador.
2. O endereço de retorno na tela de aprovação aponta para o seu próprio computador: começa com http://127.0.0.1: e uma porta que o Codex escolhe para este login, seguida de /callback.
3. Confira o e-mail e a organização e escolha Aprovar acesso.
4. A aba do navegador mostra “Authentication complete. You may close this window.” (Autenticação concluída. Você pode fechar esta janela.) e o terminal avisa que o login deu certo.

Está usando SSH? codex mcp login trulyform --no-browser mostra o link de login para você abrir em outro aparelho e deixa você colar de volta o endereço em que o navegador chega depois de aprovar.

Na extensão para IDE e no app do ChatGPT para desktop

Os dois leem ~/.codex/config.toml, então o servidor que você acabou de adicionar aparece lá também. Se preferir adicionar pelas configurações deles:

Extensão para IDE (VS Code, Cursor, Windsurf)

Abra o menu de engrenagem, selecione MCP servers e depois Add server. Dê o nome trulyform, escolha Streamable HTTP, informe a URL e salve. Selecione Restart extension e depois Authenticate ao lado do trulyform.

App do ChatGPT para desktop, no Codex

Vá em Settings → MCP servers → Add server, preencha o mesmo nome, tipo e URL, salve, selecione Restart e depois Authenticate.

As tarefas na nuvem do Codex e as conversas em chatgpt.com não leem a sua configuração local do Codex, então estes passos não deixam o trulyform disponível lá.

Passo 3

Confirme a conexão

Rode codex mcp list. A coluna Auth do trulyform deve mostrar OAuth, e não Not logged in. Dentro de uma sessão do Codex, /mcp lista as ferramentas carregadas, e /mcp verbose mostra também os diagnósticos.

Depois, pergunte:

Liste meus formulários do trulyform.

A resposta vem pela ferramenta list_forms do trulyform. Uma conta vazia simplesmente não retorna formulários, o que também confirma que a configuração deu certo.

Passo 4

Teste em um repositório

O Codex lê o projeto em que está trabalhando, então consegue montar um formulário sob medida para o seu produto. No seu repositório, experimente:

Dê uma olhada no README e nas telas principais deste repositório. Crie no trulyform um formulário para os nossos usuários reportarem bugs: o que a pessoa estava tentando fazer, os passos para reproduzir, o que ela esperava e o que aconteceu, navegador e sistema operacional, e um e-mail opcional. Salve como rascunho e não publique.

Revise o rascunho no trulyform e termine o trabalho pelo Codex:

Conferi o formulário de bugs no trulyform. Leia o rascunho mais recente, publique essa revisão e adicione o link público como link de contato em .github/ISSUE_TEMPLATE/config.yml.

A publicação usa exatamente a revisão que o Codex leu. Se o rascunho mudou depois disso, o trulyform recusa a publicação até o Codex buscar a versão atual.

O que o Codex pergunta antes de rodar

O Codex leva em conta as indicações que cada ferramenta do trulyform traz. Ferramentas que só leem, como list_forms e list_responses, rodam sem perguntar. Para salvar um rascunho ou publicar, ele pede confirmação antes, com opções para permitir uma vez, durante a sessão ou sempre.

Para uma ferramenta específica sempre pedir confirmação, defina o modo de aprovação dela no config.toml:

[mcp_servers.trulyform.tools.publish_form]
approval_mode = "prompt"

Saia ou remova o trulyform

• codex mcp logout trulyform apaga o login que o Codex guardou.
• codex mcp remove trulyform apaga a entrada do servidor, mas mantém os logins guardados; se quiser remover os dois, saia primeiro.
• Para cortar o acesso do nosso lado, abra Configurações → Conexões de IA no trulyform e escolha Revogar acesso na conexão do Codex.

Revogar bloqueia novos pedidos; o que o Codex já leu continua no histórico da sessão.

Quando o Codex não conecta

Documentação do Codex

Conferimos este passo a passo com as páginas abaixo em 4 de outubro de 2026. Como o Codex atualiza as telas de vez em quando, vale sempre o que diz a documentação oficial dele.

• Model Context Protocol no Codex ↗
• Comandos da CLI do Codex ↗
• Referência de configuração do Codex ↗

Ainda precisa de ajuda? Fale com a gente.