DotMD — це MCP-сервер.Ваші агенти бачать те, що ви читаєте.

DotMD запускає на вашому Mac локальний MCP-сервер. Claude Code, Codex, Cursor чи будь-який MCP-клієнт може відкривати ваші Markdown-файли, читати ваше виділення й коментарі, вказувати на рядки та надсилати вам специфікацію на рев'ю.

macOS 14 або новіша. Читати можна безкоштовно; DotMD Pro має 3-денний безкоштовний пробний період.

Коротко

Settings → MCP → MCP server запускає його за адресою http://127.0.0.1:8089/mcp. Додайте цю адресу у свій агент один раз. Після цього агент зможе відкривати файли в DotMD, читати ваше виділення й коментарі, підсвічувати рядки та надсилати вам документ на рев'ю. Рев'ю та інструменти для агентів входять у DotMD Pro (3 дні безкоштовно); читання залишається безкоштовним.

Увімкніть 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

Сервер дає агентові дванадцять інструментів:

ІнструментЩо робить
open_fileВідкриває файл або теку в DotMD, за бажання на потрібному рядку, який підсвічується
request_reviewНадсилає вам на рев'ю документ, написаний агентом, і чекає, доки ви не натиснете Send або Approve
get_current_fileЯкий файл відкрито, його заголовок, режим і розділ, який ви читаєте
get_selectionТекст, який ви виділили, з номерами рядків
highlightПрокручує до рядків і підсвічує їх на кілька секунд
show_changesПоказує правки агента поруч із коментарями або в історії версій
list_filesMarkdown-файли вашого робочого простору з їхніми заголовками
searchШукає в тексті всіх файлів робочого простору
get_review_commentsКоментарі до файлу: ваші чи агента-рецензента
add_review_commentsЗалишає коментарі до рядків файлу як рецензент, під іменем агента
complete_reviewПовідомляє, що агент-рецензент закінчив, з його вердиктом і коротким підсумком в одне речення
resolve_review_commentsПовертає вам коментарі на перевірку, кожен із приміткою та рядками, зміненими через нього

Цикл для специфікації: агент пише її й викликає 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

Чи можуть інші комп'ютери дістатися до MCP-сервера DotMD?

Ні. Він слухає лише 127.0.0.1. Контейнери Docker на цьому Mac можуть, через host.docker.internal.

Чи може ним скористатися вебсторінка?

Ні. Запити з браузера відхиляються, приймаються лише JSON-запити з цього Mac.

Чи записує сервер мої файли?

Ні. Він ніколи не записує файли, а діє на переднє вікно DotMD.

Порт 8089 зайнятий.

Змініть порт у Settings → MCP, вимкніть і знову ввімкніть сервер та оновіть адресу у своєму агентові.

Інші запитання