O DotMD é um servidor MCP.Os seus agentes veem o que está a ler.

Ative o servidor MCP para Markdown

É um servidor MCP para trabalhar com os seus ficheiros Markdown no DotMD: abri-los, ler o que comenta e rever o que o agente escreve. Não é um conversor que transforma outros formatos em Markdown. Tudo se faz em Settings → MCP:

• MCP server inicia o servidor. O estado, no topo, fica verde e mostra Listening.
• Start with DotMD inicia-o sempre que o DotMD arranca.
• Port é 8089 por predefinição. Depois de a alterar, desligue e volte a ligar o servidor.
• O endereço, http://127.0.0.1:8089/mcp, aparece no topo, com um botão para o copiar.

O servidor funciona enquanto o DotMD estiver aberto. Se fechar o DotMD, o agente não o alcança.

Ligue o seu agente ao servidor MCP

Adicione o endereço do servidor uma só vez, da forma que o seu agente usa.

Claude Code

Execute isto no Terminal. Os detalhes estão no guia do Claude Code.

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

Codex

Na app do Codex abra Settings → MCP servers → Add server e escolha Streamable HTTP, ou adicione isto a ~/.codex/config.toml. A linha tool_timeout_sec deixa o Codex esperar enquanto revê. Mais no guia do Codex.

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

Cursor, Visual Studio Code e outros

Adicione um servidor com esta configuração. O guia do Cursor tem os passos.

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

O que o agente pode fazer com o DotMD

O servidor dá ao agente doze ferramentas:

O ciclo para uma spec: o agente escreve-a e chama request_review, você comenta e clica em Send, e o agente corrige cada comentário e devolve-o com resolve_review_comments. Veja como é no guia do Claude Code.

Vê cada chamada

Recent Requests em Settings → MCP mostra o que cada assistente fez, em palavras simples: «Codex · Opened plans/auth.md at line 42» com um visto verde, «Searched for “rate limit” (5 matches)» ou «Couldn't open ~/notes/a.md — no access» com uma cruz vermelha. Passe o rato por uma linha para ver o caminho completo ou o motivo. Technical details lista, em vez disso, os pedidos HTTP em bruto. A lista só é guardada enquanto o DotMD estiver aberto.

Segurança: quem consegue chegar ao servidor

• O servidor só escuta em 127.0.0.1, por isso outros computadores não o alcançam.
• As páginas web não o podem usar. Qualquer pedido que venha de um navegador é recusado, tal como um pedido cujo endereço não indique este Mac, o que também impede o DNS rebinding.
• Só aceita pedidos JSON, que um formulário web não consegue enviar.
• Nunca escreve ficheiros. As ferramentas atuam na janela do DotMD em primeiro plano.
• Só abre ficheiros a que o DotMD tem acesso: o seu espaço de trabalho, Transferências e, se o permitiu, a sua pasta pessoal. Para tudo o resto, o agente é instruído a pedir-lhe que adicione a pasta ao espaço de trabalho.

Os pedidos recusados aparecem em Recent Requests a vermelho, com o motivo.

Agentes no Docker

Dentro de um contentor Docker, 127.0.0.1 é o próprio contentor, não o seu Mac. Com o Docker Desktop, os contentores chegam ao Mac como host.docker.internal, por isso use esse endereço:

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

Outros clientes usam o mesmo endereço na sua configuração. Todos os contentores neste Mac conseguem chegar ao servidor assim, como a qualquer outro servidor que o Docker Desktop deixe passar até ao seu Mac. Os computadores da sua rede continuam sem conseguir.

Perguntas sobre o servidor MCP do DotMD

Mais perguntas