Экономия токенов в Claude: настройка MarkItDown MCP

Это пошаговая инструкция по настройке бесплатной утилиты MarkItDown от Microsoft и её подключению к Claude Desktop через протокол MCP (Model Context Protocol). Материал предназначен для предпринимателей и специалистов, которые анализируют в Claude договоры, отчеты и таблицы, но не хотят переплачивать за двойную тарификацию токенов при загрузке документов.

Зачем нужен MarkItDown

Когда ты отправляешь обычный PDF-файл в Claude, сервис сначала превращает каждую страницу в изображение, а затем параллельно извлекает из нее текстовые строки. В результате лимиты расходуются за два формата сразу, и стандартный договор на 20 страниц может списать до 60 000 токенов еще до отправки первого вопроса.

Утилита MarkItDown очищает файл от графического мусора и переводит PDF, DOCX, XLSX и PPTX в чистый Markdown. При этом полностью сохраняется структура заголовков и таблиц, а Claude получает только форматированный текст, что снижает расход токенов в 2–3 раза.

Пошаговое подключение MCP-сервера в Claude

1. Установка Python и пакета MarkItDown MCP

Открой консоль (Терминал на macOS или Командную строку / PowerShell на Windows). Убедись, что в системе установлен Python версии 3.10 или новее. Введи команду для установки MCP-сервера:

   pip install markitdown-mcp

Если ты планируешь обработку сложных таблиц Excel и офисных документов, установи расширенный набор зависимостей:

   pip install markitdown-mcp "markitdown[all]"

После выполнения команды в окне консоли появится сообщение об успешной установке пакетов.

1. Переход к файлу конфигурации Claude Desktop

Найди конфигурационный файл Claude Desktop по следующему пути на компьютере:

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Если файл claude_desktop_config.json отсутствует в папке, создай пустой текстовый файл с таким именем.

1. Настройка параметров подключения

Открой файл claude_desktop_config.json в текстовом редакторе и вставь конфигурацию сервера:

   {
     "mcpServers": {
       "markitdown": {
         "command": "markitdown-mcp",
         "args": []
       }
     }
   }

Если в файле уже прописаны другие MCP-серверы, добавь блок "markitdown" внутрь существующего объекта "mcpServers". Сохрани изменения и закрой редактор.

1. Перезапуск Claude Desktop и работа с документами

Заверши работу Claude Desktop и запусти приложение заново. В нижней панели чата станет активен значок подключенного MCP-сервера.

Теперь при передаче файла Claude самостоятельно задействует утилиту MarkItDown и обработает чистый Markdown без генерации тяжелых изображений страниц.

Если нужно конвертировать документ вручную в файл .md без запуска Claude, используй базовую команду:

   pip install markitdown
   markitdown contract.pdf > contract.md

Лимиты и нюансы

• Сканированные документы: Инструмент предназначен для работы с текстовыми PDF и стандартными файлами Office. Если PDF-файл представляет собой скан без распознанного текстового слоя, базовый MarkItDown не сможет извлечь текст без подключения дополнительных модулей распознавания (OCR).
• Платформа: Локальные MCP-серверы работают только в десктопном клиенте Claude Desktop на Windows и macOS. В веб-интерфейсе claude.ai локальные MCP-серверы пока не поддерживаются.
• Системные требования: Требуется установленный интерпретатор Python 3.10+ и корректно настроенные пути к исполняемым файлам в переменной окружения PATH.
• Стоимость: MarkItDown распространяется бесплатно с открытым исходным кодом на GitHub (https://github.com/microsoft/markitdown) под лицензией MIT.

Что дальше

Автоматизация подготовки файлов — лишь один из базовых шагов по снижению расходов на ИИ. Системный подход предполагает интеграцию нейросетей непосредственно в регламенты, CRM и рабочие процессы всей компании. Чтобы выстроить и внедрить ИИ-систему под задачи своего бизнеса, напиши в директ @ii.systema слово «система».