Integracje AI — serwer MCP
G-Serwis udostępnia serwer MCP (Model Context Protocol) dla pracowników warsztatu. Asystent AI — ChatGPT, Claude, Cursor czy Lovable — po zalogowaniu pracownika może czytać zapytania, zlecenia, flotę i kasę oraz zmieniać status zlecenia. Dostęp mają wyłącznie konta pracownicze.
https://www.gserwis.com/mcp
Jak się podłączyć
- 01
W kliencie AI dodaj serwer MCP o adresie https://www.gserwis.com/mcp (transport: Streamable HTTP).
- 02
Klient przekieruje Cię na stronę zgody OAuth — zaloguj się kontem pracownika G-Serwis i zatwierdź dostęp.
- 03
Po zatwierdzeniu klient pobiera listę narzędzi automatycznie. Dostęp można odebrać w panelu: Admin → Agenci AI.
Dostępne narzędzia
| Narzędzie | Parametry | Do czego służy |
|---|---|---|
| workshop_summary | — | Przegląd firmy: flota i dostępność, nowe zapytania, liczba klientów, otwarte zlecenia i stan kasy. |
| list_service_requests | limit?: number (1–100, domyślnie 20) | Zapytania z formularza serwisowego, od najnowszego. |
| list_service_orders | status?: string, limit?: number | Zlecenia warsztatowe z klientem, pojazdem i wartością. |
| set_service_order_status | id: uuid, status: "new" | "in_progress" | "waiting_parts" | "done" | "cancelled" | Zmiana statusu zlecenia; status „done” stempluje czas zamknięcia. |
| list_rental_bookings | status?: string, limit?: number | Rezerwacje G RENT wraz z przypisanym autem. |
| list_fleet | — | Pełna flota z danymi wewnętrznymi: numer rejestracyjny, VIN, terminy OC i przeglądu. |
Przykład wywołania
Wywołania idą przez JSON-RPC 2.0 z tokenem OAuth w nagłówku 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 }
}
}'Bezpieczeństwo i limity
- Każde wywołanie działa w imieniu zalogowanego pracownika — dane ogranicza RLS i funkcja is_staff, nie sam serwer MCP.
- Limit 30 wywołań na minutę na pracownika chroni przed floodem; przekroczenie zwraca błąd narzędzia.
- Każde wywołanie jest zapisywane w dzienniku (kto, narzędzie, parametry, wynik, czas) i widoczne w Admin → Agenci AI.
- Tokeny nigdy nie są zapisywane ani zwracane w odpowiedziach narzędzi.