Model Context Protocol (MCP)

L'API Partenaire Vignetim fournit un serveur Model Context Protocol (MCP) complet, permettant a votre assistant IA d'interagir directement avec l'API — parcourir les produits, creer des commandes, gerer les webhooks et rechercher dans la documentation — le tout sans quitter votre IDE.

Qu'est-ce que le MCP ?

Le MCP est un protocole ouvert qui standardise la facon dont les applications d'IA se connectent aux outils et sources de donnees externes. Avec le serveur MCP de Vignetim, votre assistant de codage IA devient un client de l'API Vignetim.

Capacites

Categorie	Outils	Authentification requise
Produits	`list_tickets`, `get_ticket`, `list_esim_packages`, `list_insurance_products`, `get_insurance_product`, `list_vehicle_categories`	Oui
Commandes	`create_order`, `list_orders`, `get_order`, `get_order_status`	Oui
Webhooks	`create_webhook`, `list_webhooks`, `update_webhook`, `delete_webhook`, `test_webhook`	Oui
Documentation	`list_docs`, `get_doc`, `search_docs`, `get_openapi_spec`	Non

Endpoint MCP

https://vignetim.com/api/mcp

Authentification

Les outils d'operation API necessitent vos identifiants d'API Partenaire via des en-tetes HTTP :

En-tete	Description
`X-API-Key`	Votre cle API d'organisation
`X-API-Secret`	Votre secret API d'organisation
`X-Environment`	Optionnel : `production` (par defaut) ou `sandbox`

Les outils de documentation (list_docs, get_doc, search_docs, get_openapi_spec) fonctionnent sans authentification.

Fonctionnement

Votre assistant IA se connecte a https://vignetim.com/api/mcp
Il decouvre les outils disponibles (produits, commandes, webhooks, documentation)
Lorsque vous demandez « liste les vignettes autrichiennes », l'assistant appelle list_tickets avec countryIsocode: "AT"
Le serveur MCP signe la requete avec HMAC-SHA256 et la transmet a l'API Partenaire
Les resultats sont retournes directement a votre assistant

Le serveur MCP gere toute la complexite de l'authentification — signature HMAC, horodatages, nonces — de sorte que votre agent IA appelle simplement les outils avec des parametres simples.

Compatibilite des plateformes

Plateforme	Transport	Guide de configuration
Claude Code	Streamable HTTP	Vignetim Claude MCP →
Claude Desktop	Streamable HTTP	Vignetim Claude MCP →
Cursor	Streamable HTTP	Vignetim OpenAI MCP →
Windsurf	Streamable HTTP	Vignetim OpenAI MCP →
OpenAI Agents SDK	Streamable HTTP	Vignetim OpenAI MCP →
Continue	Streamable HTTP	Vignetim OpenAI MCP →

Ressources supplementaires

Specification OpenAPI : https://vignetim.com/api/partner-openapi
LLMs.txt : https://vignetim.com/llms.txt
Plugin IA : https://vignetim.com/.well-known/ai-plugin.json