MCP-серверы Altegio для ИИ-ассистентов

MCP-серверы Altegio позволяют работать с Altegio из ИИ-ассистента, например Claude, ChatGPT или Cursor. Ассистент может отвечать на вопросы о вашем бизнесе на основе данных Altegio, вносить изменения по запросу, находить ответы в базе знаний Altegio или помогать разработчикам создавать приложения для Маркетплейса. Вы входите со своей учётной записью Altegio, API-ключи не нужны.

Основные понятия

• MCP (Model Context Protocol): открытый стандарт подключения ИИ-приложений к внешним сервисам.
• MCP-сервер: сервис, который даёт ИИ-приложению набор инструментов для работы с системой. В некоторых ИИ-приложениях MCP-сервер называется коннектором или пользовательским приложением.
• ИИ-приложение (MCP-клиент): приложение, в котором вы общаетесь с ассистентом, например Claude, ChatGPT, Cursor, VS Code с GitHub Copilot, Claude Code, Codex или Gemini CLI.

Какие MCP-серверы предлагает Altegio

MCP-сервер	Адрес	Что умеет ассистент	Изменяет данные
Altegio Pro MCP	https://mcp.alteg.io/pro	Работа с записями, сотрудниками, услугами, графиками работы, клиентами и настройками локации; ключевые показатели; пошаговая настройка новой локации	Да
Altegio Pro MCP (read-only)	https://mcp.alteg.io/pro/readonly	Чтение тех же данных; полный набор аналитики	Нет
Altegio Knowledge MCP	https://mcp.alteg.io/knowledge	Поиск по базе знаний Altegio и ответы со ссылками на статьи	Нет
Altegio Integrations Hub MCP	https://mcp.alteg.io/integrations-hub	Создание, настройка, тестирование и отправка на модерацию собственных приложений для Маркетплейса	Только ваши приложения разработчика

К одному ИИ-приложению можно подключить несколько MCP-серверов. Например, Altegio Pro MCP работает с вашими данными, а Altegio Knowledge MCP отвечает на вопросы о продукте по базе знаний.

Когда использовать

• Спрашивайте о бизнесе простыми словами, например «Как изменилась выручка в прошлом месяце по сравнению с позапрошлым?», и получайте ответ на основе ваших данных в Altegio.
• Вносите много изменений одним запросом, например повышайте цены на все услуги категории или задавайте графики работы всей команде на следующий месяц.
• Настраивайте новую локацию по готовым спискам сотрудников, услуг и клиентов.
• Давайте аналитику, консультанту или автоматическому агенту доступ к вашим данным без возможности их изменять.
• Получайте ответы на вопросы о возможностях Altegio со ссылками на статьи базы знаний.
• Создавайте и тестируйте собственное приложение для Маркетплейса Altegio (для разработчиков).

Что понадобится

• Учётная запись Altegio: email и пароль, с которыми вы входите в Altegio. Ассистент работает от имени этой учётной записи.
• ИИ-приложение: приложение, которое поддерживает удалённые MCP-серверы, например Claude (Claude.ai, Claude Desktop и Cowork), ChatGPT, Cursor, VS Code (режим агента GitHub Copilot), Claude Code, Codex или Gemini CLI. В ChatGPT MCP-серверы добавляются в режиме Developer mode.
• Стоимость: все 4 MCP-сервера Altegio бесплатны.

Altegio Pro MCP

Altegio Pro MCP подключает ассистента к данным ваших локаций в Altegio. Ассистент читает данные и изменяет их по запросу. Он работает в пределах тех же локаций и прав доступа, что и ваш пользователь Altegio.

Что умеет Altegio Pro MCP

• Записи: просмотр, создание, изменение и удаление записей.
• Сотрудники и должности: просмотр, добавление, изменение и удаление сотрудников; просмотр и создание должностей.
• Графики работы: просмотр, создание, изменение и удаление графиков работы сотрудников.
• Услуги и категории: просмотр, создание, изменение и удаление услуг; просмотр и удаление категорий услуг; привязка сотрудников к услугам, отвязка и настройка длительности услуги для сотрудника. Одним запросом можно привязать сотрудника сразу ко многим услугам.
• Клиенты: поиск клиента по имени, построение сегмента клиентской базы и подсчёт его размера, открытие карточки клиента и истории визитов, удаление клиента. Сегмент можно построить по потраченной сумме, числу визитов, дате последнего визита, категориям клиентов, дню рождения, абонементам, сертификатам, балансу счёта клиента и истории записей к конкретному сотруднику или на конкретную услугу. Телефоны и email клиентов не попадают в результаты, если ассистент не запросит их отдельно.
• Локация и онлайн-запись: изменение названия, адреса, города, сайта, описания и типа бизнеса локации; изменение типа записи по умолчанию и числа мест в групповом событии; изменение настроек онлайн-записи: запись к любому сотруднику, подтверждение номера телефона по SMS, время до ближайшего доступного слота; просмотр, создание и удаление форм онлайн-записи; просмотр ресурсов.
• Ключевые показатели: выручка от услуг и товаров, средний чек, заполненность, записи по итогам, а также новые, повторные, активные и потерянные клиенты за период в сравнении с предыдущим периодом той же длины. Показатели можно сузить до одного сотрудника, одной должности или одного администратора.
• Другие данные: на вопрос, для которого нет отдельного инструмента Altegio Pro MCP, ассистент может ответить через документированный API Altegio. Через API ассистент только читает данные и ничего не изменяет.

