Сервис MCP в DOC-V: ИИ-агент сотрудника работает с документооборотом

ИИ-агенты — Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI — уже стоят на компьютерах аналитиков, юристов, инженеров и руководителей. Они читают файлы, пишут код, сводят таблицы. Но документооборот организации им не виден: чтобы спросить агента о договорах на согласовании, приходится выгружать журнал в Excel и копировать данные в чат.

С версии DOC-V 8.5.18 в платформе есть сервис MCP — встроенный сервер Model Context Protocol. Через него агент сотрудника сам обращается к DOC-V: открывает журналы, отбирает и читает документы, ищет по файлам, считает итоги, а если администратор разрешил — заполняет поля и создаёт документы. Всё — с правами этого сотрудника и с записью в журналах DOC-V.

🔌 Что такое MCP простыми словами

Model Context Protocol (MCP) — открытый стандарт, по которому ИИ-агенты подключаются к внешним системам. Система описывает свои инструменты: «найти документы», «прочитать файл», «посчитать итог». Агент сам решает, какой инструмент вызвать, чтобы ответить на вопрос человека. Раньше для каждой пары «агент — система» писали свой коннектор. Теперь достаточно, чтобы система умела MCP, а агент был клиентом MCP: он подключится к ней так же, как к любому другому серверу MCP.

Для организации это значит простую вещь: сотрудник продолжает работать в привычном агенте, а DOC-V становится одним из источников, к которым у агента есть доступ, наравне с локальными файлами, почтой, таск-трекером или репозиторием, если у них тоже есть сервер MCP.

🧩 Сервис MCP, ИИ-ассистент и REST API: что для чего

В DOC-V уже есть ИИ-ассистент для пользователей, ИИ-администратор для настройки и REST API для интеграций. Сервис MCP их не заменяет, а закрывает другую задачу:

Если задача повторяется и должна давать один и тот же результат — это REST API или действие на маршруте. Если вопрос каждый раз новый, а ответ нужно собрать из нескольких мест — это работа для агента.

💼 Как организация может применять сервис MCP

Ниже — сценарии, которые сервис поддерживает уже сейчас. Журналы, поля и цифры условные: в каждой организации они свои, а агент узнаёт их сам из структуры журналов и пояснения администратора.

1. Руководитель: «что у нас зависло»

«Какие договоры больше пяти дней на согласовании? Сгруппируй по исполнителям и посчитай общую сумму»

Агент открывает журнал договоров, отбирает документы по колонкам — как фильтром в интерфейсе, — смотрит исполнителей и считает итог по колонке «Сумма». Ответ — таблица в чате, которую можно сразу вставить в письмо или отчёт. Такой ключ достаточно выдать только на чтение.

2. Юрист: поиск по тексту договоров

«Найди в договорах поставки этого года условия о неустойке выше 0,1% в день и сведи в таблицу: контрагент, пункт, ставка»

Агент отбирает договоры поставки за год, читает текст их вложений, ищет по файлам каждого договора и выписывает найденные пункты. При включённой векторизации доступен и поиск по смыслу — когда в тексте написано «пеня», а спрашивали про «неустойку». Результат стоит проверить: агент экономит часы чтения, но вывод остаётся за юристом.

3. Канцелярия: первичная обработка входящих

Администратор настраивает операцию «Редактирование» для типа «Входящее письмо»: поля «Краткое содержание» (Текст) и «Тематика» (Список), только на точке «Регистрация». Агент читает вложения новых писем, заполняет эти два поля — и всё: дальше документ ведёт человек. Агент не может поправить письмо на другой точке и не может тронуть другие поля, а в ходе работы документа остаётся запись «Изменение операцией MCP».

4. Закупки: заявки из присланной таблицы

«Вот таблица потребности цеха на ноябрь. Создай по каждой строке заявку, позиции сопоставь со справочником номенклатуры»

Таблицу агент читает на компьютере сотрудника, позиции находит через варианты значений поля-ссылки на справочник, а заявки создаёт операцией «Создание» с параметрами «Номенклатура», «Количество», «Срок». Документ создаётся так же, как через форму: если его не удалось провести, он удаляется. Перед созданием агент может проверить, нет ли уже таких заявок, и показать сотруднику список на подтверждение.

5. Охрана труда: утренняя сводка по нарядам-допускам

