MCP-Server

Wink stellt zwei authentifizierte MCP-Server bereit. Beide verwenden interaktives OAuth2-Login (PKCE-Autorisierungscode-Fluss) – Ihr KI-Agent öffnet einen Browser-Tab, damit Sie sich mit Ihrem Wink-Konto anmelden können. Keine Client-Secrets zur Verwaltung.

Server	URL	Was es macht
Inventory API	https://api.wink.travel/mcp	Inventar, Buchungen, Preise, Vertriebskanäle, Analysen und alle Plattformoperationen
Integrations	https://integrations.wink.travel/mcp	Channel-Manager-Integrationen – Synchronisation von Objekten, Preisen und Verfügbarkeiten mit OTAs

---

So funktioniert die Authentifizierung

Wink MCP-Server verwenden den OAuth2 Authorization Code + PKCE-Fluss und unterstützen Dynamic Client Registration (RFC 7591). So läuft die Verbindung beim ersten Mal ab:

1. Ihr KI-Client entdeckt den Autorisierungsserver über die /.well-known/oauth-protected-resource-Metadaten des MCP-Endpunkts.
2. Der Client registriert sich selbst über Dynamic Client Registration – keine manuelle Anwendungsregistrierung erforderlich.
3. Der Client öffnet einen Browser-Tab zu https://iam.wink.travel. Sie melden sich mit Ihrem Wink-Konto an und genehmigen die angeforderten Berechtigungen auf dem Zustimmungsbildschirm.
4. Wink stellt ein Access Token aus, das auf Ihr Konto beschränkt und mit Ihrer Identität verknüpft ist.
5. Der KI-Client hängt das Token an jede MCP-Anfrage an. Alle Tool-Ergebnisse sind automatisch auf Ihre Verwaltungseinheit beschränkt.
6. Tokens laufen nach 3 Stunden ab. Ihr KI-Client aktualisiert sie im Hintergrund stillschweigend, ohne erneut nachzufragen.

Jeder Tool-Aufruf läuft unter Ihrer Identität – dieselben ACL-Regeln, die das Webportal schützen, gelten auch für den KI-Agenten.

---

Verbinden Sie Ihren KI-Client

Claude Code

1. Stellen Sie sicher, dass Claude Code auf dem neuesten Stand ist:

   npm install -g @anthropic-ai/claude-code

2. Fügen Sie den Wink Inventory MCP-Server hinzu:

   claude mcp add wink-inventory https://api.wink.travel/mcp --transport http

3. Claude Code kontaktiert den Server, entdeckt den Autorisierungsserver und öffnet Ihren Standardbrowser.

4. Melden Sie sich bei Wink an und genehmigen Sie die Berechtigungsanfrage auf dem Zustimmungsbildschirm.

5. Claude Code bestätigt die Verbindung. Geben Sie /mcp ein, um zu überprüfen, ob der Server erscheint und seine Tools geladen sind.

Um auch den Integrationsserver hinzuzufügen:

claude mcp add wink-integrations https://integrations.wink.travel/mcp --transport http

Mit Ihrem Team teilen

Fügen Sie --scope project zu claude mcp add hinzu, und Claude Code schreibt die Server-URL in .mcp.json im Stammverzeichnis des Repos. Committen Sie diese Datei – jedes Teammitglied führt beim ersten Verbindungsaufbau seine eigene Browser-Anmeldung durch.

Claude Desktop

1. Bearbeiten Sie die Claude Desktop-Konfigurationsdatei:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • Linux: ~/.config/Claude/claude_desktop_config.json

2. Fügen Sie die MCP-Server-Einträge hinzu:

   claude_desktop_config.json

   {
     "mcpServers": {
       "wink-inventory": {
         "type": "http",
         "url": "https://api.wink.travel/mcp"
       },
       "wink-integrations": {
         "type": "http",
         "url": "https://integrations.wink.travel/mcp"
       }
     }
   }

3. Beenden Sie Claude Desktop vollständig und starten Sie es neu (verwenden Sie „Beenden“ aus der Menüleiste – das Schließen des Fensters reicht nicht aus).

4. Claude Desktop öffnet für jeden neuen Server einen Browser-Tab. Melden Sie sich bei Wink an und genehmigen Sie die Berechtigungen.

