Model Context Protocol (MCP)

Vignetim Partner API poskytuje plnohodnotný server Model Context Protocol (MCP), který umožňuje vašemu AI asistentovi přímo komunikovat s API -- procházet produkty, vytvářet objednávky, spravovat webhooky a prohledávat dokumentaci -- to vše bez opuštění vašeho IDE.

Co je MCP?

MCP je otevřený protokol, který standardizuje způsob, jakým se AI aplikace připojují k externím nástrojům a zdrojům dat. S MCP serverem Vignetim se váš AI kódovací asistent stává klientem Vignetim API.

Možnosti

Kategorie	Nástroje	Vyžadována autentizace
Produkty	`list_tickets`, `get_ticket`, `list_esim_packages`, `list_insurance_products`, `get_insurance_product`, `list_vehicle_categories`	Ano
Objednávky	`create_order`, `list_orders`, `get_order`, `get_order_status`	Ano
Webhooky	`create_webhook`, `list_webhooks`, `update_webhook`, `delete_webhook`, `test_webhook`	Ano
Dokumentace	`list_docs`, `get_doc`, `search_docs`, `get_openapi_spec`	Ne

MCP endpoint

https://vignetim.com/api/mcp

Autentizace

Nástroje pro API operace vyžadují vaše přihlašovací údaje Partner API prostřednictvím HTTP hlaviček:

Hlavička	Popis
`X-API-Key`	Váš organizační API klíč
`X-API-Secret`	Váš organizační tajný klíč API
`X-Environment`	Volitelné: `production` (výchozí) nebo `sandbox`

Dokumentační nástroje (list_docs, get_doc, search_docs, get_openapi_spec) fungují bez autentizace.

Jak to funguje

Váš AI asistent se připojí k https://vignetim.com/api/mcp
Objeví dostupné nástroje (produkty, objednávky, webhooky, dokumentace)
Když se zeptáte „zobraz rakouské dálniční známky", asistent zavolá list_tickets s countryIsocode: "AT"
MCP server podepíše požadavek pomocí HMAC-SHA256 a přesměruje ho na Partner API
Výsledky jsou vráceny přímo vašemu asistentovi

MCP server řeší veškerou složitost autentizace -- HMAC podepisování, časová razítka, nonce -- takže váš AI agent jednoduše volá nástroje s jednoduchými parametry.

Podpora platforem

Platforma	Transport	Průvodce nastavením
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 →

Další zdroje

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