Codex пише специфікацію.Ви переглядаєте її в DotMD.

Як підключити Codex: через застосунок або config.toml

DotMD запускає на вашому Mac невеликий MCP-сервер. Через нього Codex відкриває файли в DotMD, надсилає вам документи на рев'ю та читає ваші коментарі. Застосунок Codex, Codex CLI і розширення Codex для вашої IDE використовують одне налаштування, тож робити це потрібно один раз.

1. Увімкніть MCP-сервер DotMD

   У DotMD відкрийте Settings → MCP і ввімкніть MCP server. Статус стане зеленим. Увімкніть і Start with DotMD, щоб сервер був готовий щоразу, коли DotMD відкритий.

2. Додайте сервер у Codex

   У застосунку Codex відкрийте Settings → MCP servers → Add server, виберіть Streamable HTTP і вставте адресу, указану вгорі Settings → MCP у DotMD. За замовчуванням це http://127.0.0.1:8089/mcp.

3. Або відредагуйте config.toml

   Зручніше файл? Додайте це до ~/.codex/config.toml. У Settings → MCP у DotMD є кнопка копіювання:

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

   Після додавання перезапустіть Codex.

4. Перевірте, що він відповідає

   Попросіть Codex відкрити Markdown-файл у DotMD. Файл відкриється, а Recent Requests у Settings → MCP покаже виклик простими словами із зеленою галочкою.

Чому важливий tool_timeout_sec

Коли Codex надсилає вам специфікацію на рев'ю, він чекає в одному виклику MCP-інструмента, доки ви не натиснете Send або Approve. Поки він чекає, токени не витрачаються. Але Codex кидає виклик інструмента через хвилину, якщо не сказати інакше, а рев'ю триває довше.

tool_timeout_sec = 3600 дозволяє Codex чекати до години. Без цього Codex перестає чекати, і вашому рев'ю нікому відповісти. Нічого не втратиться: коментарі залишаються в DotMD, і коли закінчите, можна сказати Codex «Прочитай мої коментарі в DotMD і виправ їх». Але найкраще все працює, коли Codex ще чекає на вас.

Допоможіть Codex знайти ваші коментарі

Codex звертається до MCP-інструментів, лише коли вважає, що вони потрібні. На прохання «виправ коментарі до paywall.md» він може шукати їх у проєкті замість того, щоб прочитати в DotMD, адже коментарі зберігає DotMD, а не файл. Є два способи спрямувати його.

Перший: згадати DotMD у проханні, наприклад «виправ коментарі до paywall.md у DotMD». Другий: один раз додати ці рядки до ~/.codex/AGENTS.md або до AGENTS.md проєкту:

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.

З цими рядками Codex надсилає вам кожну специфікацію, яку пише, і завжди шукає ваші коментарі в DotMD.

Ваше перше рев'ю специфікації Codex

Попросіть Codex підготувати документ, скажіть, куди його зберегти і що ви хочете його переглянути:

«Напиши специфікацію в docs/spec.md і надішли мені її на рев'ю в DotMD».

1. Codex надсилає вам файл

   Він зберігає специфікацію й надсилає її вам. З'являється сповіщення, файл потрапляє до Needs You, а Codex чекає.

2. Ви коментуєте уривки

   Читайте специфікацію у відрендереному вигляді, з таблицями, діаграмами й кодом. Виділіть уривок, який треба змінити, натисніть ⌥⌘M і напишіть, що хочете. Пройдіть увесь документ, перш ніж щось надсилати.

3. Ви надсилаєте коментарі

   Натисніть Send унизу панелі Review. Codex отримає всі ваші коментарі разом. Якщо змінювати нічого, на кнопці буде Approve.

4. Ви перевіряєте кожне виправлення у файлі

   Codex редагує файл і повертає кожен коментар із приміткою про те, що зроблено. Кожне виправлення стоїть поруч із коментарем, на який відповідає: старий текст червоним, новий зеленим. Прийміть його кнопкою Accept, поверніть кнопкою Reopen або прийміть усе через Accept All. Потім Approve або ще один раунд.

Codex може бути й рецензентом. Попросіть його: «переглянь docs/compare.md у DotMD і залиш коментарі до рядків», і його коментарі з'являться під його іменем. Див. Один агент перевіряє іншого.

Застосунок ChatGPT підключитися не може

Застосунок ChatGPT звертається до MCP-серверів із серверів OpenAI в інтернеті, а не з вашого Mac. Сервер DotMD відповідає лише на вашому Mac, тож застосунок ChatGPT ним скористатися не може. Для моделей OpenAI використовуйте Codex.

Питання про Codex і DotMD

Інші запитання