5. Das Stecker-Symbol in der unteren Symbolleiste zeigt beide Server als verbunden an.

OpenAI Codex

1. Stellen Sie sicher, dass Codex CLI installiert ist:

   npm install -g @openai/codex

2. Öffnen (oder erstellen) Sie die Codex-Konfigurationsdatei:

   • macOS / Linux: ~/.codex/config.json
   • Windows: %USERPROFILE%\.codex\config.json

3. Fügen Sie die Wink MCP-Server-Einträge hinzu:

   ~/.codex/config.json

   {
     "mcpServers": {
       "wink-inventory": {
         "type": "http",
         "url": "https://api.wink.travel/mcp"
       },
       "wink-integrations": {
         "type": "http",
         "url": "https://integrations.wink.travel/mcp"
       }
     }
   }

4. Starten Sie Codex. Beim ersten Gebrauch öffnet Codex einen Browser-Tab zu https://iam.wink.travel.

5. Melden Sie sich bei Wink an und genehmigen Sie die angeforderten Berechtigungen.

6. Codex bestätigt die Verbindung. Führen Sie codex aus und bitten Sie es, verfügbare Tools aufzulisten, um zu überprüfen, ob die Wink-Server aktiv sind.

Hinweis

Codex CLI MCP-Unterstützung erfordert Version 1.0 oder höher. Führen Sie codex --version aus, um die Version zu prüfen, und npm install -g @openai/codex, um ein Upgrade durchzuführen.

ChatGPT

MCP-Server-Unterstützung ist in der ChatGPT-Desktop-App für Plus-, Pro-, Team- und Enterprise-Abonnenten verfügbar.

1. Laden Sie die ChatGPT-Desktop-App herunter und installieren Sie sie, falls noch nicht geschehen.

2. Öffnen Sie die App und klicken Sie auf Ihr Profilbild oben rechts, dann wählen Sie Einstellungen.

3. Gehen Sie zu Connectors (oder MCP Servers, je nach App-Version) und klicken Sie auf Hinzufügen.

4. Geben Sie die URL des Wink Inventory-Servers ein:

   https://api.wink.travel/mcp

   Klicken Sie dann auf Verbinden.

5. ChatGPT öffnet einen Browser-Tab zu https://iam.wink.travel. Melden Sie sich bei Wink an und genehmigen Sie die Berechtigungen.

6. Wiederholen Sie die Schritte 4–5 für den Integrationsserver:

   https://integrations.wink.travel/mcp

7. Beide Server erscheinen in Ihrer Connectors-Liste. Starten Sie einen neuen Chat – Wink-Tools sind automatisch verfügbar.

Web-App-Einschränkung

MCP-Server sind nur in der Desktop-App konfigurierbar. Die ChatGPT-Weboberfläche unter chatgpt.com unterstützt keine benutzerdefinierten MCP-Server.

Cursor

1. Öffnen (oder erstellen) Sie die Cursor MCP-Konfigurationsdatei:

   • macOS / Linux: ~/.cursor/mcp.json
   • Windows: %USERPROFILE%\.cursor\mcp.json

2. Fügen Sie die Wink MCP-Server-Einträge hinzu:

   ~/.cursor/mcp.json

   {
     "mcpServers": {
       "wink-inventory": {
         "type": "http",
         "url": "https://api.wink.travel/mcp"
       },
       "wink-integrations": {
         "type": "http",
         "url": "https://integrations.wink.travel/mcp"
       }
     }
   }

3. Öffnen Sie Cursor. Gehen Sie zu Einstellungen → Cursor-Einstellungen → MCP und bestätigen Sie, dass beide Server mit grünem Status angezeigt werden. Wenn sie rot sind, klicken Sie auf Aktualisieren.

4. Cursor öffnet einen Browser-Tab zu https://iam.wink.travel. Melden Sie sich bei Wink an und genehmigen Sie die Berechtigungen.

5. Öffnen Sie einen Chat (Ctrl+L / Cmd+L) und bitten Sie Cursor, verfügbare Wink-Tools aufzulisten, um die Verbindung zu bestätigen.

Projektbezogene Konfiguration

