Vignetim Claude MCP

Povežite Vignetim Partner API neposredno s Claude Code ali Claude Desktop. Vaš asistent bo lahko pregledoval produkte, ustvarjal naročila, upravljal webhooke in iskal po dokumentaciji.

Hitra nastavitev

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"

Za testiranje v peskovniku:

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

Dodajte v vašo konfiguracijsko datoteko 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 shranjevanju ponovno zaženite Claude Desktop.

Razpoložljiva orodja

Produkti

Orodje	Opis	Primer
`list_tickets`	Pregledovanje vinjet	"Prikaži mi avstrijske vinjete za avtomobile"
`get_ticket`	Pridobi podrobnosti vinjete	"Pridobi podrobnosti za vinjeto abc-123"
`list_esim_packages`	Pregledovanje eSIM paketov	"Kateri eSIM paketi so na voljo za Turčijo?"
`list_insurance_products`	Pregledovanje zavarovanj	"Prikaži vse zavarovalne produkte"
`get_insurance_product`	Pridobi podrobnosti zavarovanja	"Povej mi o zavarovanju zelene karte"
`list_vehicle_categories`	Pregledovanje tipov vozil	"Katere kategorije vozil obstajajo?"

Naročila

Orodje	Opis	Primer
`create_order`	Ustvari naročilo	"Ustvari naročilo vinjete za Avstrijo"
`list_orders`	Prikaži vaša naročila	"Prikaži moja zadnja naročila"
`get_order`	Pridobi podrobnosti naročila	"Kakšen je status naročila xyz?"
`get_order_status`	Preveri status naročila	"Ali je naročilo xyz zaključeno?"

Webhooki

Orodje	Opis	Primer
`create_webhook`	Registriraj končno točko	"Nastavi webhook za dogodke order.completed"
`list_webhooks`	Prikaži webhooke	"Prikaži moje registrirane webhooke"
`update_webhook`	Posodobi webhook	"Onemogoči webhook abc"
`delete_webhook`	Izbriši webhook	"Odstrani webhook abc"
`test_webhook`	Pošlji testni dogodek	"Pošlji testni dogodek na webhook abc"

Dokumentacija

Orodje	Opis	Primer
`list_docs`	Pregleduj dokumentacijo	"Katera API dokumentacija je na voljo?"
`get_doc`	Preberi poglavje	"Prikaži mi dokumentacijo o avtentikaciji"
`search_docs`	Išči po dokumentaciji	"Kako obravnavam napake?"
`get_openapi_spec`	Pridobi OpenAPI specifikacijo	"Kje je OpenAPI specifikacija?"

Primeri uporabe

Pregledovanje produktov

Vi: Katere vinjete so na voljo za Madžarsko?

Claude: [pokliče list_tickets z countryIsocode: "HU"]
        Našel sem 12 vinjetnih možnosti za Madžarsko:
        - 10-dnevna avtocestna vinjeta (Kategorija D1) — 14,90 €
        - Mesečna avtocestna vinjeta (Kategorija D1) — 19,90 €
        ...

Upravljanje webhookov

Vi: Nastavi webhook na https://myapp.com/webhooks/vignetim
    za dogodke zaključenih in neuspelih naročil.

Claude: [pokliče create_webhook z url, events]
        Webhook uspešno registriran!
        ID: 7f3a...
        Podpisna skrivnost: abc123... (shranite to — prikazana je le enkrat)

Preverjanje statusa naročil

Vi: Prikaži mi vsa neuspela naročila tega tedna.

Claude: [pokliče list_orders s filtrom statusa in datumskim razponom]
        Najdeni 2 neuspeli naročili:
        1. Naročilo #abc - Neuspelo 2026-03-18 (vinjeta, AT)
        2. Naročilo #def - Neuspelo 2026-03-19 (eSIM, globalno)

Timska konfiguracija

Dodajte v datoteko .claude/settings.json vašega projekta za dostop celotne ekipe:

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

Odpravljanje težav

"API credentials required"

Ta napaka se pojavi, ko uporabljate API orodja brez poverilnic. Zagotovite, da sta oba glave X-API-Key in X-API-Secret nastavljena.

"Authentication failed"

Preverite, ali sta vaš API ključ in skrivnost pravilna
Preverite, ali je vaš ključ aktiven na Vignetim partnerski nadzorni plošči
Zagotovite, da je vaš IP na seznamu dovoljenih (če so omejitve IP-jev omogočene)

Peskovnik v primerjavi s produkcijo

Uporabite glavo X-Environment: sandbox za testiranje proti peskovniškemu API-ju. Peskovniški način uporablja simulirana plačila in testne podatke.