Zum Inhalt springen

MCP-Server

Winks MCP-Tools werden als Toolsets veröffentlicht – fokussierte Endpunkte, die jeweils eine Aufgabe abdecken. Sie verbinden Ihren KI-Client nur mit einem oder zwei, die zu Ihrer Arbeit passen, nicht mit allen.

Jeder Endpunkt verwendet interaktives OAuth2-Login (PKCE-Autorisierungscode-Fluss): Ihr KI-Agent öffnet einen Browser-Tab, Sie melden sich mit Ihrem Wink-Konto an, und das war’s. Keine Client-Geheimnisse zu verwalten.

Ein Channel-Manager-Integrator verbindet sich mit einem Endpunkt
claude mcp add wink-channel-manager https://integrations.wink.travel/mcp/channel-manager --transport http
Ein Hotelier, der seine eigenen Preise verwaltet, verbindet sich mit einem anderen
claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http

Warum die Tools auf mehrere Endpunkte verteilt sind

Abschnitt betitelt „Warum die Tools auf mehrere Endpunkte verteilt sind“

Wink stellt etwa 500 Tools bereit. Alle auf einmal einem Agenten zu übergeben ist technisch möglich – aber keine gute Idee.

Tool-Definitionen kosten Kontext. Jedes Tool, das ein MCP-Server anbietet, wird vor der Arbeit in das Kontextfenster des Modells geladen, zusammen mit seiner Beschreibung und dem vollständigen Parameterschema. Fünfhundert davon verbrauchen einen großen Teil des Budgets, das Ihre eigentliche Aufgabe bei jeder einzelnen Anfrage benötigt.

Die Qualität der Auswahl sinkt mit der Länge der Liste. Ein Agent, der aus 500 ähnlich benannten Tools auswählt, trifft schlechtere Entscheidungen als einer, der aus 40 auswählt. Wenn Sie einen Channel Manager integrieren, sind etwa zwanzig Tools für Sie relevant; die anderen 480 sind Rauschen, das das richtige Tool schwerer auffindbar macht.

Die Arbeit ist tatsächlich trennbar. Jemand, der Verfügbarkeiten aus einem PMS synchronisiert, und jemand, der Affiliate-Landingpages kuratiert, teilen fast keine Tools. Die Aufteilung nach Aufgabe bedeutet, dass jede Verbindung den Wortschatz einer Aufgabe trägt.


Zwei Hosts bedienen Toolsets. Die Tool-Anzahlen sind ungefähr und wachsen mit der Zeit.

