Vignetim Claude MCP

Csatlakoztassa a Vignetim Partner API-t közvetlenül a Claude Code vagy Claude Desktop alkalmazáshoz. Az asszisztense képes lesz termékeket böngészni, megrendeléseket létrehozni, webhookokat kezelni és dokumentációt keresni.

Gyors beállítás

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"

Sandbox teszteléshez:

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

Adja hozzá a Claude Desktop konfigurációs fájlhoz:

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"
			}
		}
	}
}

Mentés után indítsa újra a Claude Desktop alkalmazást.

Elérhető eszközök

Termékek

Eszköz	Leírás	Példa
`list_tickets`	Matricajegyek böngészése	"Mutasd az osztrák matricákat személygépkocsikhoz"
`get_ticket`	Jegy részleteinek lekérése	"Kérd le az abc-123 jegy részleteit"
`list_esim_packages`	eSIM csomagok böngészése	"Milyen eSIM csomagok érhetők el Törökországba?"
`list_insurance_products`	Biztosítások böngészése	"Listázd az összes biztosítási terméket"
`get_insurance_product`	Biztosítás részleteinek lekérése	"Mesélj a zöldkártya biztosításról"
`list_vehicle_categories`	Járműtípusok böngészése	"Milyen járműkategóriák léteznek?"

Megrendelések

Eszköz	Leírás	Példa
`create_order`	Megrendelés létrehozása	"Hozz létre egy matrica megrendelést Ausztriába"
`list_orders`	Megrendelések listázása	"Mutasd a legutóbbi megrendeléseimet"
`get_order`	Megrendelés részleteinek lekérése	"Mi az xyz megrendelés állapota?"
`get_order_status`	Megrendelés állapotának ellenőrzése	"Befejeződött az xyz megrendelés?"

Webhookok

Eszköz	Leírás	Példa
`create_webhook`	Végpont regisztrálása	"Állíts be egy webhookot order.completed eseményekhez"
`list_webhooks`	Webhookok listázása	"Mutasd a regisztrált webhookjaimat"
`update_webhook`	Webhook frissítése	"Tiltsd le az abc webhookot"
`delete_webhook`	Webhook törlése	"Távolítsd el az abc webhookot"
`test_webhook`	Teszt esemény küldése	"Küldj egy teszt eseményt az abc webhookra"

Dokumentáció

Eszköz	Leírás	Példa
`list_docs`	Dokumentáció böngészése	"Milyen API dokumentációk érhetők el?"
`get_doc`	Szekció olvasása	"Mutasd a hitelesítési dokumentációt"
`search_docs`	Dokumentáció keresése	"Hogyan kezeljem a hibákat?"
`get_openapi_spec`	OpenAPI specifikáció lekérése	"Hol van az OpenAPI specifikáció?"

Használati példák

Termékek böngészése

Ön: Milyen matricák érhetők el Magyarországra?

Claude: [meghívja a list_tickets eszközt countryIsocode: "HU" paraméterrel]
        12 matrica opciót talált Magyarországra:
        - 10 napos autópálya-matrica (D1 kategória) — 14,90 €
        - Havi autópálya-matrica (D1 kategória) — 19,90 €
        ...

Webhookok kezelése

Ön: Állíts be egy webhookot a https://myapp.com/webhooks/vignetim címen
     megrendelés teljesítve és sikertelen eseményekre.

Claude: [meghívja a create_webhook eszközt az url és events paraméterekkel]
        Webhook sikeresen regisztrálva!
        Azonosító: 7f3a...
        Aláírási kulcs: abc123...  (mentse el — csak egyszer jelenik meg)

Megrendelés állapotának ellenőrzése

Ön: Mutasd az ezen a héten sikertelen megrendeléseket.

Claude: [meghívja a list_orders eszközt állapotszűrővel és dátumtartománnyal]
        2 sikertelen megrendelés található:
        1. Megrendelés #abc - Sikertelen 2026-03-18 (matrica, AT)
        2. Megrendelés #def - Sikertelen 2026-03-19 (eSIM, globális)

Csapat konfiguráció

Adja hozzá a projekt .claude/settings.json fájljához a csapat szintű hozzáféréshez:

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

Hibaelhárítás

"API credentials required"

Ez a hiba akkor jelenik meg, amikor API-eszközöket hitelesítő adatok nélkül használ. Győződjön meg arról, hogy mind az X-API-Key, mind az X-API-Secret fejlécek konfigurálva vannak.

"Authentication failed"

Ellenőrizze, hogy az API-kulcs és a titkos kulcs helyes-e
Győződjön meg arról, hogy a kulcs aktív a Vignetim Partner Vezérlőpulton
Ellenőrizze, hogy az IP-cím engedélyezett listán van-e (ha IP-korlátozások engedélyezve vannak)

Sandbox és éles környezet

Használja az X-Environment: sandbox fejlécet a sandbox API teszteléséhez. A sandbox mód szimulált fizetéseket és tesztadatokat használ.