MCP-сервер Requiply

Інтеграція AI є MCP-сервером Requiply, який підключає дані вашої організації до AI-асистентів із підтримкою Model Context Protocol (MCP). Завдяки йому асистент відповідає на практичні питання про бізнес на основі актуальних даних Requiply: каталогу, бронювань, клієнтів, цін, доступності, розмов у скриньці та звітів.

Ця сторінка розташована в Налаштування → Інтеграції → AI.

URL MCP-сервера:

https://api.requiply.com/api/mcp

Для доступу MCP-конектора Requiply використовує OAuth. Коли підтримуваний асистент підключається, користувач входить у Requiply і схвалює доступ. Копіювати в URL API-ключ чи секретний токен не потрібно.

Чому AI-інтеграція важлива

AI-інтеграція дає асистенту структурований спосіб працювати з Requiply замість здогадок на основі експортованих таблиць чи скриншотів. Після схвалення доступу асистент може викликати MCP-інструменти Requiply, щоб переглянути вашу організацію, знайти інвентар, перевірити доступність, розрахувати вартість, знайти клієнтів, переглянути бронювання, відповісти на питання щодо звітності й питання з фільтрами, читати розмови у скриньці й відповідати на них, а також залишати коментарі для команди. Користувачам із потрібними дозволами він також допомагає керувати шаблонами, автоматизаціями та налаштуваннями організації.

Типові сценарії використання:

• Дізнатися, яке обладнання вільне на певні дати.
• Оцінити вартість бронювання, перш ніж створювати запит на бронювання.
• Знайти клієнта за email, телефоном чи імʼям.
• Створити запит на бронювання для клієнта (очікує схвалення персоналу).
• Переглянути деталі бронювання та статус оплати.
• Перевірити дохід, завантаженість, прострочені бронювання, непогашені залишки й найкращих клієнтів.
• Відповісти на питання з кількома фільтрами, наприклад про неоплачені липневі бронювання з дроном чи дохід за кожен місяць цього року.
• Прочитати розмови в очікуванні команди та відповісти клієнту.
• Залишити коментар до бронювання зі згадкою колеги або прочитати коментарі, у яких згадано вас.
• Читати й заповнювати ваші власні поля бронювань, клієнтів і товарів.
• Написати чи виправити шаблон листа, повідомлення або документа з правильними макросами.
• Налаштувати автоматизацію, наприклад нагадування про видачу чи лист-підтвердження.
• Змінити робочі години, правила застав або буфери бронювань.
• Дізнатися, як щось працює в Requiply, з посиланнями на цю базу знань.

Кожен запис, який згадує асистент, має посилання, що відкриває його в Requiply. Тож з відповіді можна одразу перейти до бронювання, клієнта чи розмови.

Що означає MCP у Requiply

MCP є протокольним рівнем, завдяки якому AI-асистенти використовують Requiply як підключене джерело інструментів. Асистент не лише читає статичну сторінку: він запитує в інструментів Requiply структурований JSON і використовує ці результати у своїй відповіді.

Доступ обмежено автентифікованим обліковим записом Requiply та його організацією. Схвалити підключення може лише користувач із роллю адміністратора (група дозволів Адміністратори, див. Групи дозволів). Ця група завжди має всі дозволи доступу, тому підключений асистент може користуватися всіма інструментами нижче. Виняток становлять дозволи з розділів Створення бронювань і Комунікації, які для адміністраторів можна вимкнути. Наприклад, якщо для групи вимкнено Бронювання поза робочим часом, асистент теж не зможе створити запит на бронювання поза робочими годинами. API-ключі організації діють від імені всієї організації.

Розмови доступні лише тоді, коли увімкнено функцію Скринька розмов. Відповідати на них або перебирати їх на себе може лише підключення, у яке виконано вхід як учасник, бо відповідь надсилається від імені цього учасника.

Кожен інструмент або лише читає дані, або записує їх, але ніколи не робить обидва. Інструменти лише для читання (whoami, describe, get_guidance, get_profile, objects_search, objects_get, objects_query, availability_check, pricing_quote, reports_run, settings_get, templates_preview, workflows_validate, search_help) ніколи нічого не змінюють, тому асистент може викликати їх вільно. Інструменти, які змінюють дані вашої організації, завжди спершу показують попередній перегляд.

Що варто знати

• Інструменти повертають результати як структурований JSON, тому асистент може підсумовувати, порівнювати, фільтрувати й поєднувати їх.
• Кожен запис, який згадує асистент, містить url, що відкриває його в Requiply.
• Записи завжди спершу виконуються як попередній перегляд і зберігаються лише тоді, коли асистент повторює виклик із confirmed=true після вашого схвалення. Попередній перегляд містить точні значення або різницю «до/після», яку буде збережено.
• Видаляти можна лише шаблони й автоматизації. Шаблон, який досі використовує автоматизація чи інший шаблон, видалити не можна. Категорії, локації та послуги через асистента ніколи не видаляються: послуги натомість архівуються.
• Запит на бронювання, створений асистентом, отримує ваш Статус запитів на бронювання й очікує схвалення персоналу. Під час схвалення доступність перевіряється знову, приймається оплата й утримується інвентар. До того запит нічого з цього не робить.
• Що асистент може бачити та змінювати, залежить від дозволів облікового запису, через який його підключено. whoami показує матрицю доступу, а асистент має пояснити, якого дозволу бракує, замість того щоб пробувати внести зміну.
• AI-інтеграція працює з даними організації автентифікованого облікового запису Requiply.
• URL MCP-сервера не містить секретного ключа. Автентифікація відбувається через вхід і схвалення в OAuth.

Більше про MCP Requiply

• Підключення асистента: як крок за кроком додати Requiply до Claude або ChatGPT через OAuth.
• Інструменти MCP: кожен інструмент: які записи він читає та змінює і які дозволи йому потрібні.
• Сценарії використання: що можна запитати і який JSON повертають інструменти.
• Усунення проблем: помилки входу, відхилені зміни та інструменти, що не зʼявляються.