DotMD
DotMD è un server MCP.I tuoi agenti vedono ciò che stai leggendo.
DotMD esegue un server MCP locale sul tuo Mac. Claude Code, Codex, Cursor o qualsiasi client MCP può aprire i tuoi file Markdown, leggere la tua selezione e i tuoi commenti, indicare righe e mandarti una spec da rivedere.
macOS 14 o successivo. La lettura è gratuita; DotMD Pro ha 3 giorni di prova gratuita.
Risposta rapida
Settings → MCP → MCP server lo avvia a http://127.0.0.1:8089/mcp. Aggiungi quell’indirizzo al tuo agente una volta sola. L’agente può allora aprire file in DotMD, leggere la tua selezione e i tuoi commenti, evidenziare righe e mandarti un documento da rivedere. Le revisioni e gli strumenti per gli agenti fanno parte di DotMD Pro (3 giorni di prova gratuita); la lettura resta gratuita.
Attiva il server MCP per Markdown
È un server MCP per lavorare con i tuoi file Markdown in DotMD: aprirli, leggere ciò che commenti e rivedere ciò che scrive l’agente. Non è un convertitore che trasforma altri formati in Markdown. Tutto si fa in Settings → MCP:
- MCP server avvia il server. Lo stato in alto diventa verde e mostra Listening.
- Start with DotMD lo avvia ogni volta che parte DotMD.
- Port è 8089 di default. Dopo averla cambiata, spegni e riaccendi il server.
- L’indirizzo,
http://127.0.0.1:8089/mcp, è in alto, con un pulsante per copiarlo.
Il server funziona finché DotMD è aperto. Se chiudi DotMD, l’agente non può raggiungerlo.
Collega il tuo agente al server MCP
Aggiungi l’indirizzo del server una volta sola, nel modo in cui lo fa il tuo agente.
Claude Code
Esegui questo nel Terminale. I dettagli sono nella guida a Claude Code.
claude mcp add --transport http dotmd http://127.0.0.1:8089/mcpCodex
Nell’app di Codex apri Settings → MCP servers → Add server e scegli Streamable HTTP, oppure aggiungi questo a ~/.codex/config.toml. La riga tool_timeout_sec permette a Codex di aspettare mentre rivedi. Altro nella guida a Codex.
[mcp_servers.dotmd]
url = "http://127.0.0.1:8089/mcp"
tool_timeout_sec = 3600Cursor, Visual Studio Code e altri
Aggiungi un server con questa configurazione. La guida a Cursor ha i passaggi.
{
"mcpServers": {
"dotmd": { "type": "http", "url": "http://127.0.0.1:8089/mcp" }
}
}Cosa può fare l’agente con DotMD
Il server dà all’agente dodici strumenti:
| Strumento | Cosa fa |
|---|---|
open_file | Apre un file o una cartella in DotMD, se vuoi a una riga, che viene evidenziata |
request_review | Ti manda da rivedere un documento scritto dall’agente e aspetta finché non clicchi Send o Approve |
get_current_file | Quale file è aperto, il suo titolo, la modalità e la sezione che stai leggendo |
get_selection | Il testo che hai selezionato, con i numeri di riga |
highlight | Scorre fino a certe righe e le evidenzia per qualche secondo |
show_changes | Mostra le modifiche dell’agente accanto ai loro commenti, o nella cronologia delle versioni |
list_files | I file Markdown del tuo spazio di lavoro, con i loro titoli |
search | Cerca nel testo di tutti i file dello spazio di lavoro |
get_review_comments | I commenti su un file, tuoi o di un agente revisore |
add_review_comments | Lascia commenti su righe di un file, come revisore, col nome dell’agente |
complete_review | Ti avvisa che un agente revisore ha finito, con il suo verdetto e un riassunto di una frase |
resolve_review_comments | Ti rimanda i commenti da rivedere, ciascuno con una nota e le righe cambiate per esso |
Il ciclo per una spec: l’agente la scrive e chiama request_review, tu commenti e clicchi Send, e l’agente corregge ogni commento e lo rimanda con resolve_review_comments. Guarda com’è nella guida a Claude Code.
Vedi ogni chiamata
Recent Requests in Settings → MCP mostra cosa ha fatto ogni assistente, in parole semplici: «Codex · Opened plans/auth.md at line 42» con un segno di spunta verde, «Searched for “rate limit” (5 matches)» oppure «Couldn't open ~/notes/a.md — no access» con una croce rossa. Passa il mouse su una riga per il percorso completo o il motivo. Technical details elenca invece le richieste HTTP grezze. L’elenco viene conservato solo finché DotMD è aperto.
Sicurezza: chi può raggiungere il server
- Il server ascolta solo su 127.0.0.1, quindi gli altri computer non possono raggiungerlo.
- Le pagine web non possono usarlo. Ogni richiesta che arriva da un browser viene rifiutata, come quella il cui indirizzo non indica questo Mac, il che ferma anche il DNS rebinding.
- Accetta solo richieste JSON, che un modulo web non può inviare.
- Non scrive mai file. Gli strumenti agiscono sulla finestra di DotMD in primo piano.
- Apre solo i file a cui DotMD ha accesso: il tuo spazio di lavoro, Download e, se l’hai consentito, la tua cartella Home. Per tutto il resto all’agente viene detto di chiederti di aggiungere la cartella allo spazio di lavoro.
Le richieste rifiutate compaiono in Recent Requests in rosso, con il motivo.
Agenti in Docker
In un container Docker, 127.0.0.1 è il container stesso, non il tuo Mac. Con Docker Desktop i container raggiungono il Mac come host.docker.internal, quindi usa questo indirizzo:
claude mcp add --transport http dotmd http://host.docker.internal:8089/mcpGli altri client usano lo stesso indirizzo nella loro configurazione. Ogni container su questo Mac può raggiungere il server così, come qualsiasi altro server che Docker Desktop lascia passare verso il tuo Mac. I computer della tua rete continuano a non poterlo fare.
Domande sul server MCP di DotMD
Altri computer possono raggiungere il server MCP di DotMD?
No. Ascolta solo su 127.0.0.1. I container Docker su questo Mac possono, tramite host.docker.internal.
Una pagina web può usarlo?
No. Le richieste da un browser vengono rifiutate, e si accettano solo richieste JSON da questo Mac.
Il server scrive i miei file?
No. Non scrive mai file; agisce sulla finestra di DotMD in primo piano.
La porta 8089 è occupata.
Cambia la porta in Settings → MCP, spegni e riaccendi il server, e aggiorna l’indirizzo nel tuo agente.