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_tickets z countryIsocode: "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