Vignetim Claude MCP

Connectez l'API Partenaire Vignetim directement a Claude Code ou Claude Desktop. Votre assistant pourra parcourir les produits, creer des commandes, gerer les webhooks et rechercher dans la documentation.

Configuration rapide

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"

Pour les tests en bac a sable :

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

Ajoutez a votre fichier de configuration 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"
			}
		}
	}
}

Redemarrez Claude Desktop apres l'enregistrement.

Outils disponibles

Produits

Outil	Description	Exemple
`list_tickets`	Parcourir les vignettes	« Montre-moi les vignettes autrichiennes pour les voitures »
`get_ticket`	Obtenir les details d'une vignette	« Donne-moi les details de la vignette abc-123 »
`list_esim_packages`	Parcourir les forfaits eSIM	« Quels forfaits eSIM sont disponibles pour la Turquie ? »
`list_insurance_products`	Parcourir les assurances	« Liste tous les produits d'assurance »
`get_insurance_product`	Obtenir les details d'une assurance	« Parle-moi de l'assurance carte verte »
`list_vehicle_categories`	Parcourir les types de vehicules	« Quelles categories de vehicules existent ? »

Commandes

Outil	Description	Exemple
`create_order`	Creer une commande	« Cree une commande de vignette pour l'Autriche »
`list_orders`	Lister vos commandes	« Montre mes commandes recentes »
`get_order`	Obtenir les details d'une commande	« Quel est le statut de la commande xyz ? »
`get_order_status`	Verifier le statut d'une commande	« La commande xyz est-elle terminee ? »

Webhooks

Outil	Description	Exemple
`create_webhook`	Enregistrer un endpoint	« Configure un webhook pour les evenements order.completed »
`list_webhooks`	Lister les webhooks	« Montre mes webhooks enregistres »
`update_webhook`	Mettre a jour un webhook	« Desactive le webhook abc »
`delete_webhook`	Supprimer un webhook	« Supprime le webhook abc »
`test_webhook`	Envoyer un evenement de test	« Envoie un evenement de test au webhook abc »

Documentation

Outil	Description	Exemple
`list_docs`	Parcourir la documentation	« Quelle documentation API est disponible ? »
`get_doc`	Lire une section	« Montre-moi la documentation d'authentification »
`search_docs`	Rechercher dans la documentation	« Comment gerer les erreurs ? »
`get_openapi_spec`	Obtenir la specification OpenAPI	« Ou est la specification OpenAPI ? »

Exemples d'utilisation

Parcourir les produits

Vous : Quelles vignettes sont disponibles pour la Hongrie ?

Claude : [appelle list_tickets avec countryIsocode: "HU"]
        12 options de vignette trouvees pour la Hongrie :
        - Vignette autoroute 10 jours (Categorie D1) — 14,90 EUR
        - Vignette autoroute mensuelle (Categorie D1) — 19,90 EUR
        ...

Gestion des webhooks

Vous : Configure un webhook sur https://myapp.com/webhooks/vignetim
     pour les evenements commande terminee et echouee.

Claude : [appelle create_webhook avec url, events]
        Webhook enregistre avec succes !
        ID : 7f3a...
        Secret de signature : abc123...  (enregistrez-le — il n'est affiche qu'une seule fois)

Verification du statut des commandes

Vous : Montre-moi toutes les commandes echouees de cette semaine.

Claude : [appelle list_orders avec filtre de statut et plage de dates]
        2 commandes echouees trouvees :
        1. Commande #abc - Echouee le 2026-03-18 (vignette, AT)
        2. Commande #def - Echouee le 2026-03-19 (eSIM, global)

Configuration pour l'equipe

Ajoutez au fichier .claude/settings.json de votre projet pour un acces a toute l'equipe :

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

Depannage

« API credentials required »

Cette erreur apparait lorsque vous utilisez les outils API sans identifiants. Assurez-vous que les en-tetes X-API-Key et X-API-Secret sont configures.

« Authentication failed »

Verifiez que votre cle API et votre secret sont corrects
Verifiez que votre cle est active dans le tableau de bord Partenaire Vignetim
Assurez-vous que votre IP est autorisee (si les restrictions IP sont activees)

Bac a sable vs Production

Utilisez l'en-tete X-Environment: sandbox pour tester avec l'API bac a sable. Le mode bac a sable utilise des paiements simules et des donnees de test.