← Toda a documentação de MCP
Configuração do MCP

Use o Done no Codex

Conecte o Done ao OpenAI Codex: adicione https://trydone.app/mcp com codex mcp add ou no config.toml, faça login com codex mcp login e o Codex passa a trabalhar suas tarefas do Done.

Para quem é

Para desenvolvedores que usam a CLI do Codex, a extensão do Codex para IDE ou o Codex no app de desktop do ChatGPT. Os três compartilham um mesmo arquivo de configuração, então você configura o Done uma vez só. O ChatGPT na web não lê esse arquivo — para ele, veja Use o Done no ChatGPT.

Configure

URL do servidor MCP do Done

https://trydone.app/mcp

Adicione o servidor e faça login Login com OAuth

  1. Adicione o Done à configuração do Codex:
    codex mcp add done --url https://trydone.app/mcp
  2. Faça login e aprove o acesso no Done na janela do navegador que abrir. O Codex se registra sozinho no Done e recebe o login em 127.0.0.1.
    codex mcp login done
  3. Peça ao Codex algo da lista abaixo para conferir que ele chega às suas tarefas.

O primeiro comando grava uma tabela [mcp_servers.done] com url = "https://trydone.app/mcp" em ~/.codex/config.toml — dá para adicionar à mão também.

Ou use um token Token MCP

  1. Gere um token MCP no Done, em Configurações → Acesso de agentes, e coloque numa variável de ambiente — por exemplo, no perfil do seu shell:
    export DONE_MCP_TOKEN="<your-mcp-token>"
  2. Aponte o Codex para essa variável em ~/.codex/config.toml:
    [mcp_servers.done]
url = "https://trydone.app/mcp"
bearer_token_env_var = "DONE_MCP_TOKEN"

Um token serve bem numa máquina remota ou sem tela, onde o login pelo navegador não alcança o endereço local do Codex.

Precisa de uma chave mais restrita? Em Configurações → Acesso de agentes → Tokens MCP adicionais você cria uma somente leitura, ou limitada a um projeto ou a um espaço de trabalho — e o agente nunca vê mais do que isso.

O que dizer a ele

Com o Done conectado, fale com o assistente normalmente. Cada uma destas frases corresponde a uma ferramenta real do Done:

“O que eu tenho para hoje?”
get_todays_plan
“Adicione uma tarefa: mandar a fatura para o Sam sexta p1”
quick_capture
“Pegue sua próxima tarefa do Done e proponha um plano antes de começar.”
next_task → propose_plan
“Se chegar a uma decisão que você não pode tomar, me pergunte e siga com o resto.”
ask_decision
“Quando terminar, mande para eu aprovar.”
propose_completion

Todas as ferramentas, prompts e recursos que o Done expõe estão na referência de MCP.

A aprovação obrigatória

Por padrão, um assistente não consegue concluir suas tarefas. Quando acha que uma tarefa está pronta, ele chama propose_completion, que deixa a tarefa em Aguardando aprovação até você aprovar ou devolver em Precisa de você; um trabalho grande começa com propose_plan, que espera o seu sinal verde. Uma pergunta passa por ask_decision: aquela tarefa espera sua resposta enquanto o agente segue para a próxima. O Done aplica isso no próprio servidor, então vale não importa o que o assistente tente — um agente só conclui uma tarefa diretamente se você configurou a Autonomia dessa tarefa para permitir.

Solução de problemas

O login nunca termina numa máquina remota
O Codex espera o login em 127.0.0.1 da máquina onde roda, e o seu navegador não chega lá por SSH. Use a configuração com token nessa máquina.
401 Unauthorized com um token
A variável não está definida no shell de onde o Codex foi iniciado, ou o token foi gerado de novo. Confira echo $DONE_MCP_TOKEN e reinicie o Codex.

Perguntas frequentes

O Codex no ChatGPT web usa isto?

Não. O arquivo local vale para a CLI do Codex, a extensão para IDE e o app de desktop do ChatGPT. Para o ChatGPT na web, adicione o Done como servidor MCP personalizado.

OAuth ou token?

Com OAuth, nenhum segredo fica nos seus arquivos. Um token funciona em máquinas sem tela e pode ser somente leitura ou limitado a um projeto.

Existe uma chave de API compartilhada para o Done?

Não. Cada conexão pertence a uma única conta do Done: um login com OAuth ou um token MCP que você mesmo gera. Não existe chave compartilhada nem global. Cada assistente conectado aparece em Configurações → Acesso de agentes, onde você revoga com um clique.

O que o assistente consegue ver?

Só o que a sua conta vê: seus espaços de trabalho e o que foi compartilhado com você. Um token somente leitura, de um projeto ou de um espaço de trabalho restringe ainda mais.

Custa alguma coisa?

O plano Free inclui 100 chamadas de agente (MCP) por mês; Pro e Teams são ilimitados. O plano do próprio assistente é à parte.

Passos conferidos com a documentação oficial em 23 de outubro de 2026:

Outros assistentes