Пошаговая настройка новой локации

Altegio Pro MCP может настроить локацию пошагово: должности, сотрудники, категории услуг, услуги, графики работы, импорт клиентов и тестовые записи. Сотрудников, услуги и клиентов можно передать списком в формате CSV или JSON. Для списка клиентов в формате CSV нужны столбцы name, phone, email, surname и comment, а у каждого клиента должен быть номер телефона или email.

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

Чтобы начать, попросите ассистента настроить вашу локацию. В ИИ-приложениях, которые показывают готовые сценарии MCP-сервера, выберите Set up a location for the first time.

Удаление данных требует отдельного подтверждения

Прежде чем Altegio Pro MCP удалит сотрудника, услугу, категорию услуг, график работы, запись, форму онлайн-записи или клиента, отвяжет сотрудника от услуги или откатит шаг настройки, удаление нужно подтвердить именно для этого объекта. В ИИ-приложениях, которые поддерживают запросы подтверждения, Altegio показывает форму с названием объекта, например с именем и должностью сотрудника. Удаление выполняется только после вашего согласия. Если вы отклоните или отмените подтверждение, ничего не удаляется.

Примеры запросов

• «Как прошёл прошлый месяц в моей локации по сравнению с позапрошлым?»
• «Повысь цены на все услуги категории Окрашивание волос на 10%.»
• «Поставь всем сотрудникам рабочее время с 10:00 до 19:00 с понедельника по пятницу на следующей неделе.»
• «Запиши клиентку Анну Смит на стрижку к Марии завтра на 15:00.»
• «Сколько клиентов не приходили больше 90 дней?»

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

Примечание. Altegio Pro MCP включает только ключевые показатели из аналитики. Полный набор инструментов аналитики есть в Altegio Pro MCP (read-only). Чтобы получить подробную аналитику и вносить изменения, подключите оба сервера.

Altegio Pro MCP (read-only)

Altegio Pro MCP (read-only) использует тот же вход и читает те же данные, что и Altegio Pro MCP, но ничего не может изменить. Инструменты, которые создают, изменяют или удаляют данные, на этом сервере недоступны, а запрос такого действия отклоняется. Подключение через этот сервер получает доступ только для чтения.

Используйте Altegio Pro MCP (read-only), когда ассистенту нужно только читать данные:

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

Чтобы ассистент мог вносить изменения, подключите Altegio Pro MCP как отдельный сервер.

Что умеет Altegio Pro MCP (read-only)

Altegio Pro MCP (read-only) читает записи, сотрудников, должности, графики работы, услуги и категории, клиентов (поиск, сегменты, карточка клиента, история визитов), настройки локации, формы онлайн-записи и ресурсы, а также документированный API Altegio.

Он также включает полный набор аналитики. Каждый отчёт строится по одной локации за период до 365 дней: вчера, прошлая неделя, прошлый месяц, текущий квартал или ваши даты. Период считается в часовом поясе локации.

• Ключевые показатели и динамика: ключевые показатели в сравнении с предыдущим периодом; выручка, записи, заполненность и клиенты по дням; прогноз выручки и визитов в сравнении с фактическими показателями.
• Записи и ресепшен: записи по источнику (онлайн-запись, клиентское приложение, администратор, API) и по статусу визита; результаты администраторов: записанные клиенты, закрытые записи, выручка и доля клиентов, которые записались повторно.
• Команда: заполненность по дням для не более чем 10 сотрудников; рабочие, занятые и свободные часы; продажи сотрудников: услуги, товары, выручка и будущие записи; выручка по сотрудникам и услугам.
• Клиенты: продажи по клиентам; новые, повторные и вернувшиеся клиенты по сотрудникам; визиты, пропущенные визиты, траты и баланс счёта одного клиента; прогноз визитов клиентов; неактивные клиенты, которых можно вернуть; результаты программы лояльности.
• Деньги: рентабельность услуг (выручка, затраты и оплата сотрудников по услугам или категориям); прибыль и убытки по статьям доходов и расходов; движение денежных средств по статьям платежей и счетам; отчёт по итогам дня: клиенты, проданные услуги и товары, абонементы и сертификаты, поступления по счетам (наличные и карта) и списания; упущенная выручка из-за неявок, отмен, скидок и незаполненного времени.
• Загрузка: запланированные, забронированные, использованные и свободные часы по часам дня, дням недели или датам, с пиковыми и тихими часами.
• Товары и групповые события: продажи товаров по товарам или категориям с себестоимостью и наценкой; товары, которые пора дозаказать, с учётом скорости продаж и остатков; результаты групповых событий: места, записавшиеся, пришедшие и оплатившие участники.

