VM
ИИ-помощник для Vetmanager

Независимый сервис для вашей клиники

Ваш ИИ-помощник теперь знает вашу клинику

Подключите Vetmanager к ИИ-помощнику, которым вы уже пользуетесь, и спрашивайте о записях, приёмах и выручке обычными словами.

Бесплатно. Оплата не нужна ни сейчас, ни потом.

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

Для обычных ответов данные клиники не сохраняются. Выгрузки отчётов временно хранятся в очищенном виде до трёх суток. Логин и пароль Vetmanager не сохраняются.

Уже зарегистрированы? Войти в кабинет

Логин и пароль от Vetmanager не сохраняются Данные клиники берём только чтобы ответить на вопрос Подключение защищено и работает только для вашей клиники

Как это работает

Вы спрашиваете обычными словами, помощник берёт ответ из вашей клиники.

1
Вы задаёте вопрос«Покажи записи на завтра» или «Какая выручка за март».
↓
2
Ваш ИИ-помощникChatGPT, Claude или Manus — тот, которым вы уже пользуетесь.
↓
3
Защищённое подключениеРаботает только для вашей клиники и только на разрешённые вами действия.
↓
4
Ваш VetmanagerДанные остаются в вашей рабочей системе.
↓
5
Ответ по данным клиникиПомощник возвращает понятный результат.

Что нужно сделать

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

С какими помощниками работает

Выберите помощника, которым уже пользуетесь.

Для ChatGPT сначала подключите Vetmanager в кабинете, затем добавьте адрес подключения в ChatGPT и разрешите доступ. В Claude и Manus подключение тоже настраивается в интерфейсе помощника.

Подключить

Использование с кодинг-агентом

Codex, Claude Code, Cursor и другие агенты, которые работают у вас в редакторе. Для ChatGPT, Claude и Manus этот раздел не нужен: после регистрации подключите Vetmanager и настройте помощника в его интерфейсе.

Подключить кодинг-агента Codex, Claude Code, Cursor — готовая команда и ключ доступа

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

MCP — это мост между ИИ-агентом и Vetmanager. Вы задаёте вопрос обычным языком, агент обращается к Vetmanager через разрешённые команды и возвращает ответ по вашим данным.

Подключение в 3 шага

01Выберите агентаЕсли сомневаетесь, начните с Codex.
02Отправьте командуСкопируйте готовый текст ниже и дайте его агенту.
03Вставьте ключДобавьте ключ доступа в настройки и перезапустите сессию.

Настройку удобнее делать с компьютера.

Ключ доступа не нужно отправлять в чат. Он хранится в настройках агента или на вашем компьютере. Выдаётся в кабинете после регистрации и подключения Vetmanager: создать аккаунт или войти в кабинет.

Инструкции для агентов

Скопируйте готовую команду и отправьте её агенту: он сам найдёт файл настроек, а ключ доступа вы вставите вручную.

Рекомендуем для старта
Настрой мне MCP-сервер Vetmanager.

Адрес сервера: https://vetmanager-mcp.vromanichev.ru/mcp

Ключ доступа / Bearer token я вставлю сам, но покажи путь к файлу или настройке, куда его нужно вставить.

После настройки скажи, как перезапустить сессию Codex и как проверить, что инструменты Vetmanager подключились.

Если агент не открыл файл настроек

Попросите его ещё раз показать путь к конфигурации. Если не получилось, откройте ручную подсказку для вашего агента.

CodexПопросите Codex показать путь к MCP config именно для вашей системы.
Claude CodeДобавьте сервер командой claude mcp add, затем проверьте подключение командой /mcp в новой сессии.
CursorОткройте MCP settings в Cursor и перезапустите Cursor-сессию.
Другой агентНайдите раздел MCP servers, укажите URL и авторизацию через ключ доступа.

Частые ошибки

