DotMD
O Codex escreve a spec.Você revê-a no DotMD.
Adicione o DotMD ao Codex uma só vez. Cada spec e cada plano que escrever chega-lhe como um documento para ler e comentar, o Codex espera enquanto revê, e cada correção aparece no ficheiro para a aceitar.
macOS 14 ou posterior. Ler é grátis; o DotMD Pro tem 3 dias de teste gratuito.
Resposta rápida
Na app do Codex abra Settings → MCP servers → Add server, escolha Streamable HTTP e cole http://127.0.0.1:8089/mcp. Ou adicione [mcp_servers.dotmd] a ~/.codex/config.toml com tool_timeout_sec = 3600, para o Codex poder esperar enquanto revê. Reinicie o Codex. As revisões e as ferramentas para agentes fazem parte do DotMD Pro (3 dias de teste gratuito); ler continua a ser grátis.
Como ligar o Codex: pela app ou por config.toml
O DotMD executa um pequeno servidor MCP no seu Mac. O Codex usa-o para abrir ficheiros no DotMD, enviar-lhe documentos para rever e ler os seus comentários. A app do Codex, a CLI do Codex e a extensão do Codex para o seu IDE partilham uma só configuração, por isso faz isto uma só vez.
-
Ative o servidor MCP do DotMD
No DotMD, abra Settings → MCP e ative MCP server. O estado fica verde. Ative também Start with DotMD, para que o servidor esteja pronto sempre que o DotMD estiver aberto.
-
Adicione o servidor no Codex
Na app do Codex abra Settings → MCP servers → Add server, escolha Streamable HTTP e cole o endereço que aparece no topo de Settings → MCP do DotMD. Por predefinição é
http://127.0.0.1:8089/mcp. -
Ou edite o config.toml
Prefere um ficheiro? Adicione isto a
~/.codex/config.toml. O Settings → MCP do DotMD tem um botão para o copiar:[mcp_servers.dotmd] url = "http://127.0.0.1:8089/mcp" tool_timeout_sec = 3600Reinicie o Codex depois de o adicionar.
-
Confirme que responde
Peça ao Codex para abrir um ficheiro Markdown no DotMD. O ficheiro abre-se, e Recent Requests em Settings → MCP mostra a chamada em palavras simples, com um visto verde.
Porque é que tool_timeout_sec importa
Quando o Codex lhe envia uma spec para rever, espera numa única chamada a uma ferramenta MCP até clicar em Send ou Approve. Enquanto espera, não gasta tokens. Mas o Codex desiste de uma chamada a uma ferramenta ao fim de um minuto, se não lhe disser outra coisa, e uma revisão demora mais.
tool_timeout_sec = 3600 deixa o Codex esperar até uma hora. Sem isto, o Codex deixa de esperar e a sua revisão fica sem destinatário. Não se perde nada: os seus comentários ficam no DotMD, e pode dizer ao Codex «Lê os meus comentários no DotMD e corrige-os» quando terminar. Mas o ciclo funciona melhor quando o Codex ainda está à sua espera.
Ajude o Codex a encontrar os seus comentários
O Codex só olha para as suas ferramentas MCP quando acha que precisa delas. Se lhe pedir «corrige os comentários de paywall.md», pode procurá-los no projeto em vez de os ler no DotMD, porque os seus comentários são guardados pelo DotMD, não no ficheiro. Há duas maneiras de o orientar.
A primeira é mencionar o DotMD no pedido: «corrige os comentários de paywall.md no DotMD». A segunda é acrescentar estas linhas uma só vez a ~/.codex/AGENTS.md, ou ao AGENTS.md de um projeto:
Comments and reviews on Markdown files are kept in DotMD (MCP server `dotmd`), not in the files.
When I mention comments, a review or remarks on a .md file, read them with get_review_comments,
fix each one and send it back with resolve_review_comments.
After writing or substantially changing a spec, plan or design doc for me, send it to me with
request_review and wait for my answer; call it again after fixing my comments, until I approve.Com estas linhas, o Codex envia-lhe cada spec que escreve e procura sempre os seus comentários no DotMD.
A sua primeira revisão de uma spec do Codex
Peça o documento ao Codex, e diga onde deve ficar e que quer revê-lo:
«Escreve a spec em docs/spec.md e envia-ma no DotMD para revisão.»
-
O Codex envia-lhe o ficheiro
Guarda a spec e envia-lha. Aparece uma notificação, o ficheiro fica listado em Needs You, e o Codex espera.
-
Comenta as passagens
Leia a spec formatada, com as tabelas, diagramas e código. Selecione uma passagem a alterar, prima ⌥⌘M e escreva o que pretende. Percorra o documento inteiro antes de enviar seja o que for.
-
Envia os comentários
Clique em Send na parte inferior do painel Review. O Codex recebe todos os seus comentários de uma vez. Se não tiver nada a alterar, o botão diz Approve.
-
Verifica cada correção no ficheiro
O Codex edita o ficheiro e devolve cada comentário com uma nota sobre o que fez. Cada correção fica junto do comentário a que responde, o texto antigo a vermelho e o novo a verde. Aceite-a com Accept, reabra-a com Reopen ou aceite tudo com Accept All. Depois Approve, ou envie outra ronda.
O Codex também pode ser o revisor. Peça-lhe «revê docs/compare.md no DotMD e deixa os teus comentários nas linhas», e os comentários dele aparecem com o nome dele. Veja Um agente revê outro.
A app do ChatGPT não consegue ligar-se
A app do ChatGPT chega aos servidores MCP a partir dos servidores da OpenAI na internet, não a partir do seu Mac. O servidor do DotMD só responde no seu Mac, por isso a app do ChatGPT não o pode usar. Para os modelos da OpenAI, use o Codex.
Perguntas sobre o Codex e o DotMD
Porque é que o Codex deixa de esperar pela minha revisão?
O limite de tempo das suas ferramentas é curto por predefinição. Adicione tool_timeout_sec = 3600 ao servidor do DotMD em config.toml e reinicie o Codex.
O Codex procura no projeto em vez de ler os meus comentários.
Mencione o DotMD no pedido («…no DotMD»), ou acrescente uma só vez as linhas de AGENTS.md deste guia.
Funciona com a CLI do Codex e com a extensão para IDE?
Sim. A app, a CLI e a extensão para IDE partilham uma só configuração.
Posso ligar a app do ChatGPT em vez disso?
Não. Chega aos servidores MCP a partir dos servidores da OpenAI, e o DotMD só responde no seu Mac. Use o Codex.