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

Другие вопросы