СмыслоКод

MarkItDown

Официальный

Microsoft · лицензия MIT

Агент прочитает твои Word, Excel, PowerPoint и PDF: договоры, прайс-листы, презентации

На твоём компьютереБез ключаРаботает из РоссииТолько читаетБесплатноДанные уходят: Google (только аудио и видео на расшифровку, документы остаются на компьютере), СШАЧитает тексты посторонних: веб-страницы, чужие документыОпасное сочетаниеПерсональные данные клиентов могут уйти за границу

✓ Проверено 28.09.2026 на версии 0.0.1a7 в Claude Code (macOS) · 1 инструмент

Подключить ↓Что можно сделать ↓

Что сможет агент

  • Прочитает договор или коммерческое предложение в Word и выпишет условия: суммы, сроки оплаты, пени, как расторгнуть. Заголовки, списки и таблицы сохраняются.
  • Разложит прайс-лист или выгрузку из Excel по листам в таблицы, и агент посчитает выручку, найдёт лидеров продаж и то, что заканчивается на складе.
  • Достанет из презентации PowerPoint заголовки слайдов, текст, таблицы, данные диаграмм и заметки докладчика: готовая основа для поста или письма.
  • Прочитает PDF-отчёт с текстовым слоем для выжимки: русский текст приходит целиком, таблицы - столбцами подряд.
  • Откроет страницу сайта и отдаст её текстом с таблицами, например таблицу валют с сайта ЦБ.

Паспорт

Кто сделал
Microsoft
Статус
Официальный
Лицензия
MIT
Проверено
28.09.2026
Версия
0.0.1a7
Где работает
На твоём компьютере
Доступ
Без ключа
Россия
Работает из России
Данные
Данные уходят: Google (только аудио и видео на расшифровку, документы остаются на компьютере), США
Цена
Бесплатно
Проверено в
Claude Code
Исходный код
github.com/microsoft/markitdown/tree/main/packages/markitdown-mcp
Документация
github.com/microsoft/markitdown/blob/main/packages/markitdown-mcp/README.md

Подключить

Промпт собран из паспорта: команды в нём те же, что во вкладках Claude Code и Codex.

Промпт для агента
Подключи MCP-сервер «MarkItDown» версии 0.0.1a7. Работай по шагам и после каждого коротко говори, что сделал.

Данные сервера (каталог smyslokod.ru, проверено 28.09.2026):
- имя в конфиге: markitdown
- официальный источник: https://github.com/microsoft/markitdown/tree/main/packages/markitdown-mcp
- запуск: uvx markitdown-mcp@0.0.1a7
- переменные окружения сервера: ORT_DISABLE_TELEMETRY=1, UV_PYTHON=3.12

Правила:
1. Не ставь Node.js, uv или Docker без моего «да». Не хватает - остановись и скажи, что поставить и откуда.
2. Ставь только пакет или адрес из этого промпта. Никаких установочных скриптов из README без моего подтверждения.
3. Перед правкой конфига сделай его резервную копию.

Шаги:
0. Определи, кто ты (Claude Code, Codex или другой агент) и какая у меня система.
1. Проверь окружение: uv --version (нужен uv). Скажи, что нашёл.
2. Проверь, нет ли уже сервера с таким именем: `claude mcp get markitdown` (в Codex: `codex mcp list`).
3. Подключи сервер:
   Claude Code: claude mcp add --scope user --env 'ORT_DISABLE_TELEMETRY=1' --env 'UV_PYTHON=3.12' --transport stdio markitdown -- uvx markitdown-mcp@0.0.1a7
   Codex: codex mcp add markitdown --env 'ORT_DISABLE_TELEMETRY=1' --env 'UV_PYTHON=3.12' -- uvx markitdown-mcp@0.0.1a7
   Если ты не Claude Code и не Codex, подключи способом, принятым у тебя, с той же командой запуска.
