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