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ędzieCo robi
open_fileOtwiera plik lub folder w DotMD, opcjonalnie w danym wierszu, który zostaje wyróżniony
request_reviewWysyła Ci do przeglądu dokument napisany przez agenta i czeka, aż klikniesz Send lub Approve
get_current_fileKtóry plik jest otwarty, jego tytuł, tryb i sekcja, którą czytasz
get_selectionZaznaczony przez Ciebie tekst wraz z numerami wierszy
highlightPrzewija do wierszy i wyróżnia je na kilka sekund
show_changesPokazuje zmiany agenta obok ich komentarzy albo w historii wersji
list_filesPliki Markdown w Twojej przestrzeni roboczej wraz z tytułami
searchPrzeszukuje tekst wszystkich plików w przestrzeni roboczej
get_review_commentsKomentarze do pliku: Twoje lub agenta recenzenta
add_review_commentsZostawia komentarze przy wierszach pliku jako recenzent, pod nazwą agenta
complete_reviewDaje znać, że agent recenzujący skończył, z jego werdyktem i podsumowaniem w jednym zdaniu
resolve_review_commentsOdsył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.

Więcej pytań