Sie können auch eine mcp.json-Datei im Stammverzeichnis Ihres Projekts anstelle von ~/.cursor/ ablegen. Die Projektkonfiguration hat Vorrang und macht die Server für jedes Teammitglied verfügbar, das das Projekt in Cursor öffnet.

Windsurf

1. Öffnen (oder erstellen) Sie die Windsurf MCP-Konfigurationsdatei:

   • macOS / Linux: ~/.codeium/windsurf/mcp_config.json
   • Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json

2. Fügen Sie die Wink MCP-Server-Einträge hinzu:

   ~/.codeium/windsurf/mcp_config.json

   {
     "mcpServers": {
       "wink-inventory": {
         "type": "http",
         "url": "https://api.wink.travel/mcp"
       },
       "wink-integrations": {
         "type": "http",
         "url": "https://integrations.wink.travel/mcp"
       }
     }
   }

3. Starten Sie Windsurf vollständig neu (Datei → Beenden, dann neu öffnen).

4. Gehen Sie zu Einstellungen → MCP Servers und prüfen Sie, ob beide Server als verbunden angezeigt werden. Windsurf öffnet beim ersten Gebrauch einen Browser-Tab zu https://iam.wink.travel.

5. Melden Sie sich bei Wink an und genehmigen Sie die Berechtigungen. Die Server werden im Einstellungsfenster grün, sobald die Authentifizierung abgeschlossen ist.

Hinweis

Windsurf MCP-Unterstützung erfordert Version 1.4 oder höher. Prüfen Sie dies über Hilfe → Über Windsurf und aktualisieren Sie bei Bedarf von der Windsurf-Website.

Cline (VS Code)

Cline ist eine VS Code-Erweiterung mit integriertem MCP-Server-Manager. Keine manuelle JSON-Bearbeitung erforderlich.

1. Installieren Sie Cline aus dem VS Code Marketplace:

   • Öffnen Sie VS Code und drücken Sie Ctrl+Shift+X / Cmd+Shift+X
   • Suchen Sie nach Cline und klicken Sie auf Installieren

2. Klicken Sie auf das Cline-Symbol in der Aktivitätsleiste (linke Seitenleiste), um das Cline-Panel zu öffnen.

3. Klicken Sie auf das MCP Servers-Symbol (Stecker-Symbol) in der Cline-Symbolleiste und wählen Sie MCP-Einstellungen bearbeiten.

4. VS Code öffnet cline_mcp_settings.json. Fügen Sie die Wink-Einträge hinzu:

   cline_mcp_settings.json

   {
     "mcpServers": {
       "wink-inventory": {
         "type": "http",
         "url": "https://api.wink.travel/mcp"
       },
       "wink-integrations": {
         "type": "http",
         "url": "https://integrations.wink.travel/mcp"
       }
     }
   }

5. Speichern Sie die Datei. Cline lädt automatisch neu und öffnet einen Browser-Tab zu https://iam.wink.travel.

6. Melden Sie sich bei Wink an und genehmigen Sie die Berechtigungen. Beide Server erscheinen als aktiv im MCP Servers-Panel.

Alternative: Hinzufügen per URL

Klicken Sie im MCP Servers-Panel auf Server hinzufügen und fügen Sie https://api.wink.travel/mcp direkt ein. Cline füllt die Konfiguration automatisch aus und übernimmt die Authentifizierung ohne manuelle JSON-Bearbeitung.

---

Berechtigungen (Scopes)

Wenn Sie den Zustimmungsbildschirm genehmigen, sehen Sie eine Aufschlüsselung der vom Agenten angeforderten Berechtigungen. MCP-Clients verwenden dieselbe Berechtigungsvokabel wie der Rest der Plattform – siehe die vollständige Scope-Referenz auf der Authentifizierungsseite.

Zwei Dinge sind spezifisch für MCP:

• Die Scopes mcp.read, mcp.write und mcp.remove sind zusätzlich erforderlich, um den MCP-Transport zu öffnen. Ein Client mit einem mcp.*-Scope erhält Zugang zu /mcp, aber jedes Tool, das er aufruft, erzwingt weiterhin den Abschnitts-Scope des jeweiligen Endpunkts (z. B. booking.read).
• Der KI-Client fordert nur die Scopes an, die er benötigt. Sie können einzelne Berechtigungen auf dem Zustimmungsbildschirm ablehnen – Tools, die einen abgelehnten Scope benötigen, geben beim Aufruf einen Fehler zurück.

