Vignetim Claude MCP
Verbind de Vignetim Partner API rechtstreeks met Claude Code of Claude Desktop. Uw assistent kan producten bekijken, bestellingen aanmaken, webhooks beheren en documentatie doorzoeken.
Snelle installatie
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"
Voor sandbox-testen:
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
Voeg toe aan uw Claude Desktop-configuratiebestand:
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"
}
}
}
}
Herstart Claude Desktop na het opslaan.
Beschikbare tools
Producten
| Tool | Beschrijving | Voorbeeld |
|---|---|---|
list_tickets | Vignet-tickets bekijken | "Toon me Oostenrijkse vignetten voor auto's" |
get_ticket | Ticketdetails ophalen | "Haal details op voor ticket abc-123" |
list_esim_packages | eSIM-pakketten bekijken | "Welke eSIM-pakketten zijn beschikbaar voor Turkije?" |
list_insurance_products | Verzekeringen bekijken | "Toon alle verzekeringsproducten" |
get_insurance_product | Verzekeringsdetails ophalen | "Vertel me over groene kaartverzekering" |
list_vehicle_categories | Voertuigtypen bekijken | "Welke voertuigcategorieën bestaan er?" |
Bestellingen
| Tool | Beschrijving | Voorbeeld |
|---|---|---|
create_order | Een bestelling aanmaken | "Maak een vignetbestelling aan voor Oostenrijk" |
list_orders | Uw bestellingen weergeven | "Toon mijn recente bestellingen" |
get_order | Besteldetails ophalen | "Wat is de status van bestelling xyz?" |
get_order_status | Bestelstatus controleren | "Is bestelling xyz afgerond?" |
Webhooks
| Tool | Beschrijving | Voorbeeld |
|---|---|---|
create_webhook | Endpoint registreren | "Stel een webhook in voor order.completed-gebeurtenissen" |
list_webhooks | Webhooks weergeven | "Toon mijn geregistreerde webhooks" |
update_webhook | Webhook bijwerken | "Schakel webhook abc uit" |
delete_webhook | Webhook verwijderen | "Verwijder webhook abc" |
test_webhook | Testgebeurtenis verzenden | "Stuur een testgebeurtenis naar webhook abc" |
Documentatie
| Tool | Beschrijving | Voorbeeld |
|---|---|---|
list_docs | Documentatie bekijken | "Welke API-documentatie is beschikbaar?" |
get_doc | Een sectie lezen | "Toon me de authenticatie-documentatie" |
search_docs | Documentatie doorzoeken | "Hoe ga ik om met fouten?" |
get_openapi_spec | OpenAPI-spec ophalen | "Waar is de OpenAPI-spec?" |
Gebruiksvoorbeelden
Producten bekijken
U: Welke vignetten zijn beschikbaar voor Hongarije?
Claude: [roept list_tickets aan met countryIsocode: "HU"]
12 vignetopties gevonden voor Hongarije:
- 10-daags snelwegvignet (Categorie D1) — €14,90
- Maandelijks snelwegvignet (Categorie D1) — €19,90
...
Webhooks beheren
U: Stel een webhook in op https://myapp.com/webhooks/vignetim
voor bestelling afgerond en mislukt gebeurtenissen.
Claude: [roept create_webhook aan met url, events]
Webhook succesvol geregistreerd!
ID: 7f3a...
Signing Secret: abc123... (sla dit op — het wordt slechts eenmaal getoond)
Bestelstatus controleren
U: Toon me alle mislukte bestellingen van deze week.
Claude: [roept list_orders aan met statusfilter en datumbereik]
2 mislukte bestellingen gevonden:
1. Bestelling #abc - Mislukt op 2026-03-18 (vignet, AT)
2. Bestelling #def - Mislukt op 2026-03-19 (eSIM, wereldwijd)
Teamconfiguratie
Voeg toe aan het .claude/settings.json-bestand van uw project voor teamtoegang:
{
"mcpServers": {
"vignetim": {
"url": "https://vignetim.com/api/mcp",
"headers": {
"X-API-Key": "YOUR_API_KEY",
"X-API-Secret": "YOUR_API_SECRET"
}
}
}
}
Probleemoplossing
"API credentials required"
Deze fout verschijnt bij het gebruik van API-tools zonder inloggegevens. Zorg ervoor dat zowel de X-API-Key- als de X-API-Secret-headers zijn geconfigureerd.
"Authentication failed"
- Controleer of uw API-sleutel en geheim correct zijn
- Controleer of uw sleutel actief is in het Vignetim Partnerdashboard
- Zorg ervoor dat uw IP op de witte lijst staat (als IP-beperkingen zijn ingeschakeld)
Sandbox vs Productie
Gebruik de X-Environment: sandbox-header om te testen tegen de sandbox-API. Sandbox-modus gebruikt gesimuleerde betalingen en testgegevens.