Для нарядов-допусков агент собирает сводку по нескольким журналам: открытые наряды, наряды с истекающим сроком, допуски, где не хватает подписей, — с количеством по участкам. Только чтение, но вместо обхода пяти журналов — один ответ.

6. Сверка между системами

Агент работает с несколькими источниками в одном диалоге. Сотрудник даёт ему выгрузку оплат из учётной системы, а агент сверяет её со счетами в DOC-V: какие счета на «Оплате» уже оплачены, какие оплаты не нашли своего счёта. Если у другой системы — таск-трекера, почты, хранилища знаний — есть свой сервер MCP, агент подключается и к ней, а связь между системами строится прямо в разговоре, без отдельной интеграции.

7. Регулярный отчёт по расписанию

Агенты с командной строкой умеют работать без человека: их запускают по расписанию — Cron или планировщиком заданий Windows. Каждый понедельник агент собирает сводку по просроченным поручениям и создаёт в DOC-V документ «Еженедельный отчёт» операцией «Создание» с «Выполнить точку» — и отчёт уходит по маршруту руководителю. Такому агенту — отдельный ключ, отдельная учётная запись и только одна операция записи.

8. ИТ: интеграции и проверка данных

Программист, который пишет интеграцию через REST API, подключает агента в редакторе кода к тестовому серверу DOC-V. Агент сам смотрит структуру журналов, поля и формы документов, проверяет на живых данных, что вернул запрос, и находит, почему документ не попал в отбор. Ключ на тестовый сервер, только чтение.

🛡️ Безопасность: агент — это ещё один сотрудник

Главный принцип сервиса: агент не получает больше прав, чем человек. Каждый запрос выполняется от имени пользователя ключа — сотрудника, к которому привязан ключ, или общего пользователя сервиса.

• Видимость как у пользователя. Только доступные ему журналы, документы, поля и файлы; из документа — поля формы просмотра, из журнала — колонки. Заблокированный, удалённый пользователь или гость получает отказ.
• Секреты не уходят. Поля «Пароль» приходят маской *****. Содержимое зашифрованных файлов агенту по умолчанию не передаётся — это отдельный переключатель.
• Инструменты отключаются. Любой инструмент чтения можно снять флажком: например, оставить агенту журналы и документы, но не файлы.
• Запись — всё или ничего. Операцию выполняют с правами пользователя: если хотя бы одно её поле закрыто для правки, не записывается ничего. Документ должен быть виден, не удалён и не в архиве.
• Ключ — как пароль. Ключ — это значение поля «Пароль» в документе ключа, длиной не меньше 32 символов. Он передаётся только в заголовке Authorization: Bearer, не в адресе. Отозвать ключ — удалить его документ, в том числе действием «Контроль».
• Сеть и нагрузка. Без HTTPS сервис принимает запросы только с локального адреса сервера и от доверенного прокси. Можно задать список разрешённых IP-адресов, предел вызовов в минуту и одновременных вызовов, а также предельный размер ответа. Адрес, с которого часто приходят запросы с неверным ключом, блокируется.
• Всё видно. Подключения, отказы и операции — в «Активности», отклонённые запросы с правильным ключом — в «Событиях» на стартовой странице администратора, каждый вызов с аргументами — в журнале обращений ИИ-ассистента.

Куда уходят данные

Об этом важно сказать честно. DOC-V отдаёт данные клиенту MCP на компьютере сотрудника, а клиент передаёт их своей языковой модели. Если модель облачная, всё, что прочитал агент, попадает к её поставщику на его условиях. Поэтому:

• выдавайте ключи от учётных записей с узкими правами — только на нужные журналы;
• отключайте инструменты, которые не нужны, — в первую очередь файлы, если задача решается по полям;
• для чувствительных данных используйте клиент с локальной моделью внутри своей сети — тогда документы не покидают организацию.

И ещё одно: агент читает чужие тексты — письма, договоры, вложения, — а в них может оказаться текст, который пытается дать агенту указания. DOC-V передаёт содержимое документов как данные, а не как команды, а запись ограничена операциями администратора. Это снижает риск, но не исключает его, поэтому принцип минимальных прав здесь главный.

🛠️ Как подключить

Администратор DOC-V