Агент не видит VetmanagerПерезапустите сессию и попросите показать список подключённых MCP-серверов.
Ошибка 401 / ключ доступа не подошёлПроверьте, что ключ вставлен в настройки и скопирован полностью.
Инструменты не появилисьПроверьте адрес MCP-сервера и перезапустите приложение или сессию.

Если настраиваете руками

Формат подключения: Authorization: Bearer <service_token>.

{
  "mcpServers": {
    "vetmanager": {
      "url": "https://vetmanager-mcp.vromanichev.ru/mcp",
      "headers": {
        "Authorization": "Bearer vm_st_your_service_token"
      }
    }
  }
}

Что получает клиника

Сервис помогает быстрее отвечать на ежедневные вопросы клиники: кто записан на сегодня, какая история у пациента, есть ли долг у клиента, что осталось на складе и какие сотрудники свободны или загружены.

Ветврач

история пациента, прививки, медицинские карты, последние визиты.

  • Покажи историю питомца
  • Кому пора на прививку?
  • Последние приёмы клиента

Администратор

записи, клиенты, контакты, сотрудники, задолженности.

  • Найди клиента по телефону
  • Записи на завтра
  • Какие счета оплачены частично?

Руководитель

сотрудники, загрузка врачей, сводные операционные вопросы.

  • Выручка за период
  • Отчёт по оплатам за неделю
  • Клиенты с долгом

Сервис сделан для ветврачей, администраторов и руководителей клиник, которым нужен быстрый доступ к данным Vetmanager через ИИ-помощника.

Какие вопросы можно задавать

Сервис рассчитан на повседневные вопросы, которые обычно требуют нескольких переходов по Vetmanager или помощи администратора.

  • Кто из врачей работает сегодня?Пример ответа

    По расписанию сегодня запланированы три врача: терапевт с 09:00, хирург с 10:00 и специалист УЗИ с 12:00; фактическую явку расписание не подтверждает.

  • У всех ли принятых сегодня пациентов заполнены медкарты?Пример ответа

    Среди 12 записей с текущим статусом accepted у 10 медкарты заполнены, у 2 ещё нет записи; статус не подтверждает посещение.

  • Кто свободен завтра после 15:00?Пример ответа

    Завтра после 15:00 есть свободные окна у двух врачей: в 15:30 и 17:00.

  • Топ-10 должниковПример ответа

    При принятом в клинике критерии долга как отрицательного баланса клиенты №1–10 имеют остатки −15 000, −13 000, −11 000, −10 000, −9 000, −8 000, −7 000, −5 000, −4 000 и −2 500 ₽. Суммарный долг 84 500 ₽.

  • Клиенты без визитов 12+ месяцевПример ответа

    При проверке даты последнего визита найдено 28 клиентов без подтверждённого визита больше года; один текущий статус записи этого не доказывает.

  • Сколько приёмов запланировано на завтра?Пример ответа

    На завтра запланировано 18 приёмов: 11 утром и 7 после обеда.

Это пример оформления, цифры вымышленные.

Как мы работаем с данными

Здесь — ответы о подключении, защите и работе с данными вашей клиники.

Сколько это стоит?

Бесплатно. Сервис бесплатен для клиник: оплата не нужна ни при регистрации, ни потом. Ограничений по сроку использования нет.

Храните ли вы логин и пароль от Vetmanager?

Нет. Логин и пароль от Vetmanager не сохраняются. Для связи хранится отдельный защищённый ключ подключения в зашифрованном виде. Данные клиники — записи, приёмы и платежи — не сохраняются: они запрашиваются только в момент ответа.

Как помощник отвечает на вопросы?

Вы задаёте вопрос обычными словами, а помощник находит нужные данные Vetmanager и возвращает понятный ответ.

Безопасно ли это?

Логин и пароль Vetmanager не сохраняются. Защищённый ключ подключения хранится зашифрованно; доступ можно отключить в кабинете.

Что такое режим без персональных данных?

