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.
- Токены никогда не сохраняются и не возвращаются в ответах инструментов.