Model Context Protocol (MCP)
Vignetim Partner API zagotavlja poln strežnik Model Context Protocol (MCP), ki vašemu AI asistentu omogoča neposredno interakcijo z API-jem -- pregledovanje produktov, ustvarjanje naročil, upravljanje webhookov in iskanje po dokumentaciji -- vse brez zapuščanja vašega razvojnega okolja (IDE).
Kaj je MCP?
MCP je odprt protokol, ki standardizira način, kako se AI aplikacije povezujejo z zunanjimi orodji in viri podatkov. Z Vignetim MCP strežnikom vaš AI programerski asistent postane Vignetim API odjemalec.
Zmožnosti
| Kategorija | Orodja | Avtentikacija zahtevana |
|---|---|---|
| Produkti | list_tickets, get_ticket, list_esim_packages, list_insurance_products, get_insurance_product, list_vehicle_categories | Da |
| Naročila | create_order, list_orders, get_order, get_order_status | Da |
| Webhooki | create_webhook, list_webhooks, update_webhook, delete_webhook, test_webhook | Da |
| Dokumentacija | list_docs, get_doc, search_docs, get_openapi_spec | Ne |
MCP končna točka
https://vignetim.com/api/mcp
Avtentikacija
Orodja za API operacije zahtevajo vaše Partner API poverilnice prek HTTP glav:
| Header | Opis |
|---|---|
X-API-Key | Vaš organizacijski API ključ |
X-API-Secret | Vaša organizacijska API skrivnost |
X-Environment | Neobvezno: production (privzeto) ali sandbox |
Dokumentacijska orodja (
list_docs,get_doc,search_docs,get_openapi_spec) delujejo brez avtentikacije.
Kako deluje
- Vaš AI asistent se poveže na
https://vignetim.com/api/mcp - Odkrije razpoložljiva orodja (produkti, naročila, webhooki, dokumentacija)
- Ko vprašate "prikaži avstrijske vinjete", asistent pokliče
list_ticketszcountryIsocode: "AT" - MCP strežnik podpiše zahtevo s HMAC-SHA256 in jo posreduje Partner API-ju
- Rezultati se vrnejo neposredno vašemu asistentu
MCP strežnik obvladuje vso kompleksnost avtentikacije -- HMAC podpisovanje, časovne žige, nonce-e -- tako da vaš AI agent preprosto kliče orodja s preprostimi parametri.
Podpora platform
| Platforma | Prenos | Vodnik za nastavitev |
|---|---|---|
| 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 → |
Dodatni viri
- OpenAPI specifikacija:
https://vignetim.com/api/partner-openapi - LLMs.txt:
https://vignetim.com/llms.txt - AI vtičnik:
https://vignetim.com/.well-known/ai-plugin.json