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_files | Markdown-файли вашого робочого простору з їхніми заголовками |
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, вимкніть і знову ввімкніть сервер та оновіть адресу у своєму агентові.