Что сможет агент
- Прочитает договор или коммерческое предложение в Word и выпишет условия: суммы, сроки оплаты, пени, как расторгнуть. Заголовки, списки и таблицы сохраняются.
- Разложит прайс-лист или выгрузку из Excel по листам в таблицы, и агент посчитает выручку, найдёт лидеров продаж и то, что заканчивается на складе.
- Достанет из презентации PowerPoint заголовки слайдов, текст, таблицы, данные диаграмм и заметки докладчика: готовая основа для поста или письма.
- Прочитает PDF-отчёт с текстовым слоем для выжимки: русский текст приходит целиком, таблицы - столбцами подряд.
- Откроет страницу сайта и отдаст её текстом с таблицами, например таблицу валют с сайта ЦБ.
- Кто сделал
- Microsoft
- Версия
- 0.0.1a7
- Проверено
- 28.09.2026, Claude Code
- Лицензия
- MIT
Подключить
Промпт собран из паспорта: команды в нём те же, что во вкладках Claude Code и Codex.
Подключи MCP-сервер «MarkItDown» версии 0.0.1a7. Работай по шагам и после каждого коротко говори, что сделал.
Данные сервера (каталог code.tarasovweb.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». Попроси меня перезапустить сессию. У сервера один инструмент, назови его. Сделай пробный запрос: «Преврати в Markdown страницу https://www.cbr.ru/currency_base/daily/ и покажи, сколько сегодня стоят доллар, евро и юань по данным ЦБ». Покажи результат.
5. Итог одним сообщением: что добавлено и куда, статус, число инструментов, команда отката и откуда восстановить копию конфига. Откат: `claude mcp remove markitdown --scope user` (в Codex: `codex mcp remove markitdown`).
Если на любом шаге ошибка, не чини наугад. Покажи текст ошибки и скажи, что, по-твоему, случилось. Частые проблемы: https://code.tarasovweb.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 и отдаёт текст с заголовками, нумерованными и маркированными списками, жирным шрифтом и таблицами.
- Агент читает этот текст и выписывает условия со ссылками на пункты.
Прочитай договор [полный путь к файлу .docx] через MarkItDown: вызови convert_to_markdown с адресом file:// и полным путём к файлу. Выпиши условия списком: предмет, суммы и порядок оплаты, сроки, пени и штрафы, как расторгнуть договор. Рядом с каждым условием укажи номер пункта. Отдельно отметь пункты, которые невыгодны мне как [заказчику или исполнителю], и объясни почему.Бесплатно: почта или сразу Телеграм-канал клуба
- Совет. В таблице из Word первой идёт пустая строка шапки, а названия столбцов стоят строкой ниже: так выглядит ответ сервера.
- Совет. Путь к файлу с русскими буквами и пробелами можно передавать как есть.
Что изменилось во второй версии договора
Агент прочитает обе версии договора и перечислит каждое изменение: было, стало, чем это грозит тебе. На проверке в тексте нашлись все восемь правок второй версии: суммы, предоплата, пени, срок предупреждения о расторжении, новый пункт.
- Два вызова convert_to_markdown, по одному на файл.
- Номера пунктов и строки таблиц сохраняются, поэтому агент сравнивает тексты по пунктам.
Прочитай через MarkItDown две версии договора: [полный путь к старой версии .docx] и [полный путь к новой версии .docx]. Сравни их пункт за пунктом и выпиши каждое изменение таблицей: пункт, было, стало, чем это грозит мне как [заказчику или исполнителю]. Не пропускай новые и удалённые пункты.Бесплатно: почта или сразу Телеграм-канал клуба
- Совет. Проси таблицу «было / стало»: её удобно переслать юристу или партнёру.
Прайс-лист и продажи из Excel: итоги и остатки
Агент получит каждый лист файла отдельной таблицей, посчитает выручку по товарам, назовёт лидеров продаж и то, что заканчивается на складе.
- convert_to_markdown читает все листы файла Excel и отдаёт каждый заголовком с таблицей.
- Формулы приходят готовыми числами, если файл сохранён в Excel или LibreOffice.
Прочитай через MarkItDown таблицу [полный путь к файлу .xlsx]: каждый лист придёт отдельной таблицей. Посчитай выручку по каждому товару за период, назови три самых продаваемых товара и перечисли товары, которых на складе меньше [10] штук. Итог покажи таблицей и сверь общую сумму с итоговой строкой файла, если она есть.Бесплатно: почта или сразу Телеграм-канал клуба
- Совет. Пустые ячейки приходят как NaN, числа без пробелов между разрядами: 116350 вместо 116 350.
- Совет. Если в столбце с формулами только NaN, открой файл в Excel и сохрани заново: в файле нет посчитанных значений.
Текст для поста из презентации
Агент получит заголовки слайдов, текст, таблицы, данные диаграмм и заметки докладчика и соберёт из них пост для Telegram-канала.
- Каждый слайд приходит отдельным блоком с номером, таблица остаётся таблицей, диаграмма превращается в таблицу своих данных.
- Заметки докладчика приходят под своим слайдом: там часто лежат цифры и оговорки, которых нет на экране.
Прочитай через MarkItDown презентацию [полный путь к файлу .pptx]: придут заголовки слайдов, текст, таблицы, данные диаграмм и заметки докладчика. Напиши из неё пост для Telegram-канала до 1000 знаков: главное число в первой строке, три пункта о том, что сделано, и что будет дальше. Цифры бери только из презентации.Бесплатно: почта или сразу Телеграм-канал клуба
- Совет. От картинок со слайдов приходят только подписи. Если на картинке важный текст, покажи агенту сам слайд картинкой.
Выжимка из PDF-отчёта
Агент прочитает текст отчёта и сделает выжимку: главные цифры, что сработало, проблемы, планы. Русский текст приходит целиком, таблицы из PDF - столбцами подряд.
- convert_to_markdown достаёт из PDF текстовый слой: русские буквы, числа и списки на месте.
- Заголовки и таблицы в PDF не размечены, поэтому агент собирает таблицу по порядку чисел в столбцах.
Прочитай через MarkItDown отчёт [полный путь к файлу .pdf] и сделай выжимку на пять строк: главные цифры, что сработало, какие были проблемы, что запланировано. Таблицы из PDF приходят столбцами подряд: собери их обратно по строкам и сверь итоги.Бесплатно: почта или сразу Телеграм-канал клуба
- Совет. Пришёл пустой текст - значит, это скан: дай PDF агенту напрямую, Claude Code читает сканы сам.
- Совет. Для пачки отчётов MarkItDown бережёт память агента: модель получает только текст, без картинки каждой страницы.
Данные со страницы сайта таблицей
Агент прочитает страницу и соберёт нужные данные в таблицу. На проверке страница ЦБ с официальной стоимостью валют пришла целиком: таблица из 54 валют с кодами и рублёвой стоимостью вместе с меню сайта.
- convert_to_markdown скачивает страницу и превращает её в текст с таблицами и ссылками.
- Адрес запрашивает сам сервер с твоего компьютера, поэтому давай ему страницы, которым доверяешь.
Прочитай через MarkItDown страницу [адрес страницы] и собери из неё таблицу: [что нужно, например тарифы с ценами]. Меню и подвал сайта пропусти. Если сервер ответит ошибкой 403, открой страницу своим инструментом для сайтов.Бесплатно: почта или сразу Телеграм-канал клуба
- Совет. Википедия отвечает на такие запросы ошибкой 403: сервер не представляется браузером.
Пример работы
редакция, прогон при проверке 28.09.2026- Задача
- Прайс-лист и продажи за сентябрь из Excel: выручка по товарам и остатки
- Промпт
- Прочитай через MarkItDown файл prays.xlsx, посчитай выручку по товарам за сентябрь, назови три самых продаваемых и товары, которых на складе меньше 10 штук
- Что сделал агент
- convert_to_markdown открыл файл за 23 мс: листы «Прайс» и «Продажи сентябрь» пришли двумя таблицами.
- Формулы столбца «Сумма, ₽» пришли готовыми числами, итоговая строка - 85 штук и 116350 ₽, как в самой таблице.
- Агент сложил продажи по товарам: «Лаванда» 32 250 ₽, «Хвоя» 27 090 ₽, набор «Три свечи» 21 510 ₽.
- По листу «Прайс» меньше 10 штук осталось у «Мёда и табака» (5), «Хвои» (7) и «Белого чая» (9).
- Результат
- Один вызов и 1,6 тыс. знаков текста на оба листа. Суммы по товарам сошлись с итогом файла, пустые ячейки пришли как NaN.
Инструменты
1 · описания около 0,1 тыс. токеновЖёлтым то, что агент делает от твоего имени, красным запуск команд на компьютере. Нажми на имя: покажем, что делает инструмент, и описание, которое читает агент. В Claude Code инструменты грузятся по запросу и почти не занимают память агента; в других клиентах и при своём адресе подключения (ANTHROPIC_BASE_URL) описания грузятся целиком на каждом сообщении.
Когда не нужен
Если нужно прочитать один PDF или картинку, сервер не нужен: Claude Code открывает их сам и видит текст даже на сканах, а MarkItDown из скана и картинки текст не достаёт. Сервер нужен для Word, Excel и PowerPoint: инструмент чтения Claude Code их не открывает. И для пачки PDF-отчётов, когда жалко памяти агента: по документации Anthropic каждая страница PDF стоит модели 1,5-3 тыс. токенов текста плюс картинка страницы, а сервер отдаёт только текст.
Частые проблемы
6Из 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 в США, без шифрования и с распознаванием английской речи: записи звонков и встреч с клиентами ему не давай. Страницы сайтов он скачивает сам по адресу, который выбирает агент, и в этот адрес можно дописать любой текст. Отсюда метка «Опасное сочетание»: если в чужом документе, например в договоре от партнёра, или на чужой странице спрятана команда для агента, он может прочитать твой файл и дописать его содержимое в адрес запроса к постороннему сайту. Поэтому чужие документы и страницы открывай в отдельном разговоре, где агент не работает с твоими базами клиентов и ключами, не нажимай «больше не спрашивать» для этого сервера и откажи, если агент вдруг просит открыть незнакомый сайт с длинным адресом.
- Наша проверка
- Источник - репозиторий 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: ставится ровно то, что мы проверили.
- Проверить самому
- агент прочитает код подключения как недоверенный
Полезные материалы
- Инструкция · на английскомMarkItDown MCP: исходный код и запускОфициальный источник: команды запуска, режим HTTP и предупреждения о безопасности.
- Инструкция · на английскомMarkItDown: какие форматы понимает библиотекаСписок форматов, плагины и подключение Azure Document Intelligence в самой библиотеке.
- ИнструкцияСправочник инструментов Claude CodeЧто Claude Code читает сам: картинки, PDF, блокноты Jupyter. Word, Excel и PowerPoint в этом списке нет.
- ИнструкцияПодключите Claude Code к инструментам через MCPКак Claude Code хранит подключения, передаёт переменные окружения и проверяет статус.
- Инструкция · на английскомONNX Runtime: какую статистику собирает движокПочему в команде стоит ORT_DISABLE_TELEMETRY=1 и что эта переменная выключает.
Журнал проверок
- 28.09.2026·0.0.1a7·Claude Code, macOS·работает9724f6c016a28005
Отпечаток - контрольная сумма того, что сервер отдаёт агенту. Поменялся при той же версии - поменялось поведение.
Подключения делают их авторы. Мы проверяем установку и описываем, что они умеют, но код и сервис остаются чужими. Перед установкой посмотри, какие данные получит агент.
