DotMD — это MCP-сервер.Ваши агенты видят то, что вы читаете.

Включите MCP-сервер для Markdown

Это MCP-сервер для работы с вашими Markdown-файлами в DotMD: открывать их, читать, что вы комментируете, и проверять, что пишет агент. Это не конвертер, который превращает другие форматы в Markdown. Всё делается в Settings → MCP:

• MCP server запускает сервер. Статус вверху становится зелёным и показывает Listening.
• Start with DotMD запускает его при каждом старте DotMD.
• Port по умолчанию 8089. После смены порта выключите и снова включите сервер.
• Адрес, http://127.0.0.1:8089/mcp, показан вверху, рядом кнопка копирования.

Сервер работает, пока открыт DotMD. Если закрыть DotMD, агент до него не достучится.

Подключите агента к MCP-серверу

Добавьте адрес сервера один раз так, как это делается в вашем агенте.

Claude Code

Выполните это в Терминале. Подробности в руководстве по Claude Code.

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

Codex

В приложении Codex откройте Settings → MCP servers → Add server и выберите Streamable HTTP или добавьте это в ~/.codex/config.toml. Строка tool_timeout_sec позволяет Codex ждать, пока вы смотрите. Подробнее в руководстве по Codex.

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

Cursor, Visual Studio Code и другие

Добавьте сервер с такой конфигурацией. Шаги описаны в руководстве по Cursor.

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

Что агент может делать с DotMD

Сервер даёт агенту двенадцать инструментов:

Цикл для спеки: агент пишет её и вызывает request_review, вы комментируете и нажимаете Send, а агент исправляет каждый комментарий и возвращает его через resolve_review_comments. Как это выглядит, показано в руководстве по Claude Code.

Вы видите каждый вызов

Recent Requests в Settings → MCP простыми словами показывает, что сделал каждый ассистент: «Codex · Opened plans/auth.md at line 42» с зелёной галочкой, «Searched for “rate limit” (5 matches)» или «Couldn't open ~/notes/a.md — no access» с красным крестиком. Наведите курсор на строку, чтобы увидеть полный путь или причину. Technical details вместо этого показывает сырые HTTP-запросы. Список хранится, только пока открыт DotMD.

Безопасность: кто может достучаться до сервера

• Сервер слушает только 127.0.0.1, поэтому другие компьютеры до него не достучатся.
• Веб-страницы им воспользоваться не могут. Любой запрос из браузера отклоняется, как и запрос, адрес которого не указывает на этот Mac, что заодно защищает от DNS rebinding.
• Принимаются только JSON-запросы, которые веб-форма отправить не может.
• Он никогда не записывает файлы. Инструменты действуют на переднее окно DotMD.
• Он открывает только файлы, к которым у DotMD есть доступ: рабочее пространство, «Загрузки» и, если вы разрешили, домашнюю папку. Для всего остального агенту сказано попросить вас добавить папку в рабочее пространство.

Отклонённые запросы показываются в Recent Requests красным с указанием причины.

Агенты в Docker

Внутри контейнера Docker 127.0.0.1 — это сам контейнер, а не ваш Mac. В Docker Desktop контейнеры обращаются к Mac по адресу host.docker.internal, поэтому используйте его:

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

Другие клиенты берут тот же адрес в своей конфигурации. Любой контейнер на этом Mac может достучаться до сервера таким образом, как и до любого другого сервера, который Docker Desktop пропускает к вашему Mac. Компьютеры в вашей сети по-прежнему не могут.

Вопросы о MCP-сервере DotMD

Другие вопросы