Model Context Protocol (MCP)

Die Vignetim Partner-API stellt einen vollständigen Model Context Protocol (MCP)-Server bereit, der es Ihrem KI-Assistenten ermöglicht, direkt mit der API zu interagieren -- Produkte durchsuchen, Bestellungen erstellen, Webhooks verwalten und Dokumentation durchsuchen -- alles ohne Ihre IDE zu verlassen.

Was ist MCP?

MCP ist ein offenes Protokoll, das standardisiert, wie KI-Anwendungen sich mit externen Tools und Datenquellen verbinden. Mit dem MCP-Server von Vignetim wird Ihr KI-Coding-Assistent zum Vignetim-API-Client.

Funktionen

Kategorie	Tools	Authentifizierung erforderlich
Produkte	`list_tickets`, `get_ticket`, `list_esim_packages`, `list_insurance_products`, `get_insurance_product`, `list_vehicle_categories`	Ja
Bestellungen	`create_order`, `list_orders`, `get_order`, `get_order_status`	Ja
Webhooks	`create_webhook`, `list_webhooks`, `update_webhook`, `delete_webhook`, `test_webhook`	Ja
Dokumentation	`list_docs`, `get_doc`, `search_docs`, `get_openapi_spec`	Nein

MCP-Endpunkt

https://vignetim.com/api/mcp

Authentifizierung

API-Operations-Tools erfordern Ihre Partner-API-Zugangsdaten über HTTP-Header:

Header	Beschreibung
`X-API-Key`	Ihr Organisations-API-Schlüssel
`X-API-Secret`	Ihr Organisations-API-Secret
`X-Environment`	Optional: `production` (Standard) oder `sandbox`

Dokumentations-Tools (list_docs, get_doc, search_docs, get_openapi_spec) funktionieren ohne Authentifizierung.

Funktionsweise

Ihr KI-Assistent verbindet sich mit https://vignetim.com/api/mcp
Er entdeckt die verfügbaren Tools (Produkte, Bestellungen, Webhooks, Dokumentation)
Wenn Sie fragen "Liste österreichische Vignetten auf", ruft der Assistent list_tickets mit countryIsocode: "AT" auf
Der MCP-Server signiert die Anfrage mit HMAC-SHA256 und leitet sie an die Partner-API weiter
Die Ergebnisse werden direkt an Ihren Assistenten zurückgegeben

Der MCP-Server übernimmt die gesamte Authentifizierungskomplexität -- HMAC-Signierung, Zeitstempel, Nonces -- sodass Ihr KI-Agent einfach Tools mit einfachen Parametern aufruft.

Plattformunterstützung

Plattform	Transport	Einrichtungsanleitung
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

Zusätzliche Ressourcen

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