Это настройка подключения в личном кабинете. Когда она включена, сервис передаёт помощнику метки вместо ФИО, телефонов, адресов электронной почты и почтовых адресов клиентов и сотрудников, включая врачей. Метка указывает на запись, но не содержит значения:

  • [client:123:last_name] — фамилия клиента с идентификатором 123
  • [user:5:doctor_name] — ФИО сотрудника с идентификатором 5
  • [client:123:cell_phone] — мобильный телефон клиента

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

Как пользователь увидит имена, если помощнику они недоступны?

Для этого используются два ключа доступа:

  • Ключ 1 — для помощника. Это обезличенное подключение. Помощник работает только с метками и формирует ответ без персональных данных.
  • Ключ 2 — для подстановки значений. Это ключ с полным доступом: REST-ключ Vetmanager или отдельное подключение без обезличивания. Он хранится в защищённом окружении клиники и помощнику не передаётся.

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

Как устроена подстановка значений (резолв)?
  1. Найти в тексте ответа метки по шаблону [тип:ID:поле], где тип — client, user или pet.
  2. Сформировать список уникальных пар «тип + идентификатор»: каждая запись запрашивается один раз, сколько бы меток на неё ни ссылалось.
  3. Для каждой пары получить запись по второму ключу: с REST-ключом Vetmanager — прямым GET-запросом к REST API Vetmanager; с отдельным подключением без обезличивания — через инструменты подключения get_client_by_id, get_user_by_id или get_pet_by_id.
  4. Заменить метку значением поля. Составные поля doctor_name и owner_name собираются из фамилии, имени и отчества.
  5. Показать результат пользователю на экране или в файле, не передавая его обратно помощнику.

Помощник может подготовить скрипт только для подстановки имён клиентов и сотрудников; этот скрипт не охватывает метки питомцев и контактов. Сотрудник клиники проверяет скрипт и запускает его в своём окружении.

Как сделать подстановку на примере Telegram-бота?

Схема применима к любому приложению, которое показывает пользователю ответы помощника. На примере бота:

  1. Разделите ключи по компонентам. Модель работает через обезличенное подключение (ключ 1). Второй ключ получает только модуль отправки сообщений, и только после того, как модель завершила работу.
  2. Подставляйте значения на выходе. Перед отправкой в Telegram модуль находит метки в тексте ответа и в текстовых вложениях (CSV, Markdown, TXT), запрашивает записи по второму ключу и подставляет значения.
  3. Не сохраняйте результат подстановки. История диалога, промпт и журналы содержат только метки. Вложения с персональными данными создаются как временные копии и удаляются после отправки.
  4. Ограничьте объём и время. В нашей реализации — не более 50 уникальных записей на ответ и не более 10 секунд на одну попытку подстановки.
  5. Подставляйте значения только для известных меток. Подставляйте контактные данные — телефон, адрес электронной почты и почтовый адрес — только для меток, полученных из ответа Vetmanager в этом же запросе: так модель не сможет получить контакты перебором идентификаторов.
  6. Не подставляйте значения в изображения. В графиках и других изображениях модель указывает идентификатор или роль сотрудника.
Что происходит, если подстановка не выполнена?

Метка остаётся в тексте без изменений: пользователь увидит [client:123:last_name] вместо фамилии, при этом ответ не будет искажён. Рекомендуется уведомлять администратора о причине сбоя, например, об истёкшем ключе или превышении времени ожидания. Передавать второй ключ помощнику нельзя ни при каких условиях: это полностью отменяет защиту персональных данных.

Подключите клинику к своему ИИ-помощнику

После подключения задайте первый вопрос о вашей клинике.

Дополнительно

Нужна помощь?

Проверить подключение можно в кабинете. Если нужна помощь, напишите в issues на GitHub.

github.com/otis22/vetmanager-mcp

Проект открыт. Техническая команда может установить его на своём сервере.