---

Fehlerbehebung

Browser-Tab öffnet sich nicht

Ihr KI-Client unterstützt möglicherweise noch nicht den interaktiven PKCE-Fluss. Prüfen Sie, ob Sie eine aktuelle Version verwenden:

• Claude Code: npm install -g @anthropic-ai/claude-code
• Codex CLI: npm install -g @openai/codex
• Claude Desktop / ChatGPT Desktop: Aktualisieren Sie über den integrierten Updater der App

401 Unauthorized nach der Anmeldung

Ihr zwischengespeichertes Token ist möglicherweise veraltet. Entfernen Sie den Server und fügen Sie ihn erneut hinzu, um eine frische Anmeldung auszulösen:

# Claude Code
claude mcp remove wink-inventory
claude mcp add wink-inventory https://api.wink.travel/mcp --transport http

Für Claude Desktop und ChatGPT entfernen Sie den Servereintrag in den Einstellungen, starten die App neu und fügen ihn erneut hinzu.

403 Forbidden bei Aufruf eines bestimmten Tools

Das Tool benötigt einen Scope, den Sie auf dem Zustimmungsbildschirm nicht genehmigt haben. Verbinden Sie den Server erneut – der Zustimmungsbildschirm erscheint wieder, und Sie können die fehlende Berechtigung genehmigen.

Der Server erscheint, aber Tool-Aufrufe geben „Konto nicht gefunden“ zurück

Sie sind bei einem Wink-Konto angemeldet, das keine Verwaltungseinheit besitzt. Gehen Sie zum Wink Portal und stellen Sie sicher, dass Ihr Konto eingerichtet ist, bevor Sie den MCP-Server verwenden.

Token läuft während der Sitzung ab

Tokens sind 3 Stunden gültig. Claude Code und Claude Desktop aktualisieren Tokens stillschweigend, ohne Ihre Sitzung zu unterbrechen. Wenn Sie nach langer Inaktivität Authentifizierungsfehler sehen, senden Sie eine neue Nachricht – der Client authentifiziert automatisch neu.

Codex CLI zeigt „MCP server unreachable“

Prüfen Sie, ob Ihre ~/.codex/config.json gültiges JSON ist (keine abschließenden Kommas) und "type": "http" gesetzt ist. Codex benötigt HTTP-Transport für Remote-Server; stdio-Transport ist nur für lokale Binärdateien.

ChatGPT „Connectors“-Menü fehlt

MCP-Unterstützung erfordert ChatGPT Desktop-App Version 1.2024.352 oder höher und ein aktives Plus-, Pro-, Team- oder Enterprise-Abonnement. Aktualisieren Sie die App und prüfen Sie Ihren Plan unter Einstellungen → Konto.

Cursor-Server zeigt rot / „Verbindung fehlgeschlagen“

Prüfen Sie, ob Ihre ~/.cursor/mcp.json gültiges JSON enthält und "type": "http" gesetzt ist. Gehen Sie dann zu Einstellungen → Cursor-Einstellungen → MCP und klicken Sie auf Aktualisieren. Wenn der Fehler weiterhin besteht, starten Sie Cursor vollständig neu – Konfigurationsänderungen werden nicht immer ohne Neustart übernommen.

Windsurf MCP-Server werden in den Einstellungen nicht angezeigt

Windsurf benötigt einen vollständigen Neustart (nicht nur Fenster-Neuladen), um Änderungen an mcp_config.json zu übernehmen. Verwenden Sie Datei → Beenden und starten Sie neu. Wenn die Server weiterhin nicht angezeigt werden, prüfen Sie, ob Sie Windsurf 1.4+ verwenden (über Hilfe → Über Windsurf).

Cline „Server hinzufügen“-Option ist nicht sichtbar

Der MCP-Server-Manager erfordert Cline 2.0 oder höher. Öffnen Sie das VS Code-Erweiterungsfenster, suchen Sie Cline und klicken Sie auf Aktualisieren, falls ein Update verfügbar ist. Nach dem Update laden Sie VS Code neu (Ctrl+Shift+P → „Developer: Reload Window“).

---

Wink Portal öffnen Wink auf GitHub