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_ticketszcountryIsocode: "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