MCP-сервери Altegio для AI-помічників

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

Основні поняття

• MCP (Model Context Protocol): відкритий стандарт підключення AI-додатків до зовнішніх сервісів.
• MCP-сервер: сервіс, який надає AI-додатку набір інструментів для роботи із системою. У деяких AI-додатках MCP-сервер називається конектором або користувацьким додатком.
• AI-додаток (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	Створення, налаштування, тестування та надсилання на модерацію власних додатків для Маркетплейсу	Лише ваші додатки розробника

До одного AI-додатка можна підключити кілька MCP-серверів. Наприклад, Altegio Pro MCP працює з вашими даними, а Altegio Knowledge MCP відповідає на запитання про продукт за базою знань.

Коли використовувати

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

Що знадобиться

• Обліковий запис Altegio: email і пароль, з якими ви входите в Altegio. Помічник працює від імені цього облікового запису.
• AI-додаток: додаток, який підтримує віддалені 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 (read-only) та Altegio Integrations Hub MCP перелічені в Altegio в розділі Налаштування > Інтеграції та доступ > Штучний інтелект — помічники, у картці Підключення Altegio до штучного інтелекту через MCP. Усі 4 сервери, зокрема Altegio Knowledge MCP, є в Маркетплейсі, у розділі Інтеграції > Програми та асистенти штучного інтелекту.

Щоб підключити MCP-сервер Altegio:

1. Скопіюйте адресу потрібного сервера з таблиці вище. Адреса також вказана на сторінці сервера в Маркетплейсі.
2. Вставте адресу в Claude, ChatGPT, Cursor або інший AI-додаток.
3. Увійдіть з email і паролем від Altegio на сторінці Sign in to 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 рядків, загальну кількість рядків і назви полів. Якщо налаштування зупинилося через помилку, його можна продовжити з того самого кроку, а будь-який завершений крок можна скасувати.

Щоб почати, попросіть помічника налаштувати вашу філію. В AI-додатках, які показують готові сценарії MCP-сервера, виберіть Set up a location for the first time.

Видалення даних потребує окремого підтвердження

Перш ніж Altegio Pro MCP видалить співробітника, послугу, категорію послуг, графік роботи, запис, форму онлайн-запису або клієнта, відв’яже співробітника від послуги або скасує крок налаштування, видалення потрібно підтвердити саме для цього об’єкта. В AI-додатках, які підтримують запити на підтвердження, 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 співробітників; робочі, зайняті та вільні години; продажі співробітників: послуги, товари, виторг і майбутні записи; виторг за співробітниками та послугами.
• Клієнти: продажі за клієнтами; нові, повторні та повернуті клієнти за співробітниками; візити, пропущені візити, витрати та баланс рахунку одного клієнта; прогноз візитів клієнтів; неактивні клієнти, яких можна повернути; результати програми лояльності.
• Гроші: рентабельність послуг (виторг, витрати та оплата співробітників за послугами або категоріями); прибутки та збитки за статтями доходів і витрат; рух коштів за статтями платежів і рахунками; звіт за підсумками дня: клієнти, продані послуги та товари, абонементи та сертифікати, надходження за рахунками (готівка та картка) і списання; втрачений виторг через неявки, скасування, знижки та незаповнений час.
• Завантаження: заплановані, заброньовані, використані та вільні години за годинами дня, днями тижня або датами, з піковими й тихими годинами.
• Товари та групові події: продажі товарів за товарами або категоріями із собівартістю та націнкою; товари, які час дозамовити, з урахуванням швидкості продажів і залишків; результати групових подій: місця, записані, присутні та учасники, що оплатили.

В AI-додатках, які показують готові сценарії 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 для розробників. Про ручний спосіб публікації додатка читайте в статті Покроковий гайд з розміщення в маркетплейсі.

Доступ і безпека

• Вхід: під час першого підключення AI-додатка до MCP-сервера Altegio відкривається сторінка Sign in to Altegio. На цій сторінці ви вводите email і пароль від Altegio, і пароль не передається AI-додатку. Копіювати токен вручну не потрібно.
• Доступ: помічник працює лише з вашим обліковим записом, доступними йому філіями та, в Altegio Integrations Hub MCP, з вашими додатками розробника.
• Доступ лише для читання: щоб надати помічнику ваші дані без можливості їх змінювати, підключіть Altegio Pro MCP (read-only) замість Altegio Pro MCP.
• Сесія: вхід діє, поки AI-додаток використовує підключення. Якщо підключення не використовується 7 днів, потрібно увійти знову.
• Відключення: MCP-сервер Altegio можна відключити будь-коли в налаштуваннях конекторів вашого AI-додатка.
• Агенти без браузера: автоматичний агент, який не може відкрити сторінку входу, може підключитися з вашим токеном користувача Altegio в заголовку Authorization: Bearer <user token>. Деякі додатки передають його в заголовку X-Altegio-User-Token. Як отримати токен користувача: Як отримати API-ключі (EN).

Часті питання