Vignetim Claude MCP

Prijunkite Vignetim partnerių API tiesiogiai prie Claude Code arba Claude Desktop. Jūsų asistentas galės naršyti produktus, kurti užsakymus, valdyti webhooks ir ieškoti dokumentacijoje.

Greitas nustatymas

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 testavimui:

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

Pridėkite prie savo Claude Desktop konfigūracijos failo:

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

Paleiskite Claude Desktop iš naujo po išsaugojimo.

Galimi įrankiai

Produktai

Įrankis	Aprašymas	Pavyzdys
`list_tickets`	Naršyti vinječių bilietus	„Parodyk Austrijos vinjetes automobiliams"
`get_ticket`	Gauti bilieto detales	„Gauk detales bilietui abc-123"
`list_esim_packages`	Naršyti eSIM paketus	„Kokie eSIM paketai galimi Turkijai?"
`list_insurance_products`	Naršyti draudimą	„Parodyk visus draudimo produktus"
`get_insurance_product`	Gauti draudimo detales	„Papasakok apie žaliosios kortelės draudimą"
`list_vehicle_categories`	Naršyti transporto priemonių tipus	„Kokios transporto priemonių kategorijos egzistuoja?"

Užsakymai

Įrankis	Aprašymas	Pavyzdys
`create_order`	Sukurti užsakymą	„Sukurk vinjetės užsakymą Austrijai"
`list_orders`	Peržiūrėti užsakymus	„Parodyk mano naujausius užsakymus"
`get_order`	Gauti užsakymo detales	„Kokia užsakymo xyz būsena?"
`get_order_status`	Patikrinti užsakymo būseną	„Ar užsakymas xyz užbaigtas?"

Webhooks

Įrankis	Aprašymas	Pavyzdys
`create_webhook`	Registruoti galinį tašką	„Nustatyk webhook order.completed įvykiams"
`list_webhooks`	Peržiūrėti webhooks	„Parodyk mano registruotus webhooks"
`update_webhook`	Atnaujinti webhook	„Išjunk webhook abc"
`delete_webhook`	Ištrinti webhook	„Pašalink webhook abc"
`test_webhook`	Siųsti testinį įvykį	„Siųsk testinį įvykį webhook abc"

Dokumentacija

Įrankis	Aprašymas	Pavyzdys
`list_docs`	Naršyti dokumentaciją	„Kokia API dokumentacija prieinama?"
`get_doc`	Skaityti skyrių	„Parodyk autentifikacijos dokumentaciją"
`search_docs`	Ieškoti dokumentacijoje	„Kaip apdoroti klaidas?"
`get_openapi_spec`	Gauti OpenAPI specifikaciją	„Kur yra OpenAPI specifikacija?"

Naudojimo pavyzdžiai

Produktų naršymas

Jūs: Kokios vinjetės galimos Vengrijai?

Claude: [kviečia list_tickets su countryIsocode: "HU"]
        Rasta 12 vinječių variantų Vengrijai:
        - 10 dienų automagistralės vinjetė (Kategorija D1) — 14,90 €
        - Mėnesinė automagistralės vinjetė (Kategorija D1) — 19,90 €
        ...

Webhooks valdymas

Jūs: Nustatyk webhook adresu https://myapp.com/webhooks/vignetim
     order completed ir failed įvykiams.

Claude: [kviečia create_webhook su url, events]
        Webhook sėkmingai užregistruotas!
        ID: 7f3a...
        Pasirašymo slaptasis raktas: abc123...  (išsaugokite — rodomas tik vieną kartą)

Užsakymo būsenos tikrinimas

Jūs: Parodyk visus nepavykusius užsakymus šią savaitę.

Claude: [kviečia list_orders su būsenos filtru ir datų intervalu]
        Rasti 2 nepavykę užsakymai:
        1. Užsakymas #abc — Nepavyko 2026-03-18 (vinjetė, AT)
        2. Užsakymas #def — Nepavyko 2026-03-19 (eSIM, pasaulinis)

Komandos konfigūracija

Pridėkite prie savo projekto .claude/settings.json visai komandai:

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

Trikčių šalinimas

„API credentials required"

Ši klaida pasirodo naudojant API įrankius be kredencialų. Įsitikinkite, kad abu X-API-Key ir X-API-Secret antraštės yra sukonfigūruotos.

„Authentication failed"

Patikrinkite, ar jūsų API raktas ir slaptasis raktas yra teisingi
Patikrinkite, ar jūsų raktas aktyvus Vignetim partnerių valdymo skydelyje
Įsitikinkite, kad jūsų IP yra leidžiamųjų sąraše (jei IP apribojimai įjungti)

Sandbox ir produkcija

Naudokite X-Environment: sandbox antraštę testavimui su sandbox API. Sandbox režimas naudoja imituojamus mokėjimus ir testinius duomenis.