Excel MCP от haris-musa позволяет агенту править локальную книгу без установленного Microsoft Excel. Подключите отдельную папку с копией, а результат проверьте по данным и формулам: сохранённый файл ещё не означает правильный расчёт.
Для локальной книги порядок такой: поручили, отдельно сверили, приняли. Повторную проверку никто не отменял.
Что такое Excel MCP и какой сервер вам нужен
Под названием Excel MCP встречаются разные серверы. Выбирайте по задаче: управлять приложением Excel или читать и править файл.
| Реализация | Как работает и что требуется | Откуда значение формулы |
|---|---|---|
| haris-musa | Файлы через openpyxl; Windows, macOS, Linux; uv. Excel серверу не нужен | Сохранённый результат Excel; при его отсутствии - встроенный калькулятор |
| sbroenne | Приложение Excel; Windows с рабочим столом, Excel 2016+, PowerShell 7.4+, VS Code 1.125+, Copilot Chat с инструментами | Вычисляет приложение Excel |
| negokaz | Пакет @negokaz/excel-mcp-server, Node.js 20.x+. Правка в открытом приложении и снимки экрана - только Windows | showFormula показывает текст формулы, но не подтверждает свежий пересчёт |
У Aspose свой пакет aspose.cells.mcp. Не считайте его WORK_DIR таким же ограничением доступа, как --allow-dir haris-musa.
Для локальной копии дальше используем haris-musa. Если нужно только прочитать документ в чате, давать агенту право менять файл не нужно.
Если хотите обсудить, как поручать работу ИИ-агентам и проверять результат, заходите в канал:
Как ограничить доступ папкой и подключить сервер
Не копируйте настройки MCP из случайного поста в телеге какого-нибудь блогера. Для Cursor берите настройки из README выбранного сервера.
- Положите несекретную копию
.xlsxв отдельную папку. Оригинал оставьте снаружи. Проверьте, что uv доступен; команда запуска -uvx excel-mcp-server stdio. - В
~/.cursor/mcp.jsonдобавьте серверexcelвнутриmcpServers, сохранив остальные подключения:
Поле сервера excel | Значение |
|---|---|
command | "uvx" |
args | ["excel-mcp-server", "stdio", "--allow-dir", "/path/to/workbooks", "--read-only"] |
Замените шаблон /path/to/workbooks абсолютным путём своей папки. --allow-dir разрешает доступ к книгам в ней и подпапках. Без него в stdio сервер работает с книгами по любым абсолютным путям.
- Подключите сервер в Cursor. Через Excel MCP запросите чтение существующей несекретной тестовой книги вне разрешённой папки. Сервер должен отказать. Если книга прочитана, остановитесь и исправьте ограничение.
- Оставьте
--read-only, пока не сохраните исходные данные и формулы. Перед правкой уберите только этот аргумент и переподключите сервер.--allow-dirоставьте.
Ограничение папкой относится к этому серверу, не ко всем инструментам агента. Для Claude Code есть отдельный разбор подключений и прав MCP. Содержимое ячеек считайте данными, а не командами, которые агент должен выполнять.
Локальный файл не означает, что данные не уйдут модели. Проверьте правила Cursor и своего провайдера, передавайте только разрешённые организацией данные. Например, sbroenne предупреждает: результаты книги возвращаются ассистенту и подпадают под его политику конфиденциальности. Для работающих в Claude Code - отдельный разбор безопасности данных.
Дайте агенту задачу: что менять и чего не трогать
До записи попросите агента вызвать describe_workbook, describe_sheet и read_range. Сохраните отдельно структуру книги, исходные значения и тексты затрагиваемых формул для сравнения после правки.
Заполните поручение:
Путь копии: впишите путь внутри разрешённой папки.
Лист: точное имя из описания книги.
Диапазон: реальные адреса ячеек.
Изменение: что записать или какую формулу изменить.
Запреты: не менять оригинал, другие листы, исходные данные и области вне задания. Допишите свои ограничения.
Если задание непонятно, агент должен уточнить его, а не решать сам, что ещё поменять.
Включите запись и поручите правку через write_range. Потребуйте путь результата, изменённые листы и диапазоны, отчёт «как было / как стало» и список того, что осталось проверить руками.
Файл сохранился. А формулы правильные?
Сообщения агента «готово» для приёмки мало. Сравните изменённую копию с исходным состоянием и заданием.
| Что проверяем | С чем сравниваем | Когда возвращаем на исправление |
|---|---|---|
| Границы изменений | Задание, исходное состояние, фактически изменённые листы и диапазоны | Есть несогласованная правка или её границы нельзя установить |
| Исходные данные и структура вне задания | Значения, строки и листы до правки | Данные подменены или потеряны, строки и листы изменены без разрешения |
| Текст и ссылки формул | Исходные формулы и правило изменения | Формула ссылается не туда, расходится с заданием или заменена постоянным значением |
| Расчётные значения | Независимый расчёт из исходных данных | Есть расхождение, непонятно, как получено число, либо вместо расчёта получен null |
Откуда берётся число? В read_range режим values сначала берёт результат, сохранённый Excel. Это не новый пересчёт всей книги.
Если сохранённого результата нет, формулу считает встроенный калькулятор haris-musa. Если функция не поддерживается, есть циклическая ссылка или калькулятор не может воспроизвести поведение Excel, сервер возвращает null. Причина попадает в uncalculated. Подставлять вместо этого 0 нельзя.
Посчитайте ожидаемое значение отдельно из исходных данных. Excel вычисляет формулы при открытии книги: если важна совместимость с ним, откройте копию и проверьте расчёт. Поддержку формул другой программой проверяйте отдельно.
trace_formula использует тот же калькулятор и независимой проверкой не служит.
После вставки строк или переименования листов сверяйте ссылки в формулах: число может выглядеть правильным, но быть посчитано не по тем ячейкам.
Кстати, я снял ролик о подключениях и проверке работы агента, обязательно посмотрите.
В нём показываю, какие права давать агенту, как выбирать MCP и проверять работу на разных моделях.
Принимайте копию, когда правка соответствует заданию, данные сохранены, формулы верны, значения проверены и расхождений нет. Сохраните проверенную копию. Заменять ли оригинал, решаете вы.
Если хотите собирать свои проекты с ИИ-агентами, посмотрите программу практикума СмыслоКода.
Что ещё сервер меняет в книге и что проверять после правки
Для оформления есть format_range, для листов - создание и переименование, для диаграмм - create_chart. create_pivot_table создаёт сводную по снимку данных; по актуальным исходным данным её обновляет Excel.
При вставке и удалении строк или столбцов, переименовании листа сервер обновляет ссылки, но не все: например, 3D-ссылки и цели гиперссылок остаются прежними. Правку, которая затрагивает формулу массива, сводную или заголовок таблицы, сервер отклоняет. При изменении подписанного файла цифровая подпись удаляется.
Поддерживаются .xlsx, .xlsm, .xltx, .xltm. Старый .xls не поддерживается. Сервер не запускает макросы; для обычной правки .xlsx включать запись VBA не требуется.
Второй агент: ничего ли не забыли, ничего ли не потеряли
Второй агент становится проверяющим, когда получает другой способ проверить истину. Передайте ему исходное состояние, копию и задание. Доступ к исходнику организуйте отдельно, только для чтения. Не добавляйте его в разрешённую папку исполнителя. Проверяющему оставьте --read-only.
Сравни исходник и изменённую копию по заданию. Ничего не исправляй. Для каждого расхождения укажи лист, ячейку или диапазон, ожидание, факт и способ проверки. Отдельно перечисли вычисления, которые подтвердить не удалось.
Для расчётов задайте другой способ проверки, а не повторное чтение того же сохранённого числа.
Находки проверяющих перепроверяйте сами - они путают строки и цифры. По таблице выше решайте: принимаете копию или возвращаете на исправление.
Частые вопросы
Какую правку своей книги вы бы поручили агенту и как проверили бы результат? Напишите в комментариях в канале.
Источники
- haris-musa: Excel MCP Server - подключение, права, инструменты и расчёт формул.
- sbroenne: Excel MCP Server - требования, вычисления в Excel и приватность.
- negokaz: Excel MCP Server - Node.js, возможности Windows и
showFormula. - Aspose: Excel MCP - пакет
aspose.cells.mcpи настройки.
Новые материалы - дайджестом, без спама
Гайды выходят регулярно. Подпишись, чтобы не пропускать: пришлю подборку в Telegram или на email. Раз в неделю или каждый день - выбираешь сам.