4. Проверка: `claude mcp list` (в Codex: `codex mcp list`), статус должен быть «Connected». Попроси меня перезапустить сессию. Перечисли инструменты сервера, их около 1. Сделай пробный запрос: «Преврати в Markdown страницу https://www.cbr.ru/currency_base/daily/ и покажи, сколько сегодня стоят доллар, евро и юань по данным ЦБ». Покажи результат.
5. Итог одним сообщением: что добавлено и куда, статус, число инструментов, команда отката и откуда восстановить копию конфига. Откат: `claude mcp remove markitdown --scope user` (в Codex: `codex mcp remove markitdown`).

Если на любом шаге ошибка, не чини наугад. Покажи текст ошибки и скажи, что, по-твоему, случилось. Частые проблемы: https://smyslokod.ru/mcp/markitdown#problemy
  • Выполнят Claude Code, Codex, Hermes и любой агент с доступом к терминалу.

Что нужно на компьютере: uv (менеджер пакетов Python).

Ключ: не нужен.

Нужен uv. Первый запуск скачивает около 70 пакетов и длится до минуты, дальше сервер стартует меньше чем за секунду. Две переменные в команде: ORT_DISABLE_TELEMETRY=1 выключает статистику, которую движок onnxruntime внутри сервера по умолчанию отправляет в Microsoft с Mac и Linux; UV_PYTHON=3.12 запускает сервер на Python 3.12, потому что на Mac с процессором Intel и на macOS 13 и более ранних для Python 3.14 нет сборки onnxruntime (нет Python 3.12 - uv скачает его сам). Для Mac с процессором Intel есть оговорка и на 3.12: библиотеку cryptography uv собирает из исходников, потому что готовой сборки под Intel у неё с июня 2026 года нет, установка там дольше и может не получиться. Файл агент передаёт адресом: file:// и полный путь. Плагины выключены (включает переменная MARKITDOWN_ENABLE_PLUGINS=true), Azure Document Intelligence через этот сервер не подключается.

Проверь, что работает

Пробный запрос

Преврати в Markdown страницу https://www.cbr.ru/currency_base/daily/ и покажи, сколько сегодня стоят доллар, евро и юань по данным ЦБ

Что должно получиться: Агент вызовет convert_to_markdown и покажет таблицу валют ЦБ на сегодня: код, название, стоимость в рублях.

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

6 сценариев
Наш прогон: слева страница вымышленного договора в Word, справа текст, который вернул convert_to_markdown, с заголовками, таблицей этапов оплаты и списками

Условия из договора в Word

Агент прочитает договор или коммерческое предложение и выпишет условия: суммы и этапы оплаты, сроки, пени и штрафы, как расторгнуть. Нумерация пунктов и таблицы приходят вместе с текстом.

  1. convert_to_markdown открывает файл Word и отдаёт текст с заголовками, нумерованными и маркированными списками, жирным шрифтом и таблицами.
  2. Агент читает этот текст и выписывает условия со ссылками на пункты.
Промпт
Прочитай договор [полный путь к файлу .docx] через MarkItDown: вызови convert_to_markdown с адресом file:// и полным путём к файлу. Выпиши условия списком: предмет, суммы и порядок оплаты, сроки, пени и штрафы, как расторгнуть договор. Рядом с каждым условием укажи номер пункта. Отдельно отметь пункты, которые невыгодны мне как [заказчику или исполнителю], и объясни почему.

Бесплатно: почта или сразу Телеграм-канал клуба

  • Совет. В таблице из Word первой идёт пустая строка шапки, а названия столбцов стоят строкой ниже: так выглядит ответ сервера.
  • Совет. Путь к файлу с русскими буквами и пробелами можно передавать как есть.

Что изменилось во второй версии договора

Агент прочитает обе версии договора и перечислит каждое изменение: было, стало, чем это грозит тебе. На проверке в тексте нашлись все восемь правок второй версии: суммы, предоплата, пени, срок предупреждения о расторжении, новый пункт.

  1. Два вызова convert_to_markdown, по одному на файл.
  2. Номера пунктов и строки таблиц сохраняются, поэтому агент сравнивает тексты по пунктам.
Промпт
Прочитай через MarkItDown две версии договора: [полный путь к старой версии .docx] и [полный путь к новой версии .docx]. Сравни их пункт за пунктом и выпиши каждое изменение таблицей: пункт, было, стало, чем это грозит мне как [заказчику или исполнителю]. Не пропускай новые и удалённые пункты.

