DotMD je server MCP.Vaši agenti vidí, co právě čtete.

DotMD na vašem Macu provozuje místní server MCP. Claude Code, Codex, Cursor nebo jakýkoli klient MCP může otevírat vaše soubory Markdown, číst váš výběr a komentáře, ukazovat na řádky a posílat vám specifikaci k revizi.

macOS 14 nebo novější. Čtení je zdarma, DotMD Pro má 3denní zkušební období zdarma.

Rychlá odpověď

Settings → MCP → MCP server ho spustí na adrese http://127.0.0.1:8089/mcp. Tuto adresu jednou přidejte svému agentovi. Agent pak může otevírat soubory v DotMD, číst váš výběr a komentáře, zvýrazňovat řádky a posílat vám dokument k revizi. Revize a nástroje pro agenty jsou součástí DotMD Pro (3denní zkušební doba zdarma); čtení zůstává zdarma.

Zapněte server MCP pro Markdown

Je to server MCP pro práci s vašimi soubory Markdown v DotMD: otevírání, čtení toho, co komentujete, a revize toho, co agent napíše. Není to převodník, který mění jiné formáty na Markdown. Všechno se děje v Settings → MCP:

  • MCP server spustí server. Stav nahoře zezelená a ukáže Listening.
  • Start with DotMD ho spustí při každém startu DotMD.
  • Port je výchozí 8089. Po změně server vypněte a znovu zapněte.
  • Adresa http://127.0.0.1:8089/mcp je nahoře, s tlačítkem pro zkopírování.

Server běží, dokud je DotMD otevřený. Zavřete-li DotMD, agent se k němu nedostane.

Připojte agenta k serveru MCP

Přidejte adresu serveru jednou, tak, jak se to dělá ve vašem agentovi.

Claude Code

Spusťte tohle v Terminálu. Podrobnosti jsou v návodu pro Claude Code.

claude mcp add --transport http dotmd http://127.0.0.1:8089/mcp

Codex

V aplikaci Codex otevřete Settings → MCP servers → Add server a zvolte Streamable HTTP, nebo přidejte tohle do ~/.codex/config.toml. Řádek tool_timeout_sec nechá Codex čekat, zatímco revidujete. Víc v návodu pro Codex.

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

Cursor, Visual Studio Code a další

Přidejte server s touto konfigurací. Postup je v návodu pro Cursor.

{
  "mcpServers": {
    "dotmd": { "type": "http", "url": "http://127.0.0.1:8089/mcp" }
  }
}

Co agent s DotMD umí

Server dává agentovi dvanáct nástrojů:

NástrojCo dělá
open_fileOtevře soubor nebo složku v DotMD, případně na řádku, který se zvýrazní
request_reviewPošle vám k revizi dokument, který agent napsal, a čeká, dokud neklepnete na Send nebo Approve
get_current_fileKterý soubor je otevřený, jeho název, režim a část, kterou čtete
get_selectionText, který jste vybrali, s čísly řádků
highlightPosune na řádky a na pár sekund je zvýrazní
show_changesUkáže úpravy agenta vedle jejich komentářů, nebo v historii verzí
list_filesSoubory Markdown ve vašem pracovním prostoru s jejich názvy
searchProhledá text všech souborů v pracovním prostoru
get_review_commentsKomentáře k souboru, vaše nebo recenzujícího agenta
add_review_commentsZanechá komentáře na řádcích souboru jako recenzent pod jménem agenta
complete_reviewDá vám vědět, že agent dokončil recenzi, s jeho verdiktem a shrnutím v jedné větě
resolve_review_commentsPošle vám komentáře zpět k revizi, každý s poznámkou a řádky, které se kvůli němu změnily

Postup u specifikace: agent ji napíše a zavolá request_review, vy okomentujete a klepnete na Send a agent každý komentář opraví a pošle zpět přes resolve_review_comments. Jak to vypadá, ukazuje návod pro Claude Code.

Vidíte každé volání

Recent Requests v Settings → MCP ukazuje jednoduchými slovy, co který asistent udělal: „Codex · Opened plans/auth.md at line 42“ se zelenou fajfkou, „Searched for “rate limit” (5 matches)“ nebo „Couldn't open ~/notes/a.md — no access“ s červeným křížkem. Najetím na řádek zobrazíte celou cestu nebo důvod. Technical details místo toho vypíše surové požadavky HTTP. Seznam se uchovává, jen dokud je DotMD otevřený.

Zabezpečení: kdo se k serveru dostane

  • Server naslouchá jen na 127.0.0.1, takže se k němu jiné počítače nedostanou.
  • Webové stránky ho použít nemohou. Každý požadavek z prohlížeče se odmítne, stejně jako požadavek, jehož adresa nejmenuje tento Mac, což zároveň zastaví DNS rebinding.
  • Přijímá jen požadavky JSON, které webový formulář odeslat neumí.
  • Nikdy nezapisuje soubory. Nástroje působí na přední okno DotMD.
  • Otevírá jen soubory, ke kterým má DotMD přístup: váš pracovní prostor, Stažené a, pokud jste to povolili, vaši domovskou složku. U všeho ostatního se agentovi řekne, aby vás požádal o přidání složky do pracovního prostoru.

Odmítnuté požadavky se v Recent Requests zobrazí červeně s důvodem.

Agenti v Dockeru

Uvnitř kontejneru Docker je 127.0.0.1 samotný kontejner, ne váš Mac. S Docker Desktop kontejnery dosáhnou na Mac jako host.docker.internal, použijte tedy tuto adresu:

claude mcp add --transport http dotmd http://host.docker.internal:8089/mcp

Ostatní klienty berou stejnou adresu ve své konfiguraci. Každý kontejner na tomto Macu se k serveru takto dostane, stejně jako ke každému jinému serveru, který Docker Desktop na váš Mac pustí. Počítače ve vaší síti se pořád nedostanou.

Otázky k serveru MCP v DotMD

Mohou se k serveru MCP v DotMD dostat jiné počítače?

Ne. Naslouchá jen na 127.0.0.1. Kontejnery Docker na tomto Macu se dostanou přes host.docker.internal.

Může ho použít webová stránka?

Ne. Požadavky z prohlížeče se odmítají a přijímají se jen požadavky JSON z tohoto Macu.

Zapisuje server moje soubory?

Ne. Soubory nikdy nezapisuje; působí na přední okno DotMD.

Port 8089 je obsazený.

Změňte port v Settings → MCP, server vypněte a znovu zapněte a upravte adresu ve svém agentovi.

Další otázky