EndpunktToolsWas abgedeckt wird
/mcp/extranet/facilities~64Das buchbare und vor Ort verfügbare Inventar: Gästezimmer und Zimmertypen, Spas, Restaurants, Tagungsräume, Aktivitäten, Attraktionen, Orte, weitere verkaufbare Artikel
/mcp/extranet/property~62Die Objektakte und ihre kommerziellen Bedingungen: Profil und Inhalte, Zusatzleistungen, Stornierungsbedingungen, Vorteile, Ankündigungen
/mcp/settings~60Kontoverwaltung: Profil und Branding der Verwaltungseinheit, Manager und deren Berechtigungen, Anpassungen, Webhooks, Benachrichtigungseinstellungen
/mcp/studio/embeds~48Veröffentlichung kuratierter Inventare: Widgets, Raster und gerankte Raster, Karten, Karten, Deep Links zu Inventar- und Lieferantenseiten
/mcp/extranet/rates~44Preise und Verfügbarkeit: Inventar-Preiszeiträume und Kontingente, Tarifpläne, Haupttarife, Sonder- und Aktionspreise
/mcp/extranet/operations~39Betrieb eines Live-Objekts: Reservierungen und deren Lebenszyklus, Gästebewertungen und Antworten, Kalenderfeeds, geplante Aufgaben
/mcp/extranet/distribution~37Wo Inventar verkauft wird: Vertriebskanäle und Tarifmodifikatoren, Affiliate- und Lieferantenbeziehungsanfragen, Registrierung, Lead-Erfassung
/mcp/studio/curation~35Aufbau vermarktbarer Kollektionen: statische und dynamische Listen, gerankte Listen, gespeicherte Suchen, Objekt-Aggregate
/mcp/link-manager~28Syndizierte Link-Sammlungen, deren Design, Kategorien und Tags sowie verkürzte URLs
/mcp/reference~24Nur-Lese-Lookup-Daten: Länder, Währungen und Wechselkurse, Sprachen, Zeitzonen, Geo-Lookups, IP-Geolokalisierung
/mcp/analytics~18Buchungs- und Umsatzanalysen: Übersichten, Liniendiagramme, Bestenlisten, Affiliate-Leistung, Share-Metriken
/mcp/payment~18Finanzoperationen: Hauptbuch, Auszahlungen und Gebührenabschätzungen, Buchungsfonds-Aggregate
/mcp/booking-engine~17Der reisegastorientierte Einkaufsweg: Suche und Lookup, Warenkorb und Checkout, Bucket Lists, Kampagnenanpassung
/mcp/social~17Verbundene soziale Konten, Veröffentlichung und Planung von Beiträgen, Auswertung von Beiträgen
/mcp/travel-agent~8Agentenvermittelte Buchungen im Auftrag von Reisenden und Agentenberichte

https://integrations.wink.travel — Channel-Manager-Integrationen

Abschnitt betitelt „https://integrations.wink.travel — Channel-Manager-Integrationen“

Ein Endpunkt, weil dieser Host für eine Aufgabe existiert.

EndpunktToolsWas abgedeckt wird
/mcp/channel-manager~9Verbindung und Verifizierung einer Channel-Manager-, PMS- oder CRS-Integration

Jeder Endpunkt bietet auch ein ping-Tool, damit Sie bestätigen können, dass eine Verbindung aktiv ist, bevor Sie echte Arbeit anfragen.

Für den vollständigen Buchungsablauf eines Reisenden verbinden Sie Wink Booking Engine unter https://api.wink.travel/mcp/booking-engine und eine kompatible Zahlungs-Wallet. Das Hinzufügen des Wink MCP öffnet die Browser-Anmeldung und die Auswahl der Berechtigungen; Ihr Client übernimmt dann die Authentifizierung.

Booking Engine umfasst Zielort-Lookup, Hotel- und Zimmersuche, agentic_booking_quote, agentic_booking_pay, agentic_booking_book, Buchungsabruf und Belege, wenn agentische Buchung und Zahlung für diese Umgebung aktiviert sind. Siehe Agentic Payments für Einrichtung, auszuwählende Berechtigungen und die Schritte von der Suche bis zur Bestätigung.


Wenn Sie…Verbinden Sie sich mit
einen Channel Manager, PMS oder CRS integrierenintegrations.wink.travel/mcp/channel-manager — nur dieser eine
den Inhalt einer Unterkunft verwalten/mcp/extranet/property + /mcp/extranet/facilities
Zimmer und Zimmertypen verwalten/mcp/extranet/facilities
Preise und Verfügbarkeit verwalten/mcp/extranet/rates
tägliche Reservierungen abwickeln/mcp/extranet/operations
Distribution ausbauen/mcp/extranet/distribution + /mcp/analytics
Affiliate-Seiten erstellen/mcp/studio/curation + /mcp/studio/embeds
Link-in-Bio-Seiten betreiben/mcp/link-manager + /mcp/social
im Auftrag von Reisenden buchen/mcp/travel-agent
Geld abgleichen/mcp/payment
ein Zimmer mit einem KI-Agenten buchen/mcp/booking-engine + eine kompatible Zahlungs-Wallet — siehe Agentic Payments
ein Buchungserlebnis aufbauen/mcp/booking-engine; optional /mcp/reference für zusätzliche Lookups