Бесплатно: почта или сразу Телеграм-канал клуба

  • Совет. Проси таблицу «было / стало»: её удобно переслать юристу или партнёру.

Прайс-лист и продажи из Excel: итоги и остатки

Агент получит каждый лист файла отдельной таблицей, посчитает выручку по товарам, назовёт лидеров продаж и то, что заканчивается на складе.

  1. convert_to_markdown читает все листы файла Excel и отдаёт каждый заголовком с таблицей.
  2. Формулы приходят готовыми числами, если файл сохранён в Excel или LibreOffice.
Промпт
Прочитай через MarkItDown таблицу [полный путь к файлу .xlsx]: каждый лист придёт отдельной таблицей. Посчитай выручку по каждому товару за период, назови три самых продаваемых товара и перечисли товары, которых на складе меньше [10] штук. Итог покажи таблицей и сверь общую сумму с итоговой строкой файла, если она есть.

Бесплатно: почта или сразу Телеграм-канал клуба

  • Совет. Пустые ячейки приходят как NaN, числа без пробелов между разрядами: 116350 вместо 116 350.
  • Совет. Если в столбце с формулами только NaN, открой файл в Excel и сохрани заново: в файле нет посчитанных значений.
Наш прогон: слайды с таблицей выручки и диаграммой заказов по каналам и текст, который вернул convert_to_markdown: таблица, данные диаграммы и заметки докладчика

Текст для поста из презентации

Агент получит заголовки слайдов, текст, таблицы, данные диаграмм и заметки докладчика и соберёт из них пост для Telegram-канала.

  1. Каждый слайд приходит отдельным блоком с номером, таблица остаётся таблицей, диаграмма превращается в таблицу своих данных.
  2. Заметки докладчика приходят под своим слайдом: там часто лежат цифры и оговорки, которых нет на экране.
Промпт
Прочитай через MarkItDown презентацию [полный путь к файлу .pptx]: придут заголовки слайдов, текст, таблицы, данные диаграмм и заметки докладчика. Напиши из неё пост для Telegram-канала до 1000 знаков: главное число в первой строке, три пункта о том, что сделано, и что будет дальше. Цифры бери только из презентации.

Бесплатно: почта или сразу Телеграм-канал клуба

  • Совет. От картинок со слайдов приходят только подписи. Если на картинке важный текст, покажи агенту сам слайд картинкой.

Выжимка из PDF-отчёта

Агент прочитает текст отчёта и сделает выжимку: главные цифры, что сработало, проблемы, планы. Русский текст приходит целиком, таблицы из PDF - столбцами подряд.

  1. convert_to_markdown достаёт из PDF текстовый слой: русские буквы, числа и списки на месте.
  2. Заголовки и таблицы в PDF не размечены, поэтому агент собирает таблицу по порядку чисел в столбцах.
Промпт
Прочитай через MarkItDown отчёт [полный путь к файлу .pdf] и сделай выжимку на пять строк: главные цифры, что сработало, какие были проблемы, что запланировано. Таблицы из PDF приходят столбцами подряд: собери их обратно по строкам и сверь итоги.

Бесплатно: почта или сразу Телеграм-канал клуба

  • Совет. Пришёл пустой текст - значит, это скан: дай PDF агенту напрямую, Claude Code читает сканы сам.
  • Совет. Для пачки отчётов MarkItDown бережёт память агента: модель получает только текст, без картинки каждой страницы.

Данные со страницы сайта таблицей

Агент прочитает страницу и соберёт нужные данные в таблицу. На проверке страница ЦБ с официальной стоимостью валют пришла целиком: таблица из 54 валют с кодами и рублёвой стоимостью вместе с меню сайта.

  1. convert_to_markdown скачивает страницу и превращает её в текст с таблицами и ссылками.
  2. Адрес запрашивает сам сервер с твоего компьютера, поэтому давай ему страницы, которым доверяешь.
Промпт
Прочитай через MarkItDown страницу [адрес страницы] и собери из неё таблицу: [что нужно, например тарифы с ценами]. Меню и подвал сайта пропусти. Если сервер ответит ошибкой 403, открой страницу своим инструментом для сайтов.

