Vignetim Claude MCP

Conecte la API de Socios (Partner API) de Vignetim directamente a Claude Code o Claude Desktop. Su asistente podrá explorar productos, crear pedidos, gestionar webhooks y buscar documentación.

Configuración rápida

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"

Para pruebas en sandbox:

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

Agregue a su archivo de configuración de 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"
			}
		}
	}
}

Reinicie Claude Desktop después de guardar.

Herramientas disponibles

Productos

Herramienta	Descripción	Ejemplo
`list_tickets`	Explorar viñetas de peaje	"Muéstrame las viñetas austriacas para coches"
`get_ticket`	Obtener detalles de una viñeta	"Obtener detalles del ticket abc-123"
`list_esim_packages`	Explorar paquetes eSIM	"¿Qué paquetes eSIM hay disponibles para Turquía?"
`list_insurance_products`	Explorar seguros	"Listar todos los productos de seguro"
`get_insurance_product`	Obtener detalles de seguro	"Cuéntame sobre el seguro de carta verde"
`list_vehicle_categories`	Explorar tipos de vehículos	"¿Qué categorías de vehículos existen?"

Pedidos

Herramienta	Descripción	Ejemplo
`create_order`	Crear un pedido	"Crear un pedido de viñeta para Austria"
`list_orders`	Listar sus pedidos	"Mostrar mis pedidos recientes"
`get_order`	Obtener detalles del pedido	"¿Cuál es el estado del pedido xyz?"
`get_order_status`	Consultar estado del pedido	"¿Está completado el pedido xyz?"

Webhooks

Herramienta	Descripción	Ejemplo
`create_webhook`	Registrar endpoint	"Configurar un webhook para eventos order.completed"
`list_webhooks`	Listar webhooks	"Mostrar mis webhooks registrados"
`update_webhook`	Actualizar webhook	"Desactivar el webhook abc"
`delete_webhook`	Eliminar webhook	"Eliminar el webhook abc"
`test_webhook`	Enviar evento de prueba	"Enviar un evento de prueba al webhook abc"

Documentación

Herramienta	Descripción	Ejemplo
`list_docs`	Explorar documentación	"¿Qué documentación de la API hay disponible?"
`get_doc`	Leer una sección	"Muéstrame la documentación de autenticación"
`search_docs`	Buscar en la documentación	"¿Cómo manejo los errores?"
`get_openapi_spec`	Obtener especificación OpenAPI	"¿Dónde está la especificación OpenAPI?"

Ejemplos de uso

Explorar productos

You: What vignettes are available for Hungary?

Claude: [calls list_tickets with countryIsocode: "HU"]
        Found 12 vignette options for Hungary:
        - 10-day highway vignette (Category D1) — €14.90
        - Monthly highway vignette (Category D1) — €19.90
        ...

Gestionar webhooks

You: Set up a webhook at https://myapp.com/webhooks/vignetim
     for order completed and failed events.

Claude: [calls create_webhook with url, events]
        Webhook registered successfully!
        ID: 7f3a...
        Signing Secret: abc123...  (save this — it's only shown once)

Consultar estado de pedidos

You: Show me all failed orders from this week.

Claude: [calls list_orders with status filter and date range]
        Found 2 failed orders:
        1. Order #abc - Failed at 2026-03-18 (vignette, AT)
        2. Order #def - Failed at 2026-03-19 (eSIM, global)

Configuración de equipo

Agregue al archivo .claude/settings.json de su proyecto para acceso compartido del equipo:

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

Solución de problemas

"API credentials required"

Este error aparece al usar herramientas de la API sin credenciales. Asegúrese de que ambos encabezados X-API-Key y X-API-Secret estén configurados.

"Authentication failed"

Verifique que su clave API y secreto sean correctos
Compruebe que su clave esté activa en el Panel de Control de Socios de Vignetim
Asegúrese de que su IP esté en la lista blanca (si las restricciones de IP están habilitadas)

Sandbox vs Producción

Use el encabezado X-Environment: sandbox para probar contra la API de sandbox. El modo sandbox utiliza pagos simulados y datos de prueba.