Vignetim Claude MCP

Verbinden Sie die Vignetim Partner-API direkt mit Claude Code oder Claude Desktop. Ihr Assistent kann dann Produkte durchsuchen, Bestellungen erstellen, Webhooks verwalten und Dokumentation durchsuchen.

Schnelleinrichtung

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"

Für Sandbox-Tests:

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

Fügen Sie Folgendes zu Ihrer Claude Desktop-Konfigurationsdatei hinzu:

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"
			}
		}
	}
}

Starten Sie Claude Desktop nach dem Speichern neu.

Verfügbare Tools

Produkte

Bestellungen

Webhooks

Dokumentation

Anwendungsbeispiele

Produkte durchsuchen

Sie: Welche Vignetten gibt es für Ungarn?

Claude: [ruft list_tickets mit countryIsocode: "HU" auf]
        12 Vignettenoptionen für Ungarn gefunden:
        - 10-Tage-Autobahnvignette (Kategorie D1) — 14,90 €
        - Monats-Autobahnvignette (Kategorie D1) — 19,90 €
        ...

Webhooks verwalten

Sie: Richte einen Webhook unter https://myapp.com/webhooks/vignetim
     für Bestellung-abgeschlossen- und -fehlgeschlagen-Ereignisse ein.

Claude: [ruft create_webhook mit url, events auf]
        Webhook erfolgreich registriert!
        ID: 7f3a...
        Signing Secret: abc123... (speichern — wird nur einmal angezeigt)

Bestellstatus prüfen

Sie: Zeige mir alle fehlgeschlagenen Bestellungen dieser Woche.

Claude: [ruft list_orders mit Statusfilter und Datumsbereich auf]
        2 fehlgeschlagene Bestellungen gefunden:
        1. Bestellung #abc - Fehlgeschlagen am 2026-03-18 (Vignette, AT)
        2. Bestellung #def - Fehlgeschlagen am 2026-03-19 (eSIM, global)

Team-Konfiguration

Fügen Sie Folgendes zur .claude/settings.json Ihres Projekts hinzu, um teamweiten Zugriff zu ermöglichen:

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

Fehlerbehebung

"API credentials required"

Dieser Fehler erscheint, wenn API-Tools ohne Zugangsdaten verwendet werden. Stellen Sie sicher, dass sowohl der X-API-Key- als auch der X-API-Secret-Header konfiguriert sind.

"Authentication failed"

• Überprüfen Sie, ob Ihr API-Schlüssel und Secret korrekt sind
• Prüfen Sie, ob Ihr Schlüssel im Vignetim Partner-Dashboard aktiv ist
• Stellen Sie sicher, dass Ihre IP auf der Whitelist steht (falls IP-Einschränkungen aktiviert sind)

Sandbox vs. Produktion

Verwenden Sie den Header X-Environment: sandbox, um gegen die Sandbox-API zu testen. Der Sandbox-Modus verwendet simulierte Zahlungen und Testdaten.