Vignetim Claude MCP

Propojte Vignetim Partner API přímo s Claude Code nebo Claude Desktop. Váš asistent bude moci procházet produkty, vytvářet objednávky, spravovat webhooky a prohledávat dokumentaci.

Rychlé nastavení

Claude Code (CLI)

claude mcp add vignetim --transport http https://vignetim.com/api/mcp \
  --header "X-API-Key: YOUR_API_KEY" \
  --header "X-API-Secret: YOUR_API_SECRET"

Pro testování v sandboxu:

claude mcp add vignetim-sandbox --transport http https://vignetim.com/api/mcp \
  --header "X-API-Key: YOUR_SANDBOX_KEY" \
  --header "X-API-Secret: YOUR_SANDBOX_SECRET" \
  --header "X-Environment: sandbox"

Claude Desktop

Přidejte do konfiguračního souboru Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
	"mcpServers": {
		"vignetim": {
			"url": "https://vignetim.com/api/mcp",
			"headers": {
				"X-API-Key": "YOUR_API_KEY",
				"X-API-Secret": "YOUR_API_SECRET"
			}
		}
	}
}

Po uložení restartujte Claude Desktop.

Dostupné nástroje

Produkty

Nástroj	Popis	Příklad
`list_tickets`	Procházet dálniční známky	„Ukaž mi rakouské dálniční známky pro osobní auta"
`get_ticket`	Získat detail známky	„Získej podrobnosti o známce abc-123"
`list_esim_packages`	Procházet eSIM balíčky	„Jaké eSIM balíčky jsou dostupné pro Turecko?"
`list_insurance_products`	Procházet pojištění	„Vypiš všechny pojistné produkty"
`get_insurance_product`	Získat detail pojištění	„Řekni mi o pojištění zelená karta"
`list_vehicle_categories`	Procházet typy vozidel	„Jaké kategorie vozidel existují?"

Objednávky

Nástroj	Popis	Příklad
`create_order`	Vytvořit objednávku	„Vytvoř objednávku dálniční známky pro Rakousko"
`list_orders`	Vypsat objednávky	„Ukaž mé poslední objednávky"
`get_order`	Získat detail objednávky	„Jaký je stav objednávky xyz?"
`get_order_status`	Zkontrolovat stav objednávky	„Je objednávka xyz dokončena?"

Webhooky

Nástroj	Popis	Příklad
`create_webhook`	Zaregistrovat endpoint	„Nastav webhook pro události order.completed"
`list_webhooks`	Vypsat webhooky	„Ukaž mé zaregistrované webhooky"
`update_webhook`	Aktualizovat webhook	„Deaktivuj webhook abc"
`delete_webhook`	Smazat webhook	„Odstraň webhook abc"
`test_webhook`	Odeslat testovací událost	„Pošli testovací událost na webhook abc"

Dokumentace

Nástroj	Popis	Příklad
`list_docs`	Procházet dokumentaci	„Jaká API dokumentace je dostupná?"
`get_doc`	Přečíst sekci	„Ukaž mi dokumentaci k autentizaci"
`search_docs`	Prohledat dokumentaci	„Jak mám zpracovávat chyby?"
`get_openapi_spec`	Získat OpenAPI specifikaci	„Kde je OpenAPI specifikace?"

Příklady použití

Procházení produktů

Vy: Jaké dálniční známky jsou dostupné pro Maďarsko?

Claude: [volá list_tickets s countryIsocode: "HU"]
        Nalezeno 12 možností dálničních známek pro Maďarsko:
        - 10denní dálniční známka (kategorie D1) — 14,90 €
        - Měsíční dálniční známka (kategorie D1) — 19,90 €
        ...

Správa webhooků

Vy: Nastav webhook na https://myapp.com/webhooks/vignetim
     pro události dokončení a selhání objednávky.

Claude: [volá create_webhook s url, events]
        Webhook úspěšně zaregistrován!
        ID: 7f3a...
        Signing Secret: abc123...  (uložte si ho — zobrazí se pouze jednou)

Kontrola stavu objednávky

Vy: Ukaž mi všechny neúspěšné objednávky z tohoto týdne.

Claude: [volá list_orders s filtrem stavu a rozsahem dat]
        Nalezeny 2 neúspěšné objednávky:
        1. Objednávka #abc - Selhala 2026-03-18 (dálniční známka, AT)
        2. Objednávka #def - Selhala 2026-03-19 (eSIM, globální)

Konfigurace pro tým

Přidejte do souboru .claude/settings.json vašeho projektu pro přístup celého týmu:

{
	"mcpServers": {
		"vignetim": {
			"url": "https://vignetim.com/api/mcp",
			"headers": {
				"X-API-Key": "YOUR_API_KEY",
				"X-API-Secret": "YOUR_API_SECRET"
			}
		}
	}
}

Řešení problémů

„API credentials required"

Tato chyba se zobrazí při použití API nástrojů bez přihlašovacích údajů. Ujistěte se, že jsou nakonfigurovány obě hlavičky X-API-Key a X-API-Secret.

„Authentication failed"

Ověřte, že váš API klíč a tajný klíč jsou správné
Zkontrolujte, že váš klíč je aktivní v partnerském řídicím panelu Vignetim
Ujistěte se, že vaše IP adresa je na seznamu povolených (pokud jsou povolena IP omezení)

Sandbox vs. produkce

Použijte hlavičku X-Environment: sandbox pro testování proti sandboxovému API. Režim sandbox používá simulované platby a testovací data.