Booking Engine enthält den Kernbuchungsablauf. Es bietet Konto- und Anpassungsentdeckung, Zielort-Lookup, Hotelverfügbarkeit und Zimmerpreisinformationen, Warenkörbe, Checkout und Reisenden-Buchungsverwaltung. Agentische Buchungs- und Zahlungstools sind ebenfalls enthalten, wenn sie für diese Umgebung aktiviert sind.

Für eine stadtbasierte Hotelsuche verwenden Sie destination_lookup_search_suggestions, um das Ziel zu ermitteln, dann inventory_search_city, um verfügbare Hotels und Preise zu finden. Beide Tools sind in /mcp/booking-engine, sodass dieser Ablauf keine Referenzverbindung benötigt.

Fügen Sie /mcp/reference hinzu, wenn Sie unterstützende Lookups wie Länder, Währungen und Wechselkurse, unterstützte Sprachen, Zeitzonen, breitere geografische Suchen, OTA-Klassifikationen oder öffentliches Unterkunftswissen benötigen. Diese sind optionale Ergänzungen zum Buchungsablauf.

Beginnen Sie mit einem. Fügen Sie einen weiteren hinzu, wenn Sie etwas anfragen, das der erste nicht kann – jede Verbindung ist unabhängig, und das Hinzufügen eines weiteren beeinflusst die anderen nicht.


Wink MCP-Server verwenden den OAuth2 Authorization Code + PKCE-Fluss und unterstützen Dynamic Client Registration (RFC 7591). So läuft es ab, wenn Sie sich zum ersten Mal verbinden:

  1. Ihr KI-Client entdeckt den Autorisierungsserver aus den /.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 erneuert sie still im Hintergrund, ohne erneut zu fragen.

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


Fügen Sie jedes Toolset in Claude als benutzerdefinierten Connector hinzu. Es gibt keine Konfigurationsdatei zu bearbeiten und keine Anwendung oder Geheimnis zu erstellen.

  1. Öffnen Sie in Claude Customize › Connectors, klicken Sie auf Add und dann auf Add custom connector.

  2. Geben Sie einen Namen ein (zum Beispiel Wink Link manager) und als MCP-Server-URL ein Toolset aus dem obigen Verzeichnis, zum Beispiel:

    https://api.wink.travel/mcp/link-manager

    Klicken Sie auf Continue.

  3. Claude erkennt die Wink-Anmeldung. Belassen Sie Authentication: Sign in now und OAuth client: Register automatically, dann klicken Sie auf Add.

  4. Klicken Sie auf Connect. Eine Wink-Anmeldeseite öffnet sich unter https://iam.wink.travel. Melden Sie sich bei Wink an und genehmigen Sie die Berechtigungen auf dem Zustimmungsbildschirm.

  5. Die Tools des Connectors sind jetzt in Ihren Chats verfügbar. Wiederholen Sie dies für jedes Toolset, das Ihre Arbeit benötigt; jedes ist ein eigener Connector.


Wenn Sie den Zustimmungsbildschirm genehmigen, sehen Sie eine Aufschlüsselung dessen, was der Agent anfragt. MCP-Clients verwenden denselben Berechtigungswortschatz wie der Rest der Plattform – siehe die vollständige Scope-Referenz auf der Authentifizierungsseite.

Drei 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 wird an jeden Wink MCP-Endpunkt zugelassen, aber jedes Tool erzwingt weiterhin den Abschnitts-Scope des Endpunkts, den es umschließt (z. B. booking.read).
  • MCP agiert immer als angemeldeter Benutzer. Der KI-Client erhält die mcp.*-Scopes durch Ihre Anmeldung, niemals von einer Application, die Sie erstellen. Machine-to-Machine-(Client-Credentials)-Tokens können den MCP-Transport nicht öffnen; verwenden Sie die REST-API für Server-zu-Server-Arbeit.
  • 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 bei Aufruf einen Fehler zurück.

