Codex napíše specifikaci.Vy ji zrevidujete v DotMD.

Jak připojit Codex: aplikací nebo přes config.toml

DotMD na vašem Macu provozuje malý server MCP. Codex přes něj otevírá soubory v DotMD, posílá vám dokumenty k revizi a čte vaše komentáře. Aplikace Codex, Codex CLI i rozšíření Codexu pro vaše IDE sdílejí jedno nastavení, takže ho uděláte jen jednou.

1. Zapněte server MCP v DotMD

   V DotMD otevřete Settings → MCP a zapněte MCP server. Stav zezelená. Zapněte i Start with DotMD, aby byl server připravený, kdykoli je DotMD otevřené.

2. Přidejte server v Codexu

   V aplikaci Codex otevřete Settings → MCP servers → Add server, zvolte Streamable HTTP a vložte adresu z horní části Settings → MCP v DotMD. Výchozí je http://127.0.0.1:8089/mcp.

3. Nebo upravte config.toml

   Dáváte přednost souboru? Přidejte tohle do ~/.codex/config.toml. Settings → MCP v DotMD má na to tlačítko pro zkopírování:

   [mcp_servers.dotmd]
   url = "http://127.0.0.1:8089/mcp"
   tool_timeout_sec = 3600

   Po přidání Codex restartujte.

4. Ověřte, že odpovídá

   Požádejte Codex, aby otevřel soubor Markdown v DotMD. Soubor se otevře a Recent Requests v Settings → MCP uvede volání jednoduchými slovy se zelenou fajfkou.

Proč záleží na tool_timeout_sec

Když vám Codex pošle specifikaci k revizi, čeká v jednom volání nástroje MCP, dokud neklepnete na Send nebo Approve. Během čekání nespotřebovává žádné tokeny. Jenže Codex volání nástroje po minutě vzdá, pokud mu neřeknete jinak, a revize trvá déle.

tool_timeout_sec = 3600 nechá Codex čekat až hodinu. Bez toho Codex čekat přestane a vaše revize nemá komu přijít. Nic se neztratí: vaše komentáře zůstanou v DotMD a až skončíte, můžete Codexu říct „Přečti si mé komentáře v DotMD a oprav je“. Nejlépe ale celý postup funguje, když na vás Codex pořád čeká.

Pomozte Codexu najít vaše komentáře

Codex sahá po nástrojích MCP, jen když usoudí, že je potřebuje. Na pokyn „oprav komentáře k paywall.md“ je může hledat v projektu místo čtení v DotMD, protože vaše komentáře drží DotMD, ne soubor. Existují dva způsoby, jak ho nasměrovat.

První je zmínit DotMD v pokynu: „oprav komentáře k paywall.md v DotMD“. Druhý je jednou přidat tyto řádky do ~/.codex/AGENTS.md nebo do AGENTS.md projektu:

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.

S těmito řádky vám Codex pošle každou specifikaci, kterou napíše, a vaše komentáře vždy hledá v DotMD.

Vaše první revize specifikace od Codexu

Požádejte Codex o dokument a řekněte, kam ho má uložit a že ho chcete zrevidovat:

„Napiš specifikaci do docs/spec.md a pošli mi ji k revizi v DotMD.“

1. Codex vám pošle soubor

   Uloží specifikaci a pošle vám ji. Objeví se oznámení, soubor je uveden pod Needs You a Codex čeká.

2. Okomentujete pasáže

   Čtěte specifikaci vykreslenou, s tabulkami, diagramy a kódem. Označte pasáž, kterou je třeba změnit, stiskněte ⌥⌘M a napište, co chcete. Projděte celý dokument, než cokoli odešlete.

3. Odešlete komentáře

   Klepněte dole v panelu Review na Send. Codex dostane všechny vaše komentáře najednou. Pokud nemáte co měnit, tlačítko říká Approve.

4. Zkontrolujete každou opravu v souboru

   Codex upraví soubor a každý komentář vrátí s poznámkou o tom, co udělal. Každá oprava stojí vedle komentáře, na který odpovídá, starý text červeně a nový zeleně. Přijměte ji tlačítkem Accept, znovu ji otevřete tlačítkem Reopen nebo přijměte vše tlačítkem Accept All. Pak Approve, nebo pošlete další kolo.

Codex může být i recenzentem. Požádejte ho: „zreviduj docs/compare.md v DotMD a zanech své komentáře na řádcích“, a jeho komentáře se objeví pod jeho jménem. Viz Jeden agent reviduje druhého.

Aplikace ChatGPT se připojit nemůže

Aplikace ChatGPT se k serverům MCP dostává ze serverů OpenAI na internetu, ne z vašeho Macu. Server DotMD odpovídá jen na vašem Macu, takže ho aplikace ChatGPT použít nemůže. Pro modely OpenAI použijte Codex.

Otázky k Codexu a DotMD

Další otázky