В ИИ-приложениях, которые показывают готовые сценарии MCP-сервера, можно выбрать Location health check, Monthly business review, Team member review или Compare two periods.

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

Altegio Knowledge MCP

Altegio Knowledge MCP даёт ассистенту официальную базу знаний Altegio. Ассистент ищет по опубликованным статьям и отвечает со ссылками на источники.

• Что он ищет: опубликованные статьи базы знаний об онлайн-записи, журнале записи, клиентах и лояльности, уведомлениях, интеграциях, биллинге, настройках команды и мобильных приложениях. Скриншоты в статьях описаны в поисковом индексе, поэтому можно найти и шаг, который показан только на скриншоте.
• Что содержит результат: заголовок статьи, ссылку, раздел базы знаний, дату последнего обновления, оценку релевантности и короткий фрагмент текста. Один поиск возвращает от 1 до 10 статей, по умолчанию 5.
• Языки: английский, русский, украинский, венгерский и бразильский португальский, у каждого свой индекс. Ассистент ищет на языке того, кто задаёт вопрос. Для испанского поиск идёт по английскому индексу.
• Актуальность: новые и изменённые статьи попадают в индекс раз в день.
• Конфиденциальность: Altegio Knowledge MCP ищет только по публичной документации. У него нет доступа к вашей учётной записи, локациям, клиентам или выручке. Для подключения всё равно нужно войти с учётной записью Altegio.

Примеры запросов: «Как настроить онлайн-запись? Дай ссылки на статьи.» или «Почему не отправляются SMS-уведомления?»

Подключайте Altegio Knowledge MCP вместе с Altegio Pro MCP или Altegio Pro MCP (read-only), когда ассистенту нужны и официальные инструкции, и ваши актуальные данные.

Altegio Integrations Hub MCP

Altegio Integrations Hub MCP предназначен для разработчиков и партнёров, которые создают приложения для Маркетплейса Altegio (Integrations Hub). Он работает с вашим аккаунтом разработчика и вашими приложениями, а не с повседневной работой локации.

• Аккаунты разработчика: просмотр списка, создание, изменение и удаление доступных вам аккаунтов разработчика.
• Приложения: создание черновика приватного приложения, заполнение карточки приложения (описания, возможности, FAQ, иконка и скриншоты, страны, цены, колбэки) и запрос минимального набора прав доступа, который нужен приложению.
• Модерация: сохранение инструкций по подключению и оплате и отправка приложения на модерацию. Решение о публикации принимают модераторы Altegio. В Altegio Integrations Hub MCP нет инструментов публикации или модерации. Подробнее: Модерация приложения.
• Тестирование на локации: подключение приложения к тестовой локации, активация установки, проверка её статуса, просмотр локаций, где установлено приложение, и удаление приложения.
• Встроенные экраны: вкладки в карточках сотрудника, клиента и визита, а также боковая панель с чатом.
• Биллинг и уведомления: тарифы, ссылки на оплату, платежи, возвраты и скидки; каналы уведомлений и имена отправителя SMS.
• Статистика: статистика установок и конверсии, отзывы о приложении.

Каждое изменение сначала готовится как план: ассистент показывает точный запрос, ничего не записывая, и изменение применяется только после вашего одобрения. Необратимые и чувствительные шаги, например удаление приложения, возвраты, удаление данных или полная замена карточки приложения, дополнительно требуют точной фразы подтверждения. Перед любым действием Altegio Integrations Hub MCP проверяет, что ваш пользователь Altegio ведёт этот аккаунт разработчика, поэтому он не может изменить приложение другого разработчика. Сервер не создаёт изображения: подготовьте иконку и скриншоты отдельно и передайте их ассистенту.

Полное руководство для разработчиков находится в документации Integrations Hub MCP для разработчиков. О ручном способе публикации приложения читайте в статье Пошаговый гайд по размещению в маркетплейсе.

Доступ и безопасность

• Вход: при первом подключении ИИ-приложения к MCP-серверу Altegio открывается страница Sign in to Altegio. На этой странице вы вводите email и пароль от Altegio, и пароль не передаётся ИИ-приложению. Копировать токен вручную не нужно.
• Доступ: ассистент работает только с вашей учётной записью, доступными ей локациями и, в Altegio Integrations Hub MCP, с вашими приложениями разработчика.
• Доступ только для чтения: чтобы дать ассистенту ваши данные без возможности их изменять, подключите Altegio Pro MCP (read-only) вместо Altegio Pro MCP.
• Сессия: вход действует, пока ИИ-приложение использует подключение. Если подключение не используется 7 дней, нужно войти заново.
• Отключение: MCP-сервер Altegio можно отключить в любой момент в настройках коннекторов вашего ИИ-приложения.
• Агенты без браузера: автоматический агент, который не может открыть страницу входа, может подключиться с вашим пользовательским токеном Altegio в заголовке Authorization: Bearer <user token>. Некоторые приложения передают его в заголовке X-Altegio-User-Token. Как получить пользовательский токен: Как получить АПИ ключи.

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