Codex pisze specyfikację.Ty przeglądasz ją w DotMD.

Jak połączyć Codex: przez aplikację lub config.toml

DotMD uruchamia na Twoim Macu mały serwer MCP. Codex łączy się z nim, żeby otwierać pliki w DotMD, wysyłać Ci dokumenty do przeglądu i czytać Twoje komentarze. Aplikacja Codex, Codex CLI i rozszerzenie Codexa do Twojego IDE korzystają z jednej konfiguracji, więc robisz to raz.

1. Włącz serwer MCP w DotMD

   W DotMD otwórz Settings → MCP i włącz MCP server. Status zmieni się na zielony. Włącz też Start with DotMD, żeby serwer był gotowy zawsze, gdy DotMD jest otwarty.

2. Dodaj serwer w Codexie

   W aplikacji Codex otwórz Settings → MCP servers → Add server, wybierz Streamable HTTP i wklej adres z górnej części Settings → MCP w DotMD. Domyślnie to http://127.0.0.1:8089/mcp.

3. Albo edytuj config.toml

   Wolisz plik? Dodaj to do ~/.codex/config.toml. Settings → MCP w DotMD ma przycisk do skopiowania:

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

   Po dodaniu uruchom Codex ponownie.

4. Sprawdź, czy odpowiada

   Poproś Codex, żeby otworzył plik Markdown w DotMD. Plik się otworzy, a Recent Requests w Settings → MCP pokaże wywołanie prostymi słowami, z zielonym znaczkiem.

Dlaczego tool_timeout_sec ma znaczenie

Gdy Codex wysyła Ci specyfikację do przeglądu, czeka w jednym wywołaniu narzędzia MCP, aż klikniesz Send lub Approve. W tym czasie nie zużywa tokenów. Ale Codex porzuca wywołanie narzędzia po minucie, jeśli nie powiesz mu inaczej, a przegląd trwa dłużej.

tool_timeout_sec = 3600 pozwala Codexowi czekać do godziny. Bez tego Codex przestaje czekać i Twój przegląd nie ma już adresata. Nic nie przepada: Twoje komentarze zostają w DotMD, a gdy skończysz, możesz powiedzieć Codexowi „Przeczytaj moje komentarze w DotMD i popraw je”. Najlepiej jednak działa to wtedy, gdy Codex wciąż na Ciebie czeka.

Pomóż Codexowi znaleźć Twoje komentarze

Codex sięga po narzędzia MCP tylko wtedy, gdy uzna, że ich potrzebuje. Poproszony „popraw komentarze do paywall.md”, może szukać ich w projekcie zamiast czytać w DotMD, bo Twoje komentarze przechowuje DotMD, a nie plik. Są dwa sposoby, by go pokierować.

Pierwszy to wspomnieć DotMD w prośbie: „popraw komentarze do paywall.md w DotMD”. Drugi to dodać raz te linijki do ~/.codex/AGENTS.md albo 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.

Z tymi linijkami Codex wysyła Ci każdą specyfikację, którą napisze, i zawsze szuka Twoich komentarzy w DotMD.

Twój pierwszy przegląd specyfikacji od Codexa

Poproś Codex o dokument i powiedz, gdzie ma go zapisać i że chcesz go przejrzeć:

„Napisz specyfikację do docs/spec.md i wyślij mi ją do przeglądu w DotMD.”

1. Codex wysyła Ci plik

   Zapisuje specyfikację i wysyła ją do Ciebie. Pojawia się powiadomienie, plik jest na liście Needs You, a Codex czeka.

2. Komentujesz fragmenty

   Czytaj specyfikację wyrenderowaną, z tabelami, diagramami i kodem. Zaznacz fragment do zmiany, naciśnij ⌥⌘M i napisz, czego chcesz. Przejrzyj cały dokument, zanim cokolwiek wyślesz.

3. Wysyłasz komentarze

   Kliknij Send na dole panelu Review. Codex dostaje wszystkie Twoje komentarze naraz. Jeśli nie masz nic do zmiany, na przycisku jest Approve.

4. Sprawdzasz każdą poprawkę w pliku

   Codex edytuje plik i odsyła każdy komentarz z notatką o tym, co zrobił. Każda poprawka stoi obok komentarza, na który odpowiada, stary tekst na czerwono, nowy na zielono. Zaakceptuj ją przyciskiem Accept, otwórz ponownie przyciskiem Reopen albo zaakceptuj wszystko przyciskiem Accept All. Potem Approve albo wyślij kolejną rundę.

Codex może też być recenzentem. Poproś go: „przejrzyj docs/compare.md w DotMD i zostaw komentarze przy wierszach”, a jego komentarze pojawią się pod jego nazwą. Zobacz Jeden agent sprawdza drugiego.

Aplikacja ChatGPT nie może się połączyć

Aplikacja ChatGPT łączy się z serwerami MCP z serwerów OpenAI w internecie, a nie z Twojego Maca. Serwer DotMD odpowiada tylko na Twoim Macu, więc aplikacja ChatGPT nie może z niego korzystać. Dla modeli OpenAI użyj Codexa.

Pytania o Codex i DotMD

Więcej pytań