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_ticketsscountryIsocode: "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