# Office Live MCP — подробная документация [← К обзору](../README.ru.md) · [English version](DETAILS.md) · [Все инструменты](TOOLS.md) · [Руководство](GUIDE.ru.md) · [Изменения](../CHANGELOG.md) - [Статус](#статус) - [Установка, обновление, удаление](#установка-обновление-удаление) - [Что умеет](#что-умеет) - [Безопасность](#безопасность) - [Сравнение с аналогами](#сравнение-с-аналогами) - [Разработка](#разработка) ## Статус **Активно дорабатывается.** Релизы 0.x — инструменты и установщик проверены на настоящих Excel и Word, но проект продолжает развиваться. Power Query и Power Pivot/DAX запланированы на следующие релизы. Замечания и issues приветствуются. ## Установка, обновление, удаление **Что нужно:** Windows 10/11 (64-бит) и настольные Excel и/или Word. Python, git, winget и права администратора не нужны. | Шаг | Что сделать | |:---:|---| | **1** | Скачайте **установщик Windows (файл с окончанием `-setup.exe`)** со страницы [**последнего релиза**](https://github.com/mikhalchankasm/office-live-mcp/releases/latest). | | **2** | Запустите его: **Далее → Далее → Готово**. Мастер проверит Office и установит программу. При первой установке найденные агенты уже отмечены; оставьте отметки, чтобы подключить всех найденных. Выберите доступ: **полный** или **только чтение**. | | **3** | **Перезапустите агента** и попросите: *«покажи, какие книги открыты в Excel»*. | ### Обновление | Шаг | Что сделать | |:---:|---| | **1** | Скачайте новый **setup.exe** со страницы [Releases](https://github.com/mikhalchankasm/office-live-mcp/releases/latest). | | **2** | Запустите поверх существующей установки. Подключённые агенты сохраняют настройки; выбор доступа применяется только к добавляемым. По запросу мастера закройте агентов, использующих сервер. Снятая отметка отключает учтённые регистрации агента. | | **3** | Перезапустите агента. | **Удаление:** **Параметры → Приложения → Office Live MCP → Удалить**. Состояние, журналы и резервные копии конфигураций остаются. Программа находится в `%LOCALAPPDATA%\Programs\office-live-mcp\app`. В меню «Пуск → Office Live MCP» есть ярлыки **«Подключить к агентам»** и **«Проверка (doctor)»**. VS Code и проектные конфигурации подключаются через консольный ярлык. ### Тихая установка Для автоматического подключения всех найденных поддерживаемых агентов передайте скачанному установщику `/CLIENTS=detected`. Выберите `/ACCESS=full` для редактирования или `/ACCESS=readonly` для чтения; этот выбор применяется к новым подключениям. Параметры тихой установки — в [справочнике для администраторов](GUIDE.ru.md#тихая-установка-для-администраторов). Без `/CLIENTS` тихая установка не добавляет агентов, а обновление сохраняет существующие регистрации. Есть `setup --config PATH`, `--scope project --project DIR` и `setup --remove --clients zcode`. Учёт всех областей, защита чужих записей, откат и примеры — [в руководстве](GUIDE.ru.md#установка-подключения-и-обновление). Запись настроек проверяется чтением обратно; загрузка сервера клиентом требует его перезапуска. Portable-режим пока в планах; установка для всех пользователей не поддерживается. Exe пока не подписан сертификатом: SmartScreen может предупредить (*Подробнее* → *Выполнить в любом случае*), а Smart App Control или корпоративный антивирус — заблокировать запуск. Из исходников: `install.cmd` в клоне репозитория или `pip install .` и `python -m office_live setup` — см. [руководство](GUIDE.ru.md). ### Для администраторов: запасной ZIP В релизе также есть **`office-live-mcp-<версия>-win64.zip`**. Распакуйте архив целиком и запустите `install.cmd` (или `install.cmd --yes --clients none`). Обновление использует запомненную папку; для своей папки есть `--target`. Установки 0.4.x из ZIP можно обновить setup.exe без изменения пути `app\office-live-mcp.exe` в конфигах агентов. После перехода на setup.exe обновляйте программу новым setup.exe. ## Что умеет 130 инструментов, включая опциональный Python, в наборах, которые можно включать и выключать (`OFFICE_LIVE_TOOLSETS`); каталог — [TOOLS.md](TOOLS.md). `word_reload_document(document, discard_changes=false)` закрывает документ без сохранения и открывает тот же путь в том же экземпляре Word, сохраняя режим read-only и положение окна. Несохранённые правки требуют явного discard_changes=true. Действуют проверки разрешённых папок, AutoSave и защиты. Пока документ открыт, Word блокирует файл, и другие программы не могут его перезаписать. История отмены старого экземпляра сбрасывается; ответ содержит новое имя и ссылки. При ошибке открытия откройте указанный путь вручную. В режиме readonly сервера инструмент недоступен. | Набор | Главное | |---|---| | Excel | **импорт CSV/JSON с текстовыми столбцами и оформлением**, чтение и запись диапазонов, **сравнение по позиции или ключу**, **очистка текстов, даты по явному формату и разбиение столбца с предпросмотром/отменой**, **трассировка формул с указанием неполноты**, **защита листа/книги, подбор параметра, одно- и двухфакторные таблицы данных и сценарии с отменой, промежуточные итоги и спарклайны**, формулы (A1, R1C1, динамические массивы), оформление, условное форматирование, проверка данных, сортировка и фильтр, скрытие и группировка строк, имена, умные таблицы, **сводные таблицы с фильтрами, срезами и временными шкалами**, диаграммы, профиль данных, поиск проблем, чертёж листа, снимок диапазона в PNG | | Word | **возврат открытого документа к сохранённому файлу**, **заливка, границы и запрет разрыва абзаца с отменой**, **разделы и альбомные фрагменты с непрерывной нумерацией страниц**, **автонумерация подписей и перекрёстные ссылки, поиск осиротевших и отсутствующих подписей**, **текстовые подложки (просмотр/добавление/удаление)**, **предпросмотр точечной правки с исправлениями и ветки комментариев**, **вставка сохранённых документов, ограничения редактирования, таблица ↔ текст**, **сравнение документов в новый документ с исправлениями**, **сортировка таблиц по трём ключам с отменой**, структура, чтение страницами, точная замена (в том числе до 200 пар по порядку, со счётчиками и одной отменой), вставка в закладку или рядом с таблицей, стили, списки, таблицы, колонтитулы, оглавление, комментарии, исправления, сноски, снимок страницы в PNG, шаблоны с `{{метками}}` | | Мосты | таблица Word → Excel (числа становятся числами, `007` остаётся текстом), диапазон и диаграмма Excel → Word, слияние Excel → Word/PDF с планом в readonly, разбор файла без открытия | | История | журнал изменений по каждому документу, необязательный лист «Лог» в Excel, `office_undo` для правок агента | `word_edit_preview` и `word_edit_apply` принимают `track` (по умолчанию true). Передайте `track=false` в оба вызова, чтобы применить согласованную правку фрагмента без исправлений; preview возвращает `will_track_changes`. Оформление вне фрагмента не затрагивается, режим исправлений восстанавливается даже при ошибке, отмена через `office_undo` сохраняется. ### Воспроизводимые примеры [Реестр → Word/PDF](examples/register-to-acts.md) · [Комментарии → исправления](examples/comments-to-tracked-edits.md) · [Сравнение реестров](examples/compare-registers.md) · [Диапазон → таблица отчёта](examples/range-to-report-table.md) ## Безопасность - **Только чтение** (`OFFICE_LIVE_MODE=readonly`): пишущие инструменты не регистрируются, у многоактных остаются только действия чтения. Единственный читающий инструмент с побочным эффектом — снимок диапазона (PNG): временная диаграмма на листе помечает книгу как изменённую. - **Разрешённые папки** (`OFFICE_LIVE_ALLOWED_DIRS`): файлы вне них агенту не видны; ничего не сохраняется само, существующие файлы не перезаписываются без `overwrite=true`. - Книги с **автосохранением** (OneDrive/SharePoint) не меняются; на время правок агента события Excel и макросы выключены. - **Журнал и отмена**: каждая правка записывается в журнал документа; `office_undo` отменяет шаги агента (через историю Word, в Excel — по снимкам) и отказывает, если вы потом правили то же место, пока не передан `force=true`. - Необязательный журнал аудита (`OFFICE_LIVE_AUDIT_LOG`) и строгий выбор файла (`OFFICE_LIVE_STRICT_TARGET`). - Пароли защиты маскируются в журналах, ошибках и истории. Операция с паролем создаёт барьер отмены; без пароля отмена возвращает флаги защиты и свойства Locked. Сервер работает локально и не открывает портов. Прочитанное агентом отправляется поставщику его модели — для конфиденциальных файлов ограничьте папки. Подробности и ограничения: [руководство](GUIDE.ru.md) · [SECURITY.md](../SECURITY.md). ## Сравнение с аналогами Сведения взяты из публичной документации каждого продукта, **проверено 06.10.2026**. «Не подтверждено» значит, что в документации функция не упомянута, а не что её нет. Исправления приветствуются. ### ИИ-ассистенты Office (надстройки) | | **Office Live MCP** | [Claude for Excel](https://claude.com/docs/office-agents/excel) / [Word](https://claude.com/docs/office-agents/word) | [ChatGPT for Excel](https://help.openai.com/en/articles/20001063-chatgpt-for-excel) / [Word](https://help.openai.com/en/articles/20001526-chatgpt-for-word) | |---|---|---|---| | Форма | MCP-сервер, локальный процесс, COM; без надстройки Office | надстройка Office (боковая панель) | надстройка Office (боковая панель) | | Агент и модель | любой MCP-клиент и его модель | Claude | ChatGPT; Codex в десктопном ChatGPT может работать с открытой книгой Excel через надстройку | | Приложения | Excel, Word | Excel, Word, PowerPoint; Outlook — бета ([обзор](https://claude.com/claude-for-microsoft-365)) | Excel, Google Таблицы, Word, PowerPoint | | Платформы и версии | Windows, настольный Office. Проверено на Microsoft 365 Apps (версия 16), Windows 11, русский интерфейс; другие версии не проверялись | веб, Windows (сборки Microsoft 365 из документации), Mac; не Office 2016/2019 с бессрочной лицензией | Excel: настольный и веб; Word: не указано | | Исправления Word | да: управление исправлениями, точечные правки записываются исправлениями | да: режим исправлений | не подтверждено | | Ветки примечаний Word | список веток с ответами, ответ, «решено» | проходит по веткам, правит привязанный текст и отвечает | не подтверждено | | Сводные таблицы Excel | создание, поля, фильтры, срезы, временные шкалы | правка сводных | не подтверждено | | Макросы / VBA | код VBA читается из файла, не выполняется | не поддерживаются | «may not be fully supported» | | Цена | сервер бесплатный (MIT); агент и модель — по условиям их поставщика | платные планы Claude | все планы ChatGPT, Free — с ограничениями | | Куда уходят данные | сервер работает локально и не открывает портов; прочитанное агентом уходит поставщику модели этого агента | обрабатываются Anthropic; по документации удаляются в течение 30 дней | по условиям плана ChatGPT; по документации часть логов может храниться 30 дней | | Исходный код | открыт, MIT | закрыт | закрыт | Работа в открытом документе, ссылки на ячейки, сводные таблицы, исправления Word и общий контекст Excel и Word есть и у этих ассистентов. Office Live MCP — для тех, кто хочет, чтобы в Office работал **свой агент** (Claude Code, Cursor, Codex CLI, ZCode, VS Code…), с ограничениями на стороне сервера, которые задаёте вы. ### MCP-серверы для Office | Проект | Как работает | Документы | По его README | |---|---|---|---| | **Office Live MCP** | COM к запущенным Excel и Word | уже открытые файлы | мосты Word↔Excel, журнал, отмена поддерживаемых действий, режим только чтения, разрешённые папки | | [sbroenne/mcp-server-excel](https://github.com/sbroenne/mcp-server-excel) (MIT) | COM к Excel (.NET), MCP-сервер или CLI | просит сначала закрыть открытые книги (монопольный доступ) | только Excel; Power Query, DAX, VBA, 326 операций; Excel 2016 и новее | | [haris-musa/excel-mcp-server](https://github.com/haris-musa/excel-mcp-server) (MIT) | файлы через openpyxl, Excel не нужен | файлы на диске | кроссплатформенный; формулы сохраняются, но не вычисляются; вместо настоящих сводных — итоговые таблицы; ограничение папок, режим только чтения | | [negokaz/excel-mcp-server](https://github.com/negokaz/excel-mcp-server) (MIT) | файлы; в Windows — правка открытых книг | файлы; открытые книги в Windows | 7 инструментов в README; снимок экрана в Windows | | [GongRzhe/Office-Word-MCP-Server](https://github.com/GongRzhe/Office-Word-MCP-Server) (MIT) | файлы через python-docx | файлы на диске | репозиторий архивирован (только чтение) | | [OfficeMCP/OfficeMCP](https://github.com/OfficeMCP/OfficeMCP) | COM через общий инструмент `RunPython` | запущенные приложения Office | много приложений Office; агент выполняет произвольный Python; файла лицензии нет | Для серверных и кроссплатформенных сценариев лучше подходят серверы, работающие с файлами; COM-серверам нужны Windows и настольный Office. ## Разработка ```bat python -m venv .venv && .venv\Scripts\pip install -r requirements.txt pytest ruff .venv\Scripts\python -m pytest tests -q :: юнит-тесты, Office не нужен set OFFICE_LIVE_LIVE_TESTS=1 && .venv\Scripts\python -m pytest tests\live -m smoke -q :: быстрый живой набор, ~4 мин (настоящие Excel и Word) set OFFICE_LIVE_LIVE_TESTS=1 && .venv\Scripts\python -m pytest tests\live -q :: полный живой набор, ~12 мин, перед релизом .venv\Scripts\python packaging\build.py :: собрать setup.exe + ZIP (нужны pyinstaller и Inno Setup 6.7+) ``` Устройство, особенности COM и все настройки — [GUIDE.ru.md](GUIDE.ru.md). Изменения — [CHANGELOG.md](../CHANGELOG.md). Лицензия: [MIT](../LICENSE).