Protocolo de Contexto de Modelo (MCP)
La API de Socios de Vignetim proporciona un servidor completo de Protocolo de Contexto de Modelo (Model Context Protocol, MCP), que permite a su asistente de IA interactuar directamente con la API -- explorar productos, crear pedidos, gestionar webhooks y buscar documentación -- todo sin salir de su IDE.
¿Qué es MCP?
MCP es un protocolo abierto que estandariza cómo las aplicaciones de IA se conectan a herramientas externas y fuentes de datos. Con el servidor MCP de Vignetim, su asistente de IA se convierte en un cliente de la API de Vignetim.
Capacidades
| Categoría | Herramientas | Autenticación requerida |
|---|---|---|
| Productos | list_tickets, get_ticket, list_esim_packages, list_insurance_products, get_insurance_product, list_vehicle_categories | Sí |
| Pedidos | create_order, list_orders, get_order, get_order_status | Sí |
| Webhooks | create_webhook, list_webhooks, update_webhook, delete_webhook, test_webhook | Sí |
| Documentación | list_docs, get_doc, search_docs, get_openapi_spec | No |
Endpoint MCP
https://vignetim.com/api/mcp
Autenticación
Las herramientas de operaciones de la API requieren sus credenciales de la API de Socios mediante encabezados HTTP:
| Encabezado | Descripción |
|---|---|
X-API-Key | Su clave API de organización |
X-API-Secret | El secreto de su API de organización |
X-Environment | Opcional: production (predeterminado) o sandbox |
Las herramientas de documentación (
list_docs,get_doc,search_docs,get_openapi_spec) funcionan sin autenticación.
Cómo funciona
- Su asistente de IA se conecta a
https://vignetim.com/api/mcp - Descubre las herramientas disponibles (productos, pedidos, webhooks, documentación)
- Cuando usted pregunta "listar viñetas austriacas", el asistente llama a
list_ticketsconcountryIsocode: "AT" - El servidor MCP firma la solicitud con HMAC-SHA256 y la envía como proxy a la API de Socios
- Los resultados se devuelven directamente a su asistente
El servidor MCP maneja toda la complejidad de autenticación -- firma HMAC, marcas de tiempo, nonces -- para que su agente de IA simplemente llame a las herramientas con parámetros sencillos.
Soporte de plataformas
| Plataforma | Transporte | Guía de configuración |
|---|---|---|
| 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 → |
Recursos adicionales
- Especificación OpenAPI:
https://vignetim.com/api/partner-openapi - LLMs.txt:
https://vignetim.com/llms.txt - AI Plugin:
https://vignetim.com/.well-known/ai-plugin.json