Бесплатно: почта или сразу Телеграм-канал клуба

  • Совет. Википедия отвечает на такие запросы ошибкой 403: сервер не представляется браузером.

Пример работы

Задача

Прайс-лист и продажи за сентябрь из Excel: выручка по товарам и остатки

Промпт

Прочитай через MarkItDown файл prays.xlsx, посчитай выручку по товарам за сентябрь, назови три самых продаваемых и товары, которых на складе меньше 10 штук

Что сделал агент

  1. convert_to_markdown открыл файл за 23 мс: листы «Прайс» и «Продажи сентябрь» пришли двумя таблицами.
  2. Формулы столбца «Сумма, ₽» пришли готовыми числами, итоговая строка - 85 штук и 116350 ₽, как в самой таблице.
  3. Агент сложил продажи по товарам: «Лаванда» 32 250 ₽, «Хвоя» 27 090 ₽, набор «Три свечи» 21 510 ₽.
  4. По листу «Прайс» меньше 10 штук осталось у «Мёда и табака» (5), «Хвои» (7) и «Белого чая» (9).

Результат

Один вызов и 1,6 тыс. знаков текста на оба листа. Суммы по товарам сошлись с итогом файла, пустые ячейки пришли как NaN.

Редакция, 28.09.2026 · прогон при проверке

Инструменты сервера

1

1 инструмент, описания около 0,1 тыс. токенов. В Claude Code это почти не мешает: инструменты грузятся по запросу. Если в настройках Claude Code задан свой адрес подключения (ANTHROPIC_BASE_URL), в части других клиентов и на старых моделях описания грузятся целиком и занимают место в памяти агента на каждом сообщении.

Нажми на строку, чтобы увидеть оригинальное описание: ровно его читает агент.

Когда не нужен

Если нужно прочитать один PDF или картинку, сервер не нужен: Claude Code открывает их сам и видит текст даже на сканах, а MarkItDown из скана и картинки текст не достаёт. Сервер нужен для Word, Excel и PowerPoint: инструмент чтения Claude Code их не открывает. И для пачки PDF-отчётов, когда жалко памяти агента: по документации Anthropic каждая страница PDF стоит модели 1,5-3 тыс. токенов текста плюс картинка страницы, а сервер отдаёт только текст.

Частые проблемы

Из PDF или картинки пришёл пустой текст, без ошибки

Это скан или снимок экрана: в файле нет текстового слоя, а распознавать текст на изображениях сервер не умеет. Дай файл агенту напрямую: Claude Code сам читает PDF и картинки и видит на них текст.

«Fetching the resource failed with HTTP status 403»

Сайт не пускает программы, которые не представились браузером: на проверке так ответила Википедия. Попроси агента открыть страницу своим инструментом для сайтов или сохрани страницу в браузере как файл HTML и дай его адресом file://: придёт вся страница вместе с меню.

В столбцах с формулами стоит NaN

Файл сохранила программа, которая не пересчитывает формулы, например код, который написал агент: готовых значений в файле нет. Открой файл в Excel или LibreOffice и сохрани заново или попроси агента посчитать по исходным столбцам. Пустые ячейки тоже приходят как NaN, это не ошибка.

«Unsupported URI scheme» или «Netloc must be empty or localhost»

Путь к файлу передан без file:// или с ~ вместо домашней папки. Путь передаётся адресом: file:// и полный путь, например file:///Users/имя/Documents/договор.docx. Русские буквы и пробелы в имени файла можно оставить как есть.

Агент не видит инструментов сервера

Клиент не перезапущен после подключения: Claude Code читает подключения при старте сессии. Закрой и открой сессию, потом проверь: claude mcp list.

«uvx: command not found»

Не установлен uv, менеджер пакетов Python. Поставь uv по инструкции с docs.astral.sh/uv и перезапусти клиент.

Безопасность и данные

