Vignetim Claude MCP

Conectați API-ul Vignetim pentru Parteneri direct la Claude Code sau Claude Desktop. Asistentul dumneavoastră va putea răsfoi produse, crea comenzi, gestiona webhook-uri și căuta în documentație.

Configurare rapidă

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"

Pentru testare în sandbox:

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

Adăugați în fișierul de configurare 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"
			}
		}
	}
}

Reporniți Claude Desktop după salvare.

Instrumente disponibile

Produse

Instrument	Descriere	Exemplu
`list_tickets`	Răsfoiți vignete	„Arată-mi vignetele austriece pentru mașini"
`get_ticket`	Obțineți detalii vignetă	„Obține detalii pentru vigneta abc-123"
`list_esim_packages`	Răsfoiți pachete eSIM	„Ce pachete eSIM sunt disponibile pentru Turcia?"
`list_insurance_products`	Răsfoiți asigurări	„Listează toate produsele de asigurare"
`get_insurance_product`	Obțineți detalii asigurare	„Spune-mi despre asigurarea carte verde"
`list_vehicle_categories`	Răsfoiți tipuri de vehicule	„Ce categorii de vehicule există?"

Comenzi

Instrument	Descriere	Exemplu
`create_order`	Creați o comandă	„Creează o comandă de vignetă pentru Austria"
`list_orders`	Listați comenzile	„Arată comenzile mele recente"
`get_order`	Obțineți detalii comandă	„Care este starea comenzii xyz?"
`get_order_status`	Verificați starea comenzii	„Este comanda xyz finalizată?"

Webhooks

Instrument	Descriere	Exemplu
`create_webhook`	Înregistrați endpoint	„Configurează un webhook pentru evenimentele order.completed"
`list_webhooks`	Listați webhook-uri	„Arată webhook-urile mele înregistrate"
`update_webhook`	Actualizați webhook	„Dezactivează webhook-ul abc"
`delete_webhook`	Ștergeți webhook	„Elimină webhook-ul abc"
`test_webhook`	Trimiteți eveniment de test	„Trimite un eveniment de test către webhook-ul abc"

Documentație

Instrument	Descriere	Exemplu
`list_docs`	Răsfoiți documentația	„Ce documentație API este disponibilă?"
`get_doc`	Citiți o secțiune	„Arată-mi documentația de autentificare"
`search_docs`	Căutați în documentație	„Cum gestionez erorile?"
`get_openapi_spec`	Obțineți specificația OpenAPI	„Unde este specificația OpenAPI?"

Exemple de utilizare

Răsfoirea produselor

Tu: Ce vignete sunt disponibile pentru Ungaria?

Claude: [apelează list_tickets cu countryIsocode: "HU"]
        Am găsit 12 opțiuni de vignete pentru Ungaria:
        - Vignetă de autostradă 10 zile (Categoria D1) — 14,90 €
        - Vignetă lunară de autostradă (Categoria D1) — 19,90 €
        ...

Gestionarea webhook-urilor

Tu: Configurează un webhook la https://myapp.com/webhooks/vignetim
     pentru evenimentele de comandă finalizată și eșuată.

Claude: [apelează create_webhook cu url, events]
        Webhook-ul a fost înregistrat cu succes!
        ID: 7f3a...
        Secret de semnare: abc123...  (salvați-l — este afișat o singură dată)

Verificarea stării comenzii

Tu: Arată-mi toate comenzile eșuate din această săptămână.

Claude: [apelează list_orders cu filtru de stare și interval de date]
        Am găsit 2 comenzi eșuate:
        1. Comanda #abc - Eșuată la 2026-03-18 (vignetă, AT)
        2. Comanda #def - Eșuată la 2026-03-19 (eSIM, global)

Configurare pentru echipă

Adăugați în fișierul .claude/settings.json al proiectului pentru acces la nivel de echipă:

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

Depanare

„API credentials required"

Această eroare apare când utilizați instrumente API fără credențiale. Asigurați-vă că ambele anteturi X-API-Key și X-API-Secret sunt configurate.

„Authentication failed"

Verificați că cheia API și secretul sunt corecte
Verificați că cheia este activă în Panoul de control Vignetim pentru Parteneri
Asigurați-vă că IP-ul dumneavoastră este pe lista albă (dacă sunt activate restricțiile IP)

Sandbox vs Producție

Utilizați antetul X-Environment: sandbox pentru a testa pe API-ul sandbox. Modul sandbox utilizează plăți simulate și date de test.