Model Context Protocol (MCP)

A Vignetim Partner API teljes Model Context Protocol (MCP) szervert biztosít, lehetővé téve az AI asszisztensének, hogy közvetlenül kommunikáljon az API-val -- termékek böngészése, megrendelések létrehozása, webhookok kezelése és dokumentáció keresése -- mindezt anélkül, hogy elhagyná a fejlesztői környezetét.

Mi az MCP?

Az MCP egy nyílt protokoll, amely szabványosítja, hogyan csatlakoznak az AI alkalmazások külső eszközökhöz és adatforrásokhoz. A Vignetim MCP szerverével az AI kódolási asszisztense Vignetim API-kliensé válik.

Képességek

Kategória	Eszközök	Hitelesítés szükséges
Termékek	`list_tickets`, `get_ticket`, `list_esim_packages`, `list_insurance_products`, `get_insurance_product`, `list_vehicle_categories`	Igen
Megrendelések	`create_order`, `list_orders`, `get_order`, `get_order_status`	Igen
Webhookok	`create_webhook`, `list_webhooks`, `update_webhook`, `delete_webhook`, `test_webhook`	Igen
Dokumentáció	`list_docs`, `get_doc`, `search_docs`, `get_openapi_spec`	Nem

MCP végpont

https://vignetim.com/api/mcp

Hitelesítés (Authentication)

Az API-műveleti eszközökhöz szükségesek a Partner API hitelesítő adatai HTTP fejléceken keresztül:

Fejléc	Leírás
`X-API-Key`	Az Ön szervezeti API-kulcsa
`X-API-Secret`	Az Ön szervezeti API titkos kulcsa
`X-Environment`	Opcionális: `production` (alapértelmezett) vagy `sandbox`

A dokumentációs eszközök (list_docs, get_doc, search_docs, get_openapi_spec) hitelesítés nélkül működnek.

Hogyan működik

Az AI asszisztense csatlakozik a https://vignetim.com/api/mcp címhez
Felfedezi az elérhető eszközöket (termékek, megrendelések, webhookok, dokumentáció)
Amikor azt kérdezi: "listázd az osztrák matricákat", az asszisztens meghívja a list_tickets eszközt countryIsocode: "AT" paraméterrel
Az MCP szerver HMAC-SHA256-tal aláírja a kérést és továbbítja a Partner API-hoz
Az eredmények közvetlenül az asszisztensének kerülnek visszaadásra

Az MCP szerver kezeli az összes hitelesítési összetettséget -- HMAC aláírás, időbélyegek, nonce-ok -- így az AI ügynöke egyszerű paraméterekkel hívja az eszközöket.

Platform támogatás

Platform	Átvitel	Beállítási útmutató
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 →

További erőforrások

OpenAPI specifikáció: https://vignetim.com/api/partner-openapi
LLMs.txt: https://vignetim.com/llms.txt
AI Plugin: https://vignetim.com/.well-known/ai-plugin.json