Excel MCP: поручил правку файла - проверь формулы и данные

Опубликовано 10.11.20266 мин чтенияСредний
Артемий Миллер в кепке с буквами ИИ рядом с надписью «ПРАВКА ИИ ПРОВЕРЬ ФОРМУЛЫ».
Что узнаешь
  • Как выбрать сервер для локальной книги Excel
  • Как ограничить доступ папкой и начать с чтения
  • Как сверить формулы и расчёты после правки
Средний
8просмотров

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+. Правка в открытом приложении и снимки экрана - только WindowsshowFormula показывает текст формулы, но не подтверждает свежий пересчёт

У Aspose свой пакет aspose.cells.mcp. Не считайте его WORK_DIR таким же ограничением доступа, как --allow-dir haris-musa.

Для локальной копии дальше используем haris-musa. Если нужно только прочитать документ в чате, давать агенту право менять файл не нужно.

Если хотите обсудить, как поручать работу ИИ-агентам и проверять результат, заходите в канал:

Как ограничить доступ папкой и подключить сервер

Не копируйте настройки MCP из случайного поста в телеге какого-нибудь блогера. Для Cursor берите настройки из README выбранного сервера.

  1. Положите несекретную копию .xlsx в отдельную папку. Оригинал оставьте снаружи. Проверьте, что uv доступен; команда запуска - uvx excel-mcp-server stdio.
  2. В ~/.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 сервер работает с книгами по любым абсолютным путям.

  1. Подключите сервер в Cursor. Через Excel MCP запросите чтение существующей несекретной тестовой книги вне разрешённой папки. Сервер должен отказать. Если книга прочитана, остановитесь и исправьте ограничение.
  2. Оставьте --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 использует тот же калькулятор и независимой проверкой не служит.

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

Кстати, я снял ролик о подключениях и проверке работы агента, обязательно посмотрите.

Видео загрузится при скролле
Полный гайд - Связка для первого агента Hermes Agent

В нём показываю, какие права давать агенту, как выбирать MCP и проверять работу на разных моделях.

Принимайте копию, когда правка соответствует заданию, данные сохранены, формулы верны, значения проверены и расхождений нет. Сохраните проверенную копию. Заменять ли оригинал, решаете вы.

Если хотите собирать свои проекты с ИИ-агентами, посмотрите программу практикума СмыслоКода.

Практикум по вайб-кодингу
+Твой второй мозг
3 вечера - инструменты, метод, первый проект
Старт 24–26 ноября  ·  2 000 ₽
Записаться →

Что ещё сервер меняет в книге и что проверять после правки

Для оформления есть format_range, для листов - создание и переименование, для диаграмм - create_chart. create_pivot_table создаёт сводную по снимку данных; по актуальным исходным данным её обновляет Excel.

При вставке и удалении строк или столбцов, переименовании листа сервер обновляет ссылки, но не все: например, 3D-ссылки и цели гиперссылок остаются прежними. Правку, которая затрагивает формулу массива, сводную или заголовок таблицы, сервер отклоняет. При изменении подписанного файла цифровая подпись удаляется.

Поддерживаются .xlsx, .xlsm, .xltx, .xltm. Старый .xls не поддерживается. Сервер не запускает макросы; для обычной правки .xlsx включать запись VBA не требуется.

Второй агент: ничего ли не забыли, ничего ли не потеряли

Второй агент становится проверяющим, когда получает другой способ проверить истину. Передайте ему исходное состояние, копию и задание. Доступ к исходнику организуйте отдельно, только для чтения. Не добавляйте его в разрешённую папку исполнителя. Проверяющему оставьте --read-only.

Сравни исходник и изменённую копию по заданию. Ничего не исправляй. Для каждого расхождения укажи лист, ячейку или диапазон, ожидание, факт и способ проверки. Отдельно перечисли вычисления, которые подтвердить не удалось.

Для расчётов задайте другой способ проверки, а не повторное чтение того же сохранённого числа.

Находки проверяющих перепроверяйте сами - они путают строки и цифры. По таблице выше решайте: принимаете копию или возвращаете на исправление.

Частые вопросы

Какую правку своей книги вы бы поручили агенту и как проверили бы результат? Напишите в комментариях в канале.

Источники

Практикум по вайб-кодингу
+Твой второй мозг
3 вечера - инструменты, метод, первый проект
Старт 24–26 ноября  ·  2 000 ₽
Записаться →

Новые материалы - дайджестом, без спама

Гайды выходят регулярно. Подпишись, чтобы не пропускать: пришлю подборку в Telegram или на email. Раз в неделю или каждый день - выбираешь сам.

Была инструкция полезна?
Артемий Миллер
Автор
Артемий Миллер
Предприниматель и вайб-кодер

Артемий Миллер - предприниматель и вайб-кодер. Бывший программист, собирает продукты исключительно вместе с ИИ-агентами, без найма разработчиков.

Связанные инструкции

ИИ для бухгалтера: собери первичку и проверь по документам

Начните с реестра обезличенных счетов и сверки каждого поля с документом. ИИ собирает черновик, бухгалтер принимает результат и разбирает нерешённые расхождения.

9 мин

ИИ для тестирования: после правки проверяем весь путь

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

8 мин

ИИ для HR: какие у человека результаты и чем они подтверждены

Поручите ИИ сводку по рабочим критериям вакансии и запросите исходный фрагмент для каждого вывода. Сверьте все выводы и все входные материалы; решение о найме оставьте человеку.

10 мин

Perplexity API: дай агенту поиск и покажи источники

Для найденных страниц выбирайте Search API, для готового ответа со ссылками - Agent API. Каждый тезис проверяйте по тексту открытого источника: сам адрес ещё ничего не доказывает.

7 мин