1. Тип документа для ключей, например «Ключ MCP»: поле типа «Пароль» (хеширование или шифрование), описание — кому и для чего выдан ключ, и при необходимости ссылка на сотрудника, от имени которого работает агент.
2. Документ ключа: в поле «Пароль» — случайная строка не короче 32 символов, например результат openssl rand -hex 32. После сохранения значение больше нигде не показывается — сразу передайте его тому, кто подключает агента.
3. Сервис: «Администрирование» → «Сервисы» → «Сервис MCP» → «Настроить» → «Новый сервис». Адрес, тип и поле ключей, нужные инструменты, пределы, IP-адреса и пояснение для агента.
4. Операции записи — если агент должен что-то менять: тип документа, поля и их параметры, точки маршрута и что делать после выполнения.
5. Передайте сотруднику «Адрес для агента» из окна сервиса (https://ваш-сервер/mcp/адрес-сервиса) и ключ.

Пошагово, со всеми настройками, — в статье документации «Сервис MCP».

Сотрудник: настройка клиента

Клиенту нужны два значения: адрес и ключ. Ключ лучше держать в переменной окружения, а не в файле настроек, особенно если файл лежит в репозитории. В примерах ниже ключ лежит в переменной DOCV_MCP_KEY.

Claude Code — одной командой:

claude mcp add --transport http docv https://ваш-сервер/mcp/адрес-сервиса \
  --header "Authorization: Bearer $DOCV_MCP_KEY"

Codex CLI — в ~/.codex/config.toml:

[mcp_servers.docv]
url = "https://ваш-сервер/mcp/адрес-сервиса"
bearer_token_env_var = "DOCV_MCP_KEY"

Cursor — в ~/.cursor/mcp.json или .cursor/mcp.json проекта:

{
  "mcpServers": {
    "docv": {
      "url": "https://ваш-сервер/mcp/адрес-сервиса",
      "headers": { "Authorization": "Bearer ${env:DOCV_MCP_KEY}" }
    }
  }
}

VS Code с GitHub Copilot — в .vscode/mcp.json; ключ VS Code спросит при первом запуске и сохранит у себя:

{
  "inputs": [
    { "type": "promptString", "id": "docv-key", "description": "Ключ DOC-V MCP", "password": true }
  ],
  "servers": {
    "docv": {
      "type": "http",
      "url": "https://ваш-сервер/mcp/адрес-сервиса",
      "headers": { "Authorization": "Bearer ${input:docv-key}" }
    }
  }
}

Gemini CLI — одной командой:

gemini mcp add --transport http --header "Authorization: Bearer $DOCV_MCP_KEY" \
  docv https://ваш-сервер/mcp/адрес-сервиса

Другие клиенты подключаются так же, если в их настройках можно указать адрес сервера MCP (транспорт HTTP) и заголовок Authorization. После подключения агент видит инструменты DOC-V и пояснение администратора — можно сразу спросить: «Какие журналы DOC-V тебе доступны?»

⚖️ Честно об ограничениях

• Нет OAuth. Веб-коннекторы, которые подключаются к серверам MCP только через OAuth (например, в веб-версиях чат-ботов), к DOC-V пока не подключатся. Нужен клиент, который умеет передавать ключ в заголовке.
• Агент не нажимает кнопки. Он видит, какие кнопки есть у документа и журнала, но двигает документ по маршруту только операцией, в которой это настроил администратор («Перевести в точку» или «Выполнить точку»).
• Операции записи — для основных типов полей: Строка, Текст, Число, Дата и время, Список со своими пунктами, Ссылка на документы одного типа.
• Поиск по смыслу работает, только если в DOC-V включена векторизация. Длинные ответы обрезаются по пределу, который задал администратор.
• Качество ответа зависит от модели агента. Агент может ошибиться в подсчёте или неверно понять вопрос — важные выводы проверяйте по ссылкам на документы.
• Нужна версия 8.5.18 или новее и HTTPS на сервере DOC-V: без него сервис отвечает только запросам с самого сервера и от доверенного прокси.

💰 Сколько стоит

В версиях DOC-V 8.5 сервис MCP бесплатный: он не требует модуля в лицензионном ключе, а платы за вызовы, число ключей или агентов нет. Модель агента организация оплачивает своему поставщику по его тарифам — или использует локальную модель. Подробнее об условиях — на странице цен.

🚀 Итог

Сервис MCP не требует внедрять ещё одну систему: сотрудники остаются в своих агентах, а DOC-V становится для них ещё одним источником данных — с теми же правами, что у человека, и с записью каждого шага. Начать можно с одного ключа только на чтение и одного журнала, а операции записи добавлять по мере того, как становится понятно, где агент действительно экономит время.