AI-інтеграції — сервер MCP
G-Serwis надає MCP-сервер (Model Context Protocol) для працівників сервісу. Після входу працівника асистент AI — ChatGPT, Claude, Cursor або Lovable — може читати заявки, замовлення, автопарк і касу та змінювати статус замовлення. Доступ мають лише робочі акаунти.
https://www.gserwis.com/mcp
Як підключитися
- 01
В AI-клієнті додайте MCP-сервер за адресою https://www.gserwis.com/mcp (транспорт: Streamable HTTP).
- 02
Клієнт відкриє сторінку згоди OAuth — увійдіть робочим акаунтом G-Serwis і підтвердьте доступ.
- 03
Після підтвердження клієнт сам отримає список інструментів. Доступ відкликається в панелі: Admin → Agenci AI.
Доступні інструменти
| Інструмент | Параметри | Призначення |
|---|---|---|
| workshop_summary | — | Огляд бізнесу: парк і доступність, нові заявки, кількість клієнтів, відкриті замовлення та каса. |
| list_service_requests | limit?: number (1–100, domyślnie 20) | Заявки із сервісної форми, від новіших до старіших. |
| list_service_orders | status?: string, limit?: number | Замовлення майстерні з клієнтом, авто та сумою. |
| set_service_order_status | id: uuid, status: "new" | "in_progress" | "waiting_parts" | "done" | "cancelled" | Зміна статусу замовлення; «done» ставить час закриття. |
| list_rental_bookings | status?: string, limit?: number | Броні G RENT разом із призначеним авто. |
| list_fleet | — | Повний парк із внутрішніми даними: номер, VIN, терміни страховки та техогляду. |
Приклад виклику
Виклики йдуть через JSON-RPC 2.0 з OAuth-токеном у заголовку Authorization:
curl -X POST https://www.gserwis.com/mcp \
-H "Authorization: Bearer <token OAuth>" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "list_service_orders",
"arguments": { "status": "in_progress", "limit": 10 }
}
}'Безпека та ліміти
- Кожен виклик виконується від імені працівника, що увійшов — дані обмежує RLS і функція is_staff, а не сам MCP-сервер.
- Ліміт 30 викликів на хвилину на працівника захищає від флуду; перевищення повертає помилку інструмента.
- Кожен виклик пишеться в журнал (хто, інструмент, параметри, результат, час) і видно в Admin → Agenci AI.
- Токени ніколи не зберігаються і не повертаються у відповідях інструментів.