Model Context Protocol (MCP)

API Partnerskie Vignetim udostepnia pelny serwer Model Context Protocol (MCP), umozliwiajacy Twojemu asystentowi AI bezposrednia interakcje z API -- przegladanie produktow, tworzenie zamowien, zarzadzanie webhookami i wyszukiwanie dokumentacji -- bez opuszczania IDE.

Czym jest MCP?

MCP (Model Context Protocol) to otwarty protokol standaryzujacy sposob, w jaki aplikacje AI lacza sie z zewnetrznymi narzedziami i zrodlami danych. Dzieki serwerowi MCP Vignetim, Twoj asystent AI do kodowania staje sie klientem API Vignetim.

Mozliwosci

Kategoria	Narzedzia	Wymagane uwierzytelnianie
Produkty	`list_tickets`, `get_ticket`, `list_esim_packages`, `list_insurance_products`, `get_insurance_product`, `list_vehicle_categories`	Tak
Zamowienia	`create_order`, `list_orders`, `get_order`, `get_order_status`	Tak
Webhooki	`create_webhook`, `list_webhooks`, `update_webhook`, `delete_webhook`, `test_webhook`	Tak
Dokumentacja	`list_docs`, `get_doc`, `search_docs`, `get_openapi_spec`	Nie

Endpoint MCP

https://vignetim.com/api/mcp

Uwierzytelnianie

Narzedzia operacji API wymagaja danych uwierzytelniajacych API Partnerskiego w naglowkach HTTP:

Naglowek	Opis
`X-API-Key`	Twoj klucz API organizacji
`X-API-Secret`	Twoj sekret API organizacji
`X-Environment`	Opcjonalnie: `production` (domyslnie) lub `sandbox`

Narzedzia dokumentacji (list_docs, get_doc, search_docs, get_openapi_spec) dzialaja bez uwierzytelniania.

Jak to dziala

Twoj asystent AI laczy sie z https://vignetim.com/api/mcp
Odkrywa dostepne narzedzia (produkty, zamowienia, webhooki, dokumentacja)
Gdy poprosisz "wylistuj austriackie winiety", asystent wywoluje list_tickets z countryIsocode: "AT"
Serwer MCP podpisuje zapytanie za pomoca HMAC-SHA256 i przekazuje je do API Partnerskiego
Wyniki sa zwracane bezposrednio do Twojego asystenta

Serwer MCP obsluguje cala zlozonosc uwierzytelniania -- podpisywanie HMAC, znaczniki czasu, nonce -- wiec Twoj agent AI po prostu wywoluje narzedzia z prostymi parametrami.

Obsluga platform

Platforma	Transport	Przewodnik konfiguracji
Claude Code	Streamable HTTP	Vignetim Claude MCP →
Claude Desktop	Streamable HTTP	Vignetim Claude MCP →
Cursor	Streamable HTTP	Vignetim OpenAI MCP →
Windsurf	Streamable HTTP	Vignetim OpenAI MCP →
OpenAI Agents SDK	Streamable HTTP	Vignetim OpenAI MCP →
Continue	Streamable HTTP	Vignetim OpenAI MCP →

Dodatkowe zasoby

Specyfikacja OpenAPI: https://vignetim.com/api/partner-openapi
LLMs.txt: https://vignetim.com/llms.txt
AI Plugin: https://vignetim.com/.well-known/ai-plugin.json