DotMD ist ein MCP-Server.Deine Agenten sehen, was du gerade liest.

Den Markdown-MCP-Server einschalten

Das ist ein MCP-Server, um mit deinen Markdown-Dateien in DotMD zu arbeiten: sie zu öffnen, zu lesen, was du kommentierst, und zu prüfen, was der Agent schreibt. Er ist kein Konverter, der andere Formate in Markdown umwandelt. Alles geschieht in Settings → MCP:

• MCP server startet den Server. Der Status oben wird grün und zeigt Listening.
• Start with DotMD startet ihn mit jedem Start von DotMD.
• Port ist standardmäßig 8089. Schalte den Server nach einer Änderung aus und wieder ein.
• Die Adresse, http://127.0.0.1:8089/mcp, steht oben, mit einem Kopieren-Button.

Der Server läuft, solange DotMD geöffnet ist. Schließt du DotMD, erreicht ihn der Agent nicht mehr.

Verbinde deinen Agenten mit dem MCP-Server

Trage die Adresse des Servers einmal ein, so wie es dein Agent vorsieht.

Claude Code

Führe dies im Terminal aus. Details stehen in der Claude-Code-Anleitung.

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

Codex

Öffne in der Codex-App Settings → MCP servers → Add server und wähle Streamable HTTP, oder trage dies in ~/.codex/config.toml ein. Die Zeile tool_timeout_sec lässt Codex warten, während du prüfst. Mehr in der Codex-Anleitung.

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

Cursor, Visual Studio Code und andere

Füge einen Server mit dieser Konfiguration hinzu. Die Schritte stehen in der Cursor-Anleitung.

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

Was der Agent mit DotMD tun kann

Der Server gibt dem Agenten zwölf Tools:

Der Ablauf bei einer Spec: Der Agent schreibt sie und ruft request_review auf, du kommentierst und klickst auf Send, und der Agent arbeitet jeden Kommentar ein und schickt ihn mit resolve_review_comments zurück. Wie das aussieht, zeigt die Claude-Code-Anleitung.

Du siehst jeden Aufruf

Recent Requests in Settings → MCP zeigt in einfachen Worten, was jeder Assistent getan hat: „Codex · Opened plans/auth.md at line 42“ mit grünem Haken, „Searched for “rate limit” (5 matches)“ oder „Couldn't open ~/notes/a.md — no access“ mit rotem Kreuz. Fahre über eine Zeile für den vollen Pfad oder den Grund. Technical details zeigt stattdessen die rohen HTTP-Anfragen. Die Liste bleibt nur erhalten, solange DotMD geöffnet ist.

Sicherheit: Wer den Server erreicht

• Der Server lauscht nur auf 127.0.0.1, andere Computer erreichen ihn also nicht.
• Webseiten können ihn nicht nutzen. Jede Anfrage aus einem Browser wird abgelehnt, ebenso eine Anfrage, deren Adresse nicht diesen Mac nennt, was auch DNS-Rebinding verhindert.
• Er nimmt nur JSON-Anfragen an, die ein Webformular nicht senden kann.
• Er schreibt nie Dateien. Die Tools wirken auf das vorderste DotMD-Fenster.
• Er öffnet nur Dateien, auf die DotMD Zugriff hat: dein Workspace, Downloads und, wenn du es erlaubt hast, dein Home-Ordner. Für alles andere wird der Agent angewiesen, dich zu bitten, den Ordner zum Workspace hinzuzufügen.

Abgelehnte Anfragen erscheinen in Recent Requests in Rot, mit dem Grund.

Agenten in Docker

In einem Docker-Container ist 127.0.0.1 der Container selbst, nicht dein Mac. Mit Docker Desktop erreichen Container den Mac als host.docker.internal, verwende also diese Adresse:

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

Andere Clients tragen dieselbe Adresse in ihrer Konfiguration ein. Jeder Container auf diesem Mac erreicht den Server auf diesem Weg, so wie jeden anderen Server, den Docker Desktop zu deinem Mac durchlässt. Computer in deinem Netzwerk erreichen ihn weiterhin nicht.

Fragen zum MCP-Server von DotMD

Weitere Fragen