Інструменти MCP Requiply
Це інструменти, які MCP-сервер Requiply пропонує підключеному асистенту. Інструменти лише для читання можна викликати вільно. Кожен інструмент, що щось змінює, спершу показує попередній перегляд і зберігає зміни лише після вашого підтвердження. Як вони працюють на практиці, дивіться в розділі Сценарії використання.
Як асистент працює з Requiply
Requiply надає невеликий узгоджений набір інструментів. Ці інструменти потрібні, щоб асистент зорієнтувався, перш ніж працювати з даними:
| Інструмент | Що він робить |
|---|---|
whoami | Повертає профіль бізнесу (валюта, мова, часовий пояс, робочі години й вихідні дні, локації, способи оплати й доставки), відомості про те, від чийого імені діє асистент, матрицю доступу для кожного типу обʼєктів і список співробітників з їхніми групами дозволів. Асистенти викликають його першим у розмові. |
describe | Виявлення схеми. Показує типи обʼєктів, доступні підключенню, розділи налаштувань і теми інструкцій. Для одного типу обʼєктів повертає поля, фільтри, актуальні значення, як-от статуси бронювань чи категорії, ваші власні поля бронювань, клієнтів і груп товарів, а також поля, за якими objects_query може фільтрувати й групувати. Для розділу налаштувань повертає поля цього розділу. |
get_guidance | Повертає докладні інструкції для завдання: усі макроси, які підтримує ваша організація (зокрема ваші власні поля), правила формату шаблонів, структуру тригерів і дій автоматизацій із готовими рецептами, оператори фільтрів, каталог звітів, мову запитів і карту сторінок застосунку. |
get_profile | Повертає обліковий запис Requiply, від імені якого входить підключення: імʼя, email і організацію. Лише для підключень, у які виконано вхід як учасник. |
search_help | Шукає в цій базі знань, як працює Requiply і як щось налаштувати, а також читає сторінку повністю. Асистент посилається на сторінки, які використав. |
Макроси та структура автоматизацій надходять з інструментів, а не з памʼяті асистента. Тому шаблон, складений асистентом, використовує саме ті макроси, які є у вашій організації.
get_guidance приймає одну чи кілька з цих тем:
| Тема | Що вона охоплює |
|---|---|
getting_started | Як інструменти поєднуються між собою та правило «попередній перегляд, потім підтвердження» для записів. |
booking_rules | Робочі години, буфери, статус запиту, а також що запит на бронювання робить і чого не робить. |
email_template_macros | Усі {{macro}}, доступні в шаблонах листів, зокрема ваші власні поля. |
message_template_macros | Макроси та правила формату для шаблонів повідомлень SMS, Viber і Telegram. |
export_template_macros | Макроси та синтаксис колонок таблиць для шаблонів PDF-документів. |
template_conditionals | Блоки {{#if}} і поведінка порожніх значень. |
workflow_recipes | Структура тригерів і дій із готовими рецептами автоматизацій. |
workflow_filters | Назви властивостей фільтрів, оператори та формати значень для автоматизацій. |
reports_catalog | Який звіт відповідає на яке бізнес-питання та його параметри. |
query_language | Синтаксис objects_query: поля, оператори, дати, групування та розібрані приклади. |
app_navigation | Усі сторінки вебзастосунку Requiply зі шляхом у меню та посиланням, для питань «де знайти» і «як зробити». |
Записи
Записи читають двома загальними інструментами, а змінюють інструментом запису, названим для кожного типу. Аргумент objectType визначає, з чим працювати. Кожен запис, що має сторінку в Requiply, містить url, який її відкриває. Саме через нього асистенти дають посилання на записи.
| Тип обʼєкта | Читання | Запис | Примітки |
|---|---|---|---|
booking | Так | Через bookings_manage, власні поля через objects_manage | Пошук повертає скорочені рядки, а get повертає повний перелік товарів, послуг, оплат і власних полів. Номер бронювання, який бачить користувач, міститься в reservationOrgId. |
client | Так | Створення, оновлення, власні поля | Точний пошук за email чи телефоном, нечіткий пошук за імʼям. Створення захищене від дублікатів. Створення й оновлення приймають customFields. |
item_group | Так | Лише власні поля | Товари для оренди з залишками, цінами, кількісним ціноутворенням, власними полями й доступністю на період дат. Самі товари редагують у застосунку. |
sale_item | Так | Ні | Товари на продаж (Продажі): назва, артикул, штрихкод, категорія, ціна продажу, залишок на складі (може бути відʼємним), продано за останні 30 днів. purchaseCost лише для облікових записів із Дозволити керування залишками. Потрібні увімкнені продажі та дозвіл на продажі. |
sale | Так | Через sales_manage | Продажі товарів, окремі чи в бронюванні, від найновіших. Фільтри: kind (окремий продаж чи в бронюванні), status, unpaid, clientId, soldFrom, soldTo. Get повертає рядки, повернення та оплати. Номер, який бачить користувач, міститься в saleOrgId. Щоб отримати продаж за ним, передайте idKind="org". |
category | Так | Створення, оновлення | Категорії товарів, вкладені через parentId. |
service | Так | Створення, оновлення | Додаткові послуги. Їх архівують замість видалення. |
location | Так | Створення, оновлення | Локації видачі та повернення. |
reservation_status | Так | Ні | Статуси бронювань, за якими визначають id для автоматизацій і фільтрів. |
email_template, message_template, export_template | Так | Через templates_manage | У списку без вмісту. Вміст повертає get. templates_preview відображає шаблон на бронюванні. |
workflow | Так | Через workflows_manage | У списку з читабельним описом тригера та дії. Get повертає повну конфігурацію. |
bundle | Так | Ні | Комплекти, які можна забронювати, з їхніми товарами та знижкою. Передайте дати в пошук, щоб дізнатися, скільки наборів вільно. Комплекти створюють і редагують у застосунку. |
conversation | Так | Через conversations_manage | Скринька розмов, від найновіших: канал, контакт, привʼязаний клієнт, хто зараз відповідає (AI чи людина), власник, статус і кількість непрочитаних. Фільтри: view (needs_human, mine, ai, closed), period (today, week), channel. Get повертає останні повідомлення і те, чи можна ще надіслати відповідь у цьому каналі. |
comment | Так | Через comments_manage | Коментарі до бронювання, клієнта, одиниці чи завдання. Для пошуку потрібні entityType і entityId (стрічка одного запису) або mentionsMe=true (коментарі, у яких згадано вас, для підключень учасників). Системні записи не включаються, якщо не передати includeSystem=true. |
| Інструмент | Що він може |
|---|---|
objects_search | Показати список або шукати обʼєкти одного типу з довільним текстом у query, типізованими filters (дати, назви статусів, id клієнта, категорія, період доступності, вид скриньки) і пагінацією за курсором. |
objects_get | Отримати до 20 записів за id з повними деталями, зокрема з власними полями для бронювань, клієнтів і груп товарів. Для бронювань і продажів idKind="org" приймає номер, показаний у застосунку. |
objects_query | Відповідати на питання з фільтрами й групуванням щодо бронювань, клієнтів, груп товарів і продажів мовою RQL (Requiply Query Language), тобто JSON-запитом: умови, поєднані через AND і OR, за будь-яким полем, зокрема клієнтом, статусом, товарами та їхньою категорією, залишком до сплати й власними полями. Повертає відповідні записи з посиланнями або по одному рядку на групу з кількістю, сумами, середніми й медіанами, наприклад дохід за кожен місяць. Лише читання. Для грошових підсумків потрібен Доступ до звітності. |
objects_manage | Створити чи оновити клієнта, категорію, послугу або локацію, а також задати значення власних полів наявного бронювання, клієнта чи групи товарів (set_custom_fields). Потрібен відповідний дозвіл: Доступ до клієнтів для клієнтів, Доступ до інвентарю для категорій і власних полів груп товарів, Доступ до послуг для послуг, Доступ до бронювань для власних полів бронювань і Доступ до налаштувань для локацій. |
objects_search знаходить записи за назвою, номером або кількома фіксованими фільтрами. reports_run відповідає стандартними бізнес-звітами. objects_query охоплює питання між ними, як-от «бронювання в липні з дроном, які досі не оплачені» чи «клієнти з трьома й більше бронюваннями, які не бронювали з червня». Перед першим запитом асистенти читають тему інструкцій query_language.Інструменти для бронювань, продажів, доступності та цін
| Інструмент | Що він може |
|---|---|
availability_check | mode="items" повертає групи товарів, у яких хоча б одна одиниця вільна протягом усього періоду дат. mode="calendar" повертає кількість за днями для кожної групи товарів. |
pricing_quote | Розрахувати точну вартість за вибраними групами товарів, комплектами, послугами, датами оренди, кількісним ціноутворенням і, за потреби, знижкою клієнта. Дату без часу рахують від часу відкриття до часу закриття, а результат повторює використані дати. |
sales_manage | create записує окремий продаж товарів за ціною з каталогу, з клієнтом за бажанням (за id або за імʼям з email чи телефоном) і способом оплати. Попередній перегляд показує рядки, суму, попередження щодо залишків (залишок може стати відʼємним, продаж однаково дозволено) і чи працює спосіб оплати. Підтверджений виклик записує продаж і повертає посилання на оплату для онлайн-способів. Потрібен дозвіл Дозволити продаж товарів. Повернення, скасування, редагування рядків і позначення оплат як сплачених виконують у застосунку. |
bookings_manage | create_request створює бронювання в статусі, вибраному у вашій організації як Статус запитів на бронювання (Запит, якщо ви не змінили його в розділі Створення бронювання). Виклик попереднього перегляду перевіряє доступність, розраховує вартість набору й повертає підсумок. Підтверджений виклик створює запит. Інструмент приймає customFields бронювання з ключами полів, які показує describe. add_note додає до бронювання внутрішню нотатку, яку бачить лише персонал. Співробітники, чия група дозволів має Бронювання поза робочим часом, можуть попросити видачу чи повернення поза розкладом: для них інструмент передає allowOutsideWorkingHours. Співробітники, чия група має Коригування вартості та застави, також можуть передати одне adjustment (units, percent або amount, зі знаком), див. Коригування вартості бронювання. Співробітники з Дозволити продаж товарів можуть передати saleLines, щоб продати товари разом із бронюванням за ціною з каталогу. Попередній перегляд показує їх як saleSubtotal, вони входять у суму без жодних знижок, а їхній залишок зменшується після створення запиту. Запит також може містити bundles, які бронюються як їхні товари зі знижкою комплекту. |
Запит на бронювання ніколи не утримує інвентар і не приймає оплату. Співробітник схвалює його в застосунку. Під час схвалення доступність перевіряється знову. Зміни статусу, оплати й редагування товарів у наявному бронюванні виконують у застосунку.
Дати й час задаються за вашим місцевим часом. Асистенти передають дати й час без часового поясу, наприклад 2026-10-06T10:00:00, а Requiply читає їх у часовому поясі організації з Налаштувань дати та часу з урахуванням переходу на літній час. Дата без часу, як-от 2026-10-06, означає час відкриття для видачі та час закриття для повернення. Значення з власним зміщенням, як-от 2026-10-06T10:00:00+03:00, використовуються як є.
Робочі години перевіряються в попередньому перегляді. Коли видача чи повернення припадає на вихідний день або поза робочі години, попередній перегляд повідомляє про це в workingHours і вказує найближчий робочий день або дозволений проміжок. Асистент тоді не просить вас підтвердити, а пропонує інший час.
Кожне бізнес-правило перевіряється в попередньому перегляді. Коли запит неможливо забронювати так, як його сформульовано, попередній перегляд повертає bookable: false і список problems. Кожна проблема містить код, причину та nextStep, який асистент виконує, перш ніж просити вас підтвердити:
| Код | Значення | Що робить асистент далі |
|---|---|---|
working_hours | Видача чи повернення припадає на вихідний день або поза робочі години. | Пропонує найближчий допустимий час. |
minimum_duration | Коротше за Мінімальна тривалість бронювання з розділу Тривалість бронювання. | Пропонує найраніше повернення, яке буде прийнято. |
unavailable | Недостатньо вільного залишку на ці дати. | Повідомляє кількість вільних одиниць і пропонує інші дати, меншу кількість або схожий товар. |
not_found | Товар, послугу чи клієнта не знайдено. | Шукає ще раз або просить у вас дані клієнта. |
not_allowed | Ваша група дозволів або тариф не дозволяє частину запиту. | Пропонує продовжити без неї, наприклад без коригування. |
invalid_request | Щось у запиті сформовано неправильно, наприклад повернення раніше за видачу. | Виправляє запит і знову показує попередній перегляд. |
system_error | Тимчасовий збій. | Повторює спробу один раз. |
Проблеми повертаються як звичайні відповіді, а не як помилки. Тому асистент завжди розповідає, що сталося і що він пропонує натомість, а не зупиняється мовчки. pricing_quote і availability_check відповідають так само: доступність перевіряється саме на запитаний час з урахуванням ваших буферів бронювань.
Повторне «так» не створює подвійних бронювань. Якщо ви підтвердите той самий запит двічі протягом 30 хвилин (той самий клієнт, дати та набір), другий виклик поверне номер уже створеного запиту замість створення ще одного.
Розмови та коментарі
| Інструмент | Що він може |
|---|---|
conversations_manage | Дії зі скринькою від імені учасника, який увійшов. reply надсилає повідомлення клієнту в його каналі (Telegram, Instagram, Viber, OLX або вебчат). Учасник стає власником розмови, а AI-асистент перестає в ній відповідати. update передає розмову людині або назад AI (handler), закриває чи знову відкриває її (status), а також робить учасника власником або прибирає власника (assign). Попередній перегляд показує канал, співрозмовника, поточного власника, чи ще відкрите вікно відповіді каналу, а також причину, з якої відповідь може бути відхилено. На розмову, якою володіє інший учасник, асистент відповідає лише тоді, коли ви просите його перебрати її. Потрібні Доступ до розмов і підключення, у яке виконано вхід як учасник. API-ключі організації відповідати не можуть. |
comments_manage | add записує внутрішній коментар до бронювання, клієнта, одиниці чи завдання від імені учасника, який увійшов (API-ключ організації записує його без автора). mentionUserIds згадує учасників команди з whoami, які отримують push-сповіщення, а parentCommentId робить коментар відповіддю на інший коментар до того самого запису. Клієнти ніколи не бачать цих коментарів. |
Звітність
| Інструмент | На що він може відповісти |
|---|---|
reports_run | Один інструмент з аргументом report: revenue, bookings_summary, utilization, top_items, top_clients, outstanding, overdue, pipeline та inventory_status (одиниці, що зараз в оренді). За замовчуванням береться період за останні 30 днів. Потрібен дозвіл Доступ до звітності. |
Для питань, яких стандартні звіти не охоплюють, як-от дохід за кожен місяць для одного значення власного поля, асистент використовує objects_query (див. Записи).
Інструменти конфігурації
Читання й перевірка є окремими інструментами від змін, тому асистент може переглянути ваші налаштування, жодного разу не пропонуючи зміну. Інструменти читання працюють у кожному підключенні. Для інструментів запису потрібен Доступ до налаштувань, який група «Адміністратори» має завжди.
| Інструмент | Читає чи записує | Що він може |
|---|---|---|
settings_get | Читає | Повертає поточні налаштування одного розділу: organization (назва, опис, контактні дані, мова, а також ваші власні поля рівня організації), working_hours (часовий пояс і тижневий розклад), booking_rules (вибір дат, мінімальна тривалість, буфери), deposits і features. |
settings_manage | Записує | Оновлює один розділ лише тими полями, які треба змінити. Спершу показує різницю «до/після». Розділ organization також приймає customFields. Функції, яким потрібен вищий тариф, позначено як заблоковані: тут їх увімкнути не можна. |
templates_preview | Читає | Відображає шаблон листа, повідомлення (SMS, Viber, Telegram) чи експорту (PDF-документ) на реальному бронюванні без жодного збереження: збережений шаблон за id або незбережену чернетку. Повертає тему, HTML і звичайний текст, а також показує макроси, яких немає в організації. |
templates_manage | Записує | Створює, оновлює й видаляє шаблони листів, повідомлень і експорту. Попередній перегляд перевіряє шаблон і показує невідомі макроси. Видалити шаблон, який досі використовує автоматизація чи інший шаблон, неможливо. |
workflows_validate | Читає | Перевіряє повну чи часткову автоматизацію без збереження: перетворює id статусів і шаблонів на назви, перевіряє, що id співробітників належать учасникам, а формат шаблону повідомлення підходить каналу. Також попереджає, коли провайдера повідомлень не підключено. |
workflows_manage | Записує | Створює, оновлює, вмикає чи вимикає (set_enabled) і видаляє автоматизації. Окрім дій з email, push і повідомленнями клієнту, інструмент може налаштувати change_booking_status та send_group_push_notification, яка надсилає push-сповіщення групам дозволів за groupIds. whoami показує групу кожного учасника. |
Шаблони й автоматизації отримують у списку й читають через objects_search і objects_get, як і будь-які інші записи.
Зворотний звʼязок
| Інструмент | Що він робить |
|---|---|
send_feedback | Надсилає команді Requiply ваш відгук про ці інструменти: інструмент, що дав збій або повернув хибні дані, щось потрібне вам, чого не вміє жоден інструмент, або похвалу. Відгук містить лише ваші власні слова без імен, email і телефонів клієнтів і нічого не змінює у вашій організації. |
Підключення
Додайте Requiply як власний конектор у Claude або як власний MCP-сервер у ChatGPT, увійдіть через OAuth як адміністратор і почніть користуватися інструментами.
Сценарії використання
Запитання до асистента, підключеного до Requiply, інструменти MCP для відповіді на них і скорочені приклади того, що повертає кожен інструмент.