DotMD jest serwerem MCP.Twoi agenci widzą to, co czytasz.
DotMD uruchamia na Twoim Macu lokalny serwer MCP. Claude Code, Codex, Cursor lub dowolny klient MCP może otwierać Twoje pliki Markdown, czytać Twoje zaznaczenie i komentarze, wskazywać wiersze i wysyłać Ci specyfikację do przeglądu.
macOS 14 lub nowszy. Czytanie jest bezpłatne, a DotMD Pro ma 3-dniowy bezpłatny okres próbny.
Krótka odpowiedź
Settings → MCP → MCP server uruchamia go pod adresem http://127.0.0.1:8089/mcp. Dodaj ten adres do swojego agenta raz. Agent może wtedy otwierać pliki w DotMD, czytać Twoje zaznaczenie i komentarze, wyróżniać wiersze i wysyłać Ci dokument do przeglądu. Przeglądy i narzędzia dla agentów należą do DotMD Pro (3 dni bezpłatnego okresu próbnego); czytanie pozostaje bezpłatne.
Włącz serwer MCP dla Markdown
To serwer MCP do pracy z Twoimi plikami Markdown w DotMD: otwierania ich, czytania tego, co komentujesz, i przeglądania tego, co pisze agent. Nie jest to konwerter zamieniający inne formaty na Markdown. Wszystko dzieje się w Settings → MCP:
- MCP server uruchamia serwer. Status u góry robi się zielony i pokazuje Listening.
- Start with DotMD uruchamia go przy każdym starcie DotMD.
- Port to domyślnie 8089. Po zmianie wyłącz i włącz serwer.
- Adres,
http://127.0.0.1:8089/mcp, jest na górze, z przyciskiem do skopiowania.
Serwer działa, dopóki DotMD jest otwarty. Gdy zamkniesz DotMD, agent nie może się z nim połączyć.
Połącz agenta z serwerem MCP
Dodaj adres serwera raz, tak jak robi się to w Twoim agencie.
Claude Code
Uruchom to w Terminalu. Szczegóły są w przewodniku po Claude Code.
claude mcp add --transport http dotmd http://127.0.0.1:8089/mcp
Codex
W aplikacji Codex otwórz Settings → MCP servers → Add server i wybierz Streamable HTTP albo dodaj to do ~/.codex/config.toml. Linijka tool_timeout_sec pozwala Codexowi czekać na Twój przegląd. Więcej w przewodniku po Codexie.
[mcp_servers.dotmd]
url = "http://127.0.0.1:8089/mcp"
tool_timeout_sec = 3600
Cursor, Visual Studio Code i inne
Dodaj serwer z tą konfiguracją. Kroki są w przewodniku po Cursorze.
{
"mcpServers": {
"dotmd": { "type": "http", "url": "http://127.0.0.1:8089/mcp" }
}
}
Co agent może zrobić z DotMD
Serwer daje agentowi dwanaście narzędzi:
| Narzędzie | Co robi |
|---|---|
open_file | Otwiera plik lub folder w DotMD, opcjonalnie w danym wierszu, który zostaje wyróżniony |
request_review | Wysyła Ci do przeglądu dokument napisany przez agenta i czeka, aż klikniesz Send lub Approve |
get_current_file | Który plik jest otwarty, jego tytuł, tryb i sekcja, którą czytasz |
get_selection | Zaznaczony przez Ciebie tekst wraz z numerami wierszy |
highlight | Przewija do wierszy i wyróżnia je na kilka sekund |
show_changes | Pokazuje zmiany agenta obok ich komentarzy albo w historii wersji |
list_files | Pliki Markdown w Twojej przestrzeni roboczej wraz z tytułami |
search | Przeszukuje tekst wszystkich plików w przestrzeni roboczej |
get_review_comments | Komentarze do pliku: Twoje lub agenta recenzenta |
add_review_comments | Zostawia komentarze przy wierszach pliku jako recenzent, pod nazwą agenta |
complete_review | Daje znać, że agent recenzujący skończył, z jego werdyktem i podsumowaniem w jednym zdaniu |
resolve_review_comments | Odsyła Ci komentarze do przeglądu, każdy z notatką i wierszami zmienionymi z jego powodu |
Przebieg dla specyfikacji: agent ją pisze i wywołuje request_review, Ty komentujesz i klikasz Send, a agent poprawia każdy komentarz i odsyła go przez resolve_review_comments. Jak to wygląda, zobaczysz w przewodniku po Claude Code.
Widzisz każde wywołanie
Recent Requests w Settings → MCP pokazuje prostymi słowami, co zrobił każdy asystent: „Codex · Opened plans/auth.md at line 42” z zielonym znaczkiem, „Searched for “rate limit” (5 matches)” albo „Couldn't open ~/notes/a.md — no access” z czerwonym krzyżykiem. Najedź na wiersz, by zobaczyć pełną ścieżkę lub powód. Technical details pokazuje zamiast tego surowe żądania HTTP. Lista jest przechowywana tylko, dopóki DotMD jest otwarty.
Bezpieczeństwo: kto może połączyć się z serwerem
- Serwer nasłuchuje tylko na 127.0.0.1, więc inne komputery nie mogą się z nim połączyć.
- Strony internetowe nie mogą z niego korzystać. Każde żądanie z przeglądarki jest odrzucane, podobnie jak żądanie, którego adres nie wskazuje tego Maca, co zatrzymuje też DNS rebinding.
- Przyjmuje tylko żądania JSON, których formularz internetowy nie może wysłać.
- Nigdy nie zapisuje plików. Narzędzia działają na okno DotMD na pierwszym planie.
- Otwiera tylko pliki, do których DotMD ma dostęp: Twoją przestrzeń roboczą, Pobrane i, jeśli na to pozwolisz, Twój folder domowy. W przypadku wszystkiego innego agent dostaje polecenie, by poprosić Cię o dodanie folderu do przestrzeni roboczej.
Odrzucone żądania pojawiają się w Recent Requests na czerwono, z powodem.
Agenci w Dockerze
W kontenerze Dockera 127.0.0.1 to sam kontener, a nie Twój Mac. W Docker Desktop kontenery docierają do Maca pod nazwą host.docker.internal, więc użyj tego adresu:
claude mcp add --transport http dotmd http://host.docker.internal:8089/mcp
Inne klienty używają tego samego adresu w swojej konfiguracji. Każdy kontener na tym Macu może w ten sposób dotrzeć do serwera, tak jak do każdego innego serwera, który Docker Desktop przepuszcza do Twojego Maca. Komputery w Twojej sieci nadal nie mogą.
Pytania o serwer MCP w DotMD
Czy inne komputery mogą połączyć się z serwerem MCP DotMD?
Nie. Nasłuchuje tylko na 127.0.0.1. Kontenery Dockera na tym Macu mogą, przez host.docker.internal.
Czy może z niego korzystać strona internetowa?
Nie. Żądania z przeglądarki są odrzucane, a przyjmowane są tylko żądania JSON z tego Maca.
Czy serwer zapisuje moje pliki?
Nie. Nigdy nie zapisuje plików; działa na okno DotMD na pierwszym planie.
Port 8089 jest zajęty.
Zmień port w Settings → MCP, wyłącz i włącz serwer i zaktualizuj adres w swoim agencie.