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_ticketsaveccountryIsocode: "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