Vignetim Claude MCP

Polacz API Partnerskie Vignetim bezposrednio z Claude Code lub Claude Desktop. Twoj asystent bedzie mogl przegladac produkty, tworzyc zamowienia, zarzadzac webhookami i przeszukiwac dokumentacje.

Szybka konfiguracja

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"

Do testowania w 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

Dodaj do pliku konfiguracyjnego 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"
			}
		}
	}
}

Uruchom ponownie Claude Desktop po zapisaniu.

Dostepne narzedzia

Produkty

Narzedzie	Opis	Przyklad
`list_tickets`	Przegladaj winiety	"Pokaz mi austriackie winiety dla samochodow"
`get_ticket`	Pobierz szczegoly winiety	"Pobierz szczegoly winiety abc-123"
`list_esim_packages`	Przegladaj pakiety eSIM	"Jakie pakiety eSIM sa dostepne dla Turcji?"
`list_insurance_products`	Przegladaj ubezpieczenia	"Wylistuj wszystkie produkty ubezpieczeniowe"
`get_insurance_product`	Pobierz szczegoly ubezpieczenia	"Opowiedz mi o ubezpieczeniu zielonej karty"
`list_vehicle_categories`	Przegladaj typy pojazdow	"Jakie kategorie pojazdow istnieja?"

Zamowienia

Narzedzie	Opis	Przyklad
`create_order`	Utworz zamowienie	"Utworz zamowienie na winiete dla Austrii"
`list_orders`	Wylistuj zamowienia	"Pokaz moje ostatnie zamowienia"
`get_order`	Pobierz szczegoly zamowienia	"Jaki jest status zamowienia xyz?"
`get_order_status`	Sprawdz status zamowienia	"Czy zamowienie xyz jest ukonczone?"

Webhooki

Narzedzie	Opis	Przyklad
`create_webhook`	Zarejestruj endpoint	"Skonfiguruj webhook dla zdarzen order.completed"
`list_webhooks`	Wylistuj webhooki	"Pokaz moje zarejestrowane webhooki"
`update_webhook`	Zaktualizuj webhook	"Dezaktywuj webhook abc"
`delete_webhook`	Usun webhook	"Usun webhook abc"
`test_webhook`	Wyslij zdarzenie testowe	"Wyslij zdarzenie testowe do webhooka abc"

Dokumentacja

Narzedzie	Opis	Przyklad
`list_docs`	Przegladaj dokumentacje	"Jaka dokumentacja API jest dostepna?"
`get_doc`	Przeczytaj sekcje	"Pokaz mi dokumentacje uwierzytelniania"
`search_docs`	Szukaj w dokumentacji	"Jak obsluzyc bledy?"
`get_openapi_spec`	Pobierz specyfikacje OpenAPI	"Gdzie jest specyfikacja OpenAPI?"

Przyklady uzycia

Przegladanie produktow

Ty: Jakie winiety sa dostepne dla Wegier?

Claude: [wywoluje list_tickets z countryIsocode: "HU"]
        Znaleziono 12 opcji winiet dla Wegier:
        - Winieta 10-dniowa (Kategoria D1) -- 14,90 EUR
        - Winieta miesieczna (Kategoria D1) -- 19,90 EUR
        ...

Zarzadzanie webhookami

Ty: Skonfiguruj webhook pod adresem https://myapp.com/webhooks/vignetim
     dla zdarzen zamowienia ukonczonego i nieudanego.

Claude: [wywoluje create_webhook z url, events]
        Webhook zarejestrowany pomyslnie!
        ID: 7f3a...
        Signing Secret: abc123...  (zapisz to -- wyswietlane jest tylko raz)

Sprawdzanie statusu zamowienia

Ty: Pokaz mi wszystkie nieudane zamowienia z tego tygodnia.

Claude: [wywoluje list_orders z filtrem statusu i zakresem dat]
        Znaleziono 2 nieudane zamowienia:
        1. Zamowienie #abc - Nieudane 2026-03-18 (winieta, AT)
        2. Zamowienie #def - Nieudane 2026-03-19 (eSIM, globalny)

Konfiguracja zespolowa

Dodaj do pliku .claude/settings.json projektu, aby zapewnic dostep calemu zespolowi:

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

Rozwiazywanie problemow

"API credentials required"

Ten blad pojawia sie przy uzywaniu narzedzi API bez danych uwierzytelniajacych. Upewnij sie, ze oba naglowki X-API-Key i X-API-Secret sa skonfigurowane.

"Authentication failed"

Sprawdz, czy Twoj klucz API i sekret sa poprawne
Zweryfikuj, czy Twoj klucz jest aktywny w Panelu Partnerskim Vignetim
Upewnij sie, ze Twoj adres IP jest na bialej liscie (jesli ograniczenia IP sa wlaczone)

Sandbox a Produkcja

Uzyj naglowka X-Environment: sandbox, aby testowac z API sandbox. Tryb sandbox uzywa symulowanych platnosci i danych testowych.