Toolsets ändern daran nichts. Der Endpunkt, mit dem Sie sich verbinden, entscheidet, welche Tools aufgelistet werden, nicht, was sie tun dürfen. Die Verbindung zu /mcp/payment gewährt keine finanziellen Rechte, die Sie nicht bereits hatten, und die Verbindung zu /mcp/reference verhindert nicht, dass ein Tool dort seinen eigenen Scope erzwingt. Die Autorisierung wird pro Tool-Aufruf anhand Ihres Tokens und der Berechtigungen Ihres Kontos entschieden.


Browser-Tab öffnet sich nicht

Ihr KI-Client unterstützt möglicherweise noch nicht den interaktiven PKCE-Fluss. Vergewissern Sie sich, dass 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 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:

Terminal-Fenster
# Claude Code
claude mcp remove wink-rates
claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http

Für Claude Desktop und ChatGPT entfernen Sie den Servereintrag aus 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, oder eine Berechtigung, die Ihr Konto nicht besitzt. Verbinden Sie den Server erneut – der Zustimmungsbildschirm erscheint wieder und Sie können die fehlende Berechtigung genehmigen. Wenn es weiterhin fehlschlägt, benötigt das Tool eine Kontoberechtigung, die Sie nicht haben; die Verbindung zu einem anderen Toolset hilft nicht, da Toolsets keine Berechtigungen gewähren.

Das benötigte Tool ist nicht in der Liste

Sie sind wahrscheinlich mit einem Toolset verbunden, das diese Aufgabe nicht abdeckt. Prüfen Sie das Endpunktverzeichnis und fügen Sie das Toolset hinzu, das es abdeckt – Verbindungen sind unabhängig, das Hinzufügen eines Toolsets ändert nichts an den anderen. Wenn Sie unsicher sind, welches Toolset es hat, verbinden Sie sich vorübergehend mit https://api.wink.travel/mcp, finden Sie das Tool und sehen Sie dann nach, welches Toolset es auflistet.

404 Not Found bei einem Toolset-Endpunkt

Überprüfen Sie den Pfad sorgfältig – die verschachtelten Toolsets haben zwei Segmente (/mcp/extranet/rates, nicht /mcp/extranet-rates), die flachen haben eines (/mcp/link-manager). Beachten Sie, dass eine nicht authentifizierte Anfrage an einen Pfad unter /mcp 401 zurückgibt, nicht 404, sodass ein 401 allein nicht aussagt, ob der Endpunkt existiert.

Ich habe mich mit api.wink.travel/mcp/channel-manager verbunden und nichts erhalten

Dieser Endpunkt existiert nicht. Channel-Manager-Integration wird nur von https://integrations.wink.travel/mcp/channel-manager bedient. Wenn Sie auch die eigenen Preise einer Unterkunft manuell lesen oder schreiben müssen, ist das eine separate Aufgabe auf einem separaten Endpunkt – siehe /mcp/extranet/rates.

Der Server erscheint, aber Tool-Aufrufe geben “account not found” zurück

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

Token läuft mitten in der Sitzung ab

Tokens sind 3 Stunden gültig. Claude Code und Claude Desktop erneuern Tokens still, ohne Ihre Sitzung zu unterbrechen. Wenn Sie nach langer Inaktivität Auth-Fehler 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-Menü “Connectors” 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 / “Failed to connect”

Vergewissern Sie sich, dass Ihre ~/.cursor/mcp.json gültiges JSON enthält und "type": "http" gesetzt ist. Gehen Sie dann zu Settings → Cursor Settings → MCP und klicken Sie auf Refresh. Wenn der Fehler bleibt, 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 Server weiterhin fehlen, prüfen Sie, ob Sie Windsurf 1.4+ verwenden über Hilfe → Über Windsurf.

Cline-Option “Add Server” ist nicht sichtbar

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


Wink Portal öffnen Wink auf GitHub