Model Context Protocol (MCP)
Vignetim partnerių API teikia pilną Model Context Protocol (MCP) serverį, leidžiantį jūsų DI (dirbtinio intelekto) asistentui tiesiogiai sąveikauti su API -- naršyti produktus, kurti užsakymus, valdyti webhooks ir ieškoti dokumentacijoje -- nepaliekant savo IDE.
Kas yra MCP?
MCP yra atviras protokolas, standartizuojantis, kaip DI programos jungiasi prie išorinių įrankių ir duomenų šaltinių. Su Vignetim MCP serveriu jūsų DI programavimo asistentas tampa Vignetim API klientu.
Galimybės
| Kategorija | Įrankiai | Reikalinga autentifikacija |
|---|---|---|
| Produktai | list_tickets, get_ticket, list_esim_packages, list_insurance_products, get_insurance_product, list_vehicle_categories | Taip |
| Užsakymai | create_order, list_orders, get_order, get_order_status | Taip |
| Webhooks | create_webhook, list_webhooks, update_webhook, delete_webhook, test_webhook | Taip |
| Dokumentacija | list_docs, get_doc, search_docs, get_openapi_spec | Ne |
MCP galinis taškas
https://vignetim.com/api/mcp
Autentifikacija
API operacijų įrankiams reikia jūsų partnerių API kredencialų per HTTP antraštes:
| Antraštė | Aprašymas |
|---|---|
X-API-Key | Jūsų organizacijos API raktas |
X-API-Secret | Jūsų organizacijos API slaptasis raktas |
X-Environment | Neprivalomas: production (numatytasis) arba sandbox |
Dokumentacijos įrankiai (
list_docs,get_doc,search_docs,get_openapi_spec) veikia be autentifikacijos.
Kaip tai veikia
- Jūsų DI asistentas jungiasi prie
https://vignetim.com/api/mcp - Jis atranda galimus įrankius (produktai, užsakymai, webhooks, dokumentacija)
- Kai paklausiate „parodyk Austrijos vinjetes", asistentas iškviečia
list_ticketssucountryIsocode: "AT" - MCP serveris pasirašo užklausą HMAC-SHA256 ir perduoda ją partnerių API
- Rezultatai grąžinami tiesiogiai jūsų asistentui
MCP serveris tvarko visą autentifikacijos sudėtingumą -- HMAC pasirašymą, laiko žymas, nonce -- todėl jūsų DI agentas tiesiog kviečia įrankius su paprastais parametrais.
Platformų palaikymas
| Platforma | Transportas | Nustatymo vadovas |
|---|---|---|
| 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 → |
Papildomi ištekliai
- OpenAPI specifikacija:
https://vignetim.com/api/partner-openapi - LLMs.txt:
https://vignetim.com/llms.txt - AI Plugin:
https://vignetim.com/.well-known/ai-plugin.json