Model Context Protocol (MCP)

De Vignetim Partner API biedt een volledige Model Context Protocol (MCP)-server, waarmee uw AI-assistent rechtstreeks met de API kan communiceren -- producten bekijken, bestellingen aanmaken, webhooks beheren en documentatie doorzoeken -- allemaal zonder uw IDE te verlaten.

Wat is MCP?

MCP is een open protocol dat standaardiseert hoe AI-toepassingen verbinding maken met externe tools en gegevensbronnen. Met de MCP-server van Vignetim wordt uw AI-coderingsassistent een Vignetim API-client.

Mogelijkheden

Categorie	Tools	Authenticatie vereist
Producten	`list_tickets`, `get_ticket`, `list_esim_packages`, `list_insurance_products`, `get_insurance_product`, `list_vehicle_categories`	Ja
Bestellingen	`create_order`, `list_orders`, `get_order`, `get_order_status`	Ja
Webhooks	`create_webhook`, `list_webhooks`, `update_webhook`, `delete_webhook`, `test_webhook`	Ja
Documentatie	`list_docs`, `get_doc`, `search_docs`, `get_openapi_spec`	Nee

MCP-endpoint

https://vignetim.com/api/mcp

Authenticatie

API-bewerkingstools vereisen uw Partner API-inloggegevens via HTTP-headers:

Header	Beschrijving
`X-API-Key`	Uw organisatie-API-sleutel
`X-API-Secret`	Uw organisatie-API-geheim
`X-Environment`	Optioneel: `production` (standaard) of `sandbox`

Documentatietools (list_docs, get_doc, search_docs, get_openapi_spec) werken zonder authenticatie.

Hoe het werkt

Uw AI-assistent maakt verbinding met https://vignetim.com/api/mcp
Het ontdekt beschikbare tools (producten, bestellingen, webhooks, documentatie)
Wanneer u vraagt "toon Oostenrijkse vignetten", roept de assistent list_tickets aan met countryIsocode: "AT"
De MCP-server ondertekent het verzoek met HMAC-SHA256 en stuurt het door naar de Partner API
Resultaten worden rechtstreeks aan uw assistent geretourneerd

De MCP-server handelt alle authenticatiecomplexiteit af -- HMAC-ondertekening, tijdstempels, nonces -- zodat uw AI-agent gewoon tools aanroept met eenvoudige parameters.

Platformondersteuning

Platform	Transport	Installatiegids
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 →

Aanvullende bronnen

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