Кто сделал
Microsoft (официальный). Исходный код: github.com/microsoft/markitdown/tree/main/packages/markitdown-mcp, лицензия MIT.
Что видит агент
Любой файл, который может открыть твоя учётная запись: сервер читает файл по полному пути, границ по папкам нет. Страницы сайтов, которые агент попросит открыть. Свои документы Word, Excel, PowerPoint и PDF сервер разбирает у тебя на компьютере и никуда не отправляет: текст получает только агент и, как всё в разговоре, передаёт модели.
Куда уходят данные
Данные уходят: Google (только аудио и видео на расшифровку, документы остаются на компьютере), США.
Что может изменить
Файлы не меняет и не удаляет. Наружу сервер ходит в двух случаях. Аудио и видео (WAV, MP3, M4A, MP4) он отправляет на расшифровку в Google в США, без шифрования и с распознаванием английской речи: записи звонков и встреч с клиентами ему не давай. Страницы сайтов он скачивает сам по адресу, который выбирает агент, и в этот адрес можно дописать любой текст. Отсюда метка «Опасное сочетание»: если в чужом документе, например в договоре от партнёра, или на чужой странице спрятана команда для агента, он может прочитать твой файл и дописать его содержимое в адрес запроса к постороннему сайту. Поэтому чужие документы и страницы открывай в отдельном разговоре, где агент не работает с твоими базами клиентов и ключами, не нажимай «больше не спрашивать» для этого сервера и откажи, если агент вдруг просит открыть незнакомый сайт с длинным адресом.
Тексты посторонних

Читает тексты посторонних: веб-страницы, чужие документы. В таком тексте могут прятаться команды для агента.

У подключения всё сразу: видит твои данные, читает тексты посторонних и может отправлять наружу. Чужой текст может заставить агента отправить твои данные.

Персональные данные клиентов могут уйти за границу
Если через подключение пойдут данные твоих клиентов, это передача за границу по 152-ФЗ: нужны согласие людей и уведомление Роскомнадзора.
Наша проверка
Источник - репозиторий microsoft/markitdown (папка packages/markitdown-mcp) и пакет markitdown-mcp в PyPI, лицензия MIT; версия 0.0.1a7 от 14.09.2026 ранняя (альфа). В базе OSV записей нет ни по пакету, ни по его зависимостям в тех версиях, которые ставит uv: проверены набор uv 0.10 (73 пакета) и набор uv 0.12 (80 версий библиотек для Mac, Windows и Linux). Описание единственного инструмента прочитано, скрытых указаний агенту нет, своих инструкций у сервера нет. Движок onnxruntime внутри сервера по умолчанию отправляет статистику в Microsoft (адрес mobile.events.data.microsoft.com) и хранит идентификатор устройства в папке ~/Library/Application Support/Microsoft/DeveloperTools/.onnxruntime. В команде каталога это выключено переменной ORT_DISABLE_TELEMETRY=1: с ней на файлах с компьютера сервер не открыл ни одного соединения и ничего не записал в домашнюю папку, там остаётся только кеш пакетов uv. Закреплена версия самого сервера, библиотеки под ним uv подбирает при первом запуске: uv 0.12 и новее ставит свежий markitdown 0.1.8 вместе с предварительной версией одной из библиотек Azure, более старый uv откатывается до markitdown 0.1.5. Библиотека magika внутри сервера при запуске читает файл .env из домашней папки, если он там есть, и берёт из него настройки: если держишь там ключи, сервер их видит, хотя сам никуда не отправляет.
Версия
В командах закреплена версия 0.0.1a7: ставится ровно то, что мы проверили.

Проверить самому

Промпт Артемия: агент прочитает код подключения как недоверенный и покажет строки, где читаются секреты, уходят данные или меняются твои настройки.

Полезные материалы

Журнал проверок

ДатаВерсияГдеИтогОтпечаток
28.09.20260.0.1a7Claude Code, macOSработает9724f6c016a28005

Отпечаток - контрольная сумма того, что сервер отдаёт агенту: инструкций, инструментов, подсказок и ресурсов. Поменялся при той же версии - поменялось поведение.

Подключения делают их авторы. Мы проверяем установку и описываем, что они умеют, но код и сервис остаются чужими. Перед установкой посмотри, какие данные получит агент.