---
title: "Сценарії використання MCP Requiply"
description: "Запитання до асистента, підключеного до Requiply, інструменти MCP для відповіді на них і скорочені приклади того, що повертає кожен інструмент."
canonical_url: "https://requiply.com/docs/uk/ai/mcp/use-cases"
---
# Сценарії використання MCP Requiply

> Запитання до асистента, підключеного до Requiply, інструменти MCP для відповіді на них і скорочені приклади того, що повертає кожен інструмент.

Запитання, які можна поставити асистенту, підключеному до Requiply, з [інструментами](https://requiply.com/docs/uk/ai/mcp/tools), якими він на них відповідає.

## Приклади питань

<table>
<thead>
  <tr>
    <th>
      Що можна запитати в асистента
    </th>
    
    <th>
      Ймовірні MCP-інструменти Requiply
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      «Як ми попрацювали минулого місяця?»
    </td>
    
    <td>
      <strong>
        <code>
          whoami
        </code>
      </strong>
      
      , <strong>
        <code>
          reports_run
        </code>
      </strong>
      
       (<code>
        bookings_summary
      </code>
      
      , <code>
        revenue
      </code>
      
      )
    </td>
  </tr>
  
  <tr>
    <td>
      «Яке обладнання вільне на ці вихідні?»
    </td>
    
    <td>
      <strong>
        <code>
          availability_check
        </code>
      </strong>
    </td>
  </tr>
  
  <tr>
    <td>
      «Скільки коштуватимуть дві камери з пʼятниці до понеділка?»
    </td>
    
    <td>
      <strong>
        <code>
          objects_search
        </code>
      </strong>
      
       (<code>
        item_group
      </code>
      
      ), <strong>
        <code>
          pricing_quote
        </code>
      </strong>
    </td>
  </tr>
  
  <tr>
    <td>
      «Які товари використовуються замало?»
    </td>
    
    <td>
      <strong>
        <code>
          reports_run
        </code>
      </strong>
      
       (<code>
        utilization
      </code>
      
      , <code>
        top_items
      </code>
      
      )
    </td>
  </tr>
  
  <tr>
    <td>
      «Хто нам винен?»
    </td>
    
    <td>
      <strong>
        <code>
          reports_run
        </code>
      </strong>
      
       (<code>
        outstanding
      </code>
      
      )
    </td>
  </tr>
  
  <tr>
    <td>
      «Які липневі весілля з дроном досі не оплачені?»
    </td>
    
    <td>
      <strong>
        <code>
          describe
        </code>
      </strong>
      
       (<code>
        booking
      </code>
      
      ), <strong>
        <code>
          get_guidance
        </code>
      </strong>
      
       (<code>
        query_language
      </code>
      
      ), <strong>
        <code>
          objects_query
        </code>
      </strong>
    </td>
  </tr>
  
  <tr>
    <td>
      «Дохід за кожен місяць цього року з медіанним бронюванням»
    </td>
    
    <td>
      <strong>
        <code>
          objects_query
        </code>
      </strong>
      
       (<code>
        groupBy
      </code>
      
       за місяцем, <code>
        sum
      </code>
      
      , <code>
        median
      </code>
      
      )
    </td>
  </tr>
  
  <tr>
    <td>
      «Які постійні клієнти не бронювали з червня?»
    </td>
    
    <td>
      <strong>
        <code>
          objects_query
        </code>
      </strong>
      
       (<code>
        client
      </code>
      
      )
    </td>
  </tr>
  
  <tr>
    <td>
      «Покажи бронювання #24»
    </td>
    
    <td>
      <strong>
        <code>
          objects_get
        </code>
      </strong>
      
       (<code>
        booking
      </code>
      
      , <code>
        idKind="org"
      </code>
      
      )
    </td>
  </tr>
  
  <tr>
    <td>
      «Встанови тип події в бронюванні #24 на Весілля»
    </td>
    
    <td>
      <strong>
        <code>
          describe
        </code>
      </strong>
      
       (<code>
        booking
      </code>
      
      ), <strong>
        <code>
          objects_manage
        </code>
      </strong>
      
       (<code>
        set_custom_fields
      </code>
      
      , попередній перегляд, потім підтвердження)
    </td>
  </tr>
  
  <tr>
    <td>
      «Створи запит на бронювання двох камер на наступну пʼятницю»
    </td>
    
    <td>
      <strong>
        <code>
          availability_check
        </code>
      </strong>
      
      , <strong>
        <code>
          bookings_manage
        </code>
      </strong>
      
       (попередній перегляд, потім підтвердження)
    </td>
  </tr>
  
  <tr>
    <td>
      «Які розмови чекають на нас?»
    </td>
    
    <td>
      <strong>
        <code>
          objects_search
        </code>
      </strong>
      
       (<code>
        conversation
      </code>
      
      , <code>
        view="needs_human"
      </code>
      
      )
    </td>
  </tr>
  
  <tr>
    <td>
      «Відповідай Олені, що намет вільний у суботу»
    </td>
    
    <td>
      <strong>
        <code>
          objects_get
        </code>
      </strong>
      
       (<code>
        conversation
      </code>
      
      ), <strong>
        <code>
          conversations_manage
        </code>
      </strong>
      
       (<code>
        reply
      </code>
      
      , попередній перегляд, потім підтвердження)
    </td>
  </tr>
  
  <tr>
    <td>
      «Поверни цей чат AI»
    </td>
    
    <td>
      <strong>
        <code>
          conversations_manage
        </code>
      </strong>
      
       (<code>
        update
      </code>
      
      , <code>
        handler="ai"
      </code>
      
      )
    </td>
  </tr>
  
  <tr>
    <td>
      «Де команда мене згадала?»
    </td>
    
    <td>
      <strong>
        <code>
          objects_search
        </code>
      </strong>
      
       (<code>
        comment
      </code>
      
      , <code>
        mentionsMe=true
      </code>
      
      )
    </td>
  </tr>
  
  <tr>
    <td>
      «Залиш нотатку до бронювання #24 для Андрія, щоб перевірив кабелі»
    </td>
    
    <td>
      <strong>
        <code>
          whoami
        </code>
      </strong>
      
       (учасники), <strong>
        <code>
          comments_manage
        </code>
      </strong>
      
       (<code>
        add
      </code>
      
       зі згадкою, попередній перегляд, потім підтвердження)
    </td>
  </tr>
  
  <tr>
    <td>
      «Скільки SD-карт у нас залишилося?»
    </td>
    
    <td>
      <strong>
        <code>
          objects_search
        </code>
      </strong>
      
       (<code>
        sale_item
      </code>
      
      )
    </td>
  </tr>
  
  <tr>
    <td>
      «Запиши продаж двох акумуляторів Олені, оплата на місці»
    </td>
    
    <td>
      <strong>
        <code>
          objects_search
        </code>
      </strong>
      
       (<code>
        sale_item
      </code>
      
      , <code>
        client
      </code>
      
      ), <strong>
        <code>
          sales_manage
        </code>
      </strong>
      
       (попередній перегляд, потім підтвердження)
    </td>
  </tr>
  
  <tr>
    <td>
      «Які продажі досі не оплачені?»
    </td>
    
    <td>
      <strong>
        <code>
          objects_search
        </code>
      </strong>
      
       (<code>
        sale
      </code>
      
      , <code>
        unpaid=true
      </code>
      
      )
    </td>
  </tr>
  
  <tr>
    <td>
      «Напиши лист-підтвердження, який показує заставу лише тоді, коли вона є»
    </td>
    
    <td>
      <strong>
        <code>
          get_guidance
        </code>
      </strong>
      
       (<code>
        email_template_macros
      </code>
      
      ), <strong>
        <code>
          templates_preview
        </code>
      </strong>
      
      , <strong>
        <code>
          templates_manage
        </code>
      </strong>
      
       (створення)
    </td>
  </tr>
  
  <tr>
    <td>
      «Надсилай нагадування за 24 години до видачі»
    </td>
    
    <td>
      <strong>
        <code>
          get_guidance
        </code>
      </strong>
      
       (<code>
        workflow_recipes
      </code>
      
      ), <strong>
        <code>
          objects_search
        </code>
      </strong>
      
       (<code>
        message_template
      </code>
      
      ), <strong>
        <code>
          workflows_validate
        </code>
      </strong>
      
      , <strong>
        <code>
          workflows_manage
        </code>
      </strong>
      
       (створення)
    </td>
  </tr>
  
  <tr>
    <td>
      «Які в нас робочі години?»
    </td>
    
    <td>
      <strong>
        <code>
          settings_get
        </code>
      </strong>
      
       (<code>
        working_hours
      </code>
      
      )
    </td>
  </tr>
  
  <tr>
    <td>
      «Відтепер ми не працюємо в неділю»
    </td>
    
    <td>
      <strong>
        <code>
          settings_manage
        </code>
      </strong>
      
       (<code>
        working_hours
      </code>
      
      , попередній перегляд, потім підтвердження)
    </td>
  </tr>
  
  <tr>
    <td>
      «Як налаштувати онлайн-оплату?»
    </td>
    
    <td>
      <strong>
        <code>
          search_help
        </code>
      </strong>
      
      , <strong>
        <code>
          get_guidance
        </code>
      </strong>
      
       (<code>
        app_navigation
      </code>
      
      )
    </td>
  </tr>
</tbody>
</table>

## Сценарії з прикладами відповідей

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

<note>

Приклади наведено для ілюстрації. Довгі поля (URL зображень, id) скорочено, дані клієнтів анонімізовано, а списки обрізано. Назви полів і структура збігаються з тим, що насправді повертають інструменти.

</note>

### Огляд бізнесу

**Запит:** «Дай мені огляд бізнесу». → **whoami**

<details>
<summary>

Приклад відповіді

</summary>

```json
{
  "organization": {
    "name": "Acme Rentals",
    "currency": "UAH",
    "language": "uk",
    "timezone": "Europe/Kyiv",
    "tier": "advanced",
    "workingHours": [
      { "day": "monday", "startTime": "09:00", "endTime": "18:00", "isWorkingDay": true },
      { "day": "sunday", "startTime": "00:00", "endTime": "23:59", "isWorkingDay": false }
    ]
  },
  "locations": [
    { "name": "Main Studio", "city": "Lviv", "country": "Ukraine", "isDefault": true }
  ],
  "supportedPaymentMethods": ["payOnPickup", "monobank"],
  "stats": { "totalClients": 30, "totalItemGroups": 9, "bookingsActiveNow": 0, "bookingsUpcoming": 1 },
  "caller": { "kind": "user", "name": "Olena K.", "isAdmin": true },
  "access": {
    "objects": { "booking": "write", "client": "write", "item_group": "read", "workflow": "write" },
    "reports": true,
    "settings": "write"
  },
  "members": [{ "userId": "8c1d…", "name": "Olena K.", "isAdmin": true }]
}
```

</details>

### Перевірка вільного на період дат

**Запит:** «Що ми можемо запропонувати з 19 по 21 червня?» → **availability_check** з `mode="items"`

Повертає лише групи товарів, у яких хоча б одна одиниця вільна в кожен день періоду.

<details>
<summary>

Приклад відповіді

</summary>

```json
{
  "items": [
    {
      "id": "80e9332d-…",
      "name": "ATEM Mini Pro",
      "sku": "ATEM-MIPR",
      "priceType": "day",
      "basePrice": 400,
      "currency": "UAH",
      "totalQuantity": 1,
      "availableQuantity": 1,
      "pricingTiers": []
    }
  ],
  "nextCursor": null
}
```

</details>

### Пошук бронювання за номером

**Запит:** «Що входить у бронювання #9?» → **objects_get** з `objectType="booking"`, `ids=[9]`, `idKind="org"`

<details>
<summary>

Приклад відповіді

</summary>

```json
{
  "objectType": "booking",
  "results": [
    {
      "id": 9,
      "record": {
        "id": 253,
        "reservationOrgId": 9,
        "startDate": "2026-07-01T10:00:00+00:00",
        "endDate": "2026-07-03T10:00:00+00:00",
        "totalCost": 700,
        "currency": "UAH",
        "items": [{ "groupId": "d73e…", "name": "Rode Procaster", "quantity": 1 }],
        "services": [],
        "payments": []
      }
    }
  ]
}
```

</details>

### Огляд результатів за період

**Запит:** «Як ми попрацювали цього року?» → **reports_run** з `report="bookings_summary"`

<details>
<summary>

Приклад відповіді

</summary>

```json
{
  "report": "bookings_summary",
  "currency": "UAH",
  "dateFrom": "2026-01-01",
  "dateTo": "2026-09-08",
  "totals": { "totalBookings": 12, "totalRevenue": 41000, "avgOrderValue": 3416.67, "medianOrderValue": 2800 },
  "rates": { "cancellationRate": 0.08, "completionRate": 0.75 },
  "timing": { "avgLeadTimeDays": 6.4, "avgDurationDays": 2.1 },
  "byStatus": [{ "statusName": "Completed", "count": 9, "percentage": 75 }]
}
```

</details>

### Створення запиту на бронювання (запис)

**Запит:** «Забронюй ATEM Mini Pro з 6 по 8 жовтня для [jordan.lee@example.com](mailto:jordan.lee@example.com)».

Асистент викликає **bookings_manage** з `operation="create_request"` без прапорця `confirmed`. Попередній перегляд перевіряє доступність, розраховує вартість набору й повертає підсумок, який асистент показує вам.

<details>
<summary>

Приклад відповіді (попередній перегляд)

</summary>

```json
{
  "applied": false,
  "operation": "create_request",
  "preview": {
    "startDate": "2026-10-06T10:00:00",
    "endDate": "2026-10-08T18:00:00",
    "deliveryType": "pickup",
    "client": { "name": "Jordan", "email": "jordan.lee@example.com" },
    "lineItems": [{ "name": "ATEM Mini Pro", "quantity": 1, "unitPrice": 400, "unitCount": 3, "subtotal": 1200 }],
    "total": 1200,
    "currency": "UAH",
    "status": "Request (pending staff approval; inventory is not held)"
  },
  "warnings": [],
  "message": "Nothing was saved. Show the preview to the user, then call again with confirmed=true to apply it."
}
```

</details>

Після вашого схвалення той самий виклик із `confirmed=true` створює запит і повертає номер бронювання.

<details>
<summary>

Приклад відповіді (підтверджено)

</summary>

```json
{
  "applied": true,
  "operation": "create_request",
  "preview": { "reservationId": 318, "reservationOrgId": 24, "totalCost": 1200, "currency": "UAH" },
  "message": "Booking request #24 created as a request; staff will review it."
}
```

</details>

### Створення шаблону листа з макросами

**Запит:** «Створи лист-підтвердження, який показує заставу лише тоді, коли ми її беремо».

1. **get_guidance** з `topics=["email_template_macros"]` повертає всі макроси, зокрема ваші власні поля.
2. **templates_preview** з чернеткою відображає її на недавньому бронюванні без жодного збереження. Невідомі макроси потрапляють у список, щоб асистент виправив їх до збереження.
3. **templates_manage** з `operation="create"` показує перевірений шаблон, а підтверджений виклик зберігає його.

<details>
<summary>

Приклад відповіді (попередній перегляд)

</summary>

```json
{
  "bookingId": 253,
  "bookingNumber": 9,
  "subject": "Booking #9 confirmed",
  "html": "<p>Hi Alex, your total is 700,00 ₴.</p><table>…</table>",
  "text": "Hi Alex, your total is 700,00 ₴. …",
  "unknownMacros": ["{{totalPrice}}"]
}
```

</details>

### Налаштування автоматизації

**Запит:** «Надсилай шаблон підтвердження email-листом, коли бронювання переходить у статус Підтверджено».

Асистент визначає id статусу через **objects_search** (`reservation_status`) та id шаблону через **objects_search** (`email_template`), потім перевіряє чернетку через **workflows_validate** і викликає **workflows_manage** з `operation="create"`. Попередній перегляд показує визначені назви, щоб ви перевірили їх перед підтвердженням.

<details>
<summary>

Приклад відповіді (попередній перегляд)

</summary>

```json
{
  "applied": false,
  "operation": "create",
  "preview": {
    "name": "Confirmation email",
    "isEnabled": true,
    "triggerType": "status_reached",
    "triggerConfig": { "statusId": "5b1d0c3e-…" },
    "actionType": "send_email",
    "actionConfig": { "templateId": "2a967b5e-…" },
    "filtersConfig": null,
    "resolved": { "triggerConfig.statusId": "Confirmed", "actionConfig.templateId": "Booking confirmation" }
  },
  "warnings": [],
  "message": "Nothing was saved. Show the preview to the user, then call again with confirmed=true to apply it."
}
```

</details>

### Зміна налаштування

**Запит:** «Бери заставу 20% з кожного бронювання». → **settings_manage** з `section="deposits"` і `patch` з полями, які треба змінити

<details>
<summary>

Приклад відповіді (попередній перегляд)

</summary>

```json
{
  "applied": false,
  "operation": "update",
  "objectType": "settings.deposits",
  "preview": { "depositMethod": "percentage", "depositValue": 20 },
  "changes": [
    { "field": "depositMethod", "before": "none", "after": "percentage" },
    { "field": "depositValue", "before": 0, "after": 20 }
  ],
  "message": "Nothing was saved. Show the preview to the user, then call again with confirmed=true to apply it."
}
```

</details>


## Sitemap

See the full [sitemap](https://requiply.com/docs/sitemap.md) for all pages.