MCP-Server

Winks MCP-Tools werden als Toolsets veröffentlicht – fokussierte Endpunkte, die jeweils eine Aufgabe abdecken. Sie verbinden Ihren KI-Client nur mit dem oder den ein bis zwei Toolsets, 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 verschiedene Endpunkte aufgeteilt sind

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

Tool-Definitionen beanspruchen 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 Aufgaben bedeutet, dass jede Verbindung den Wortschatz einer Aufgabe trägt.

Toolsets sind keine Berechtigungen

Die Wahl eines engen Toolsets schränkt nicht ein, was Ihr Konto tun kann, und die Wahl eines breiten Toolsets gewährt nichts zusätzlich. Jedes Tool erzwingt dieselben Kontoberechtigungen wie das Webportal, unter Ihrer angemeldeten Identität. Wenn Ihr Konto keine Buchung im Wink Portal stornieren kann, kann der Agent das auch nicht – unabhängig davon, mit welchem Endpunkt er verbunden ist.

Wählen Sie Toolsets für Fokus, nicht für Sicherheit.

---

Endpunktverzeichnis

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

https://api.wink.travel — die Plattform

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

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

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

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

Channel-Manager-Integration vs. eigene Preisverwaltung

Dies sind unterschiedliche Aufgaben für unterschiedliche Personen, und sie teilen keinen Endpunkt.

Ein Channel-Manager-, PMS- oder CRS-Anbieter integriert sich einmal über integrations.wink.travel/mcp/channel-manager und tauscht von da an Objekte, Preise, Verfügbarkeiten und Reservierungen über diese Integration aus. Dieser einzelne Endpunkt ist die gesamte Oberfläche.

Ein Hotelier, der seine eigenen Preise manuell ändert, nutzt die Extranet-Toolsets auf api.wink.travel — /mcp/extranet/rates und weitere. Diese sind kein Teil einer Channel-Manager-Integration und ein Integrator hat keinen Grund, sich damit zu verbinden.

Die Kontoverwaltung befindet sich ebenfalls auf api.wink.travel, unter /mcp/settings. Auf dem Integrations-Host gibt es kein /mcp/settings.

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

---

Welche Toolsets benötige ich?

Wenn Sie…	Verbinden Sie sich mit
einen Channel Manager, PMS oder CRS integrieren	integrations.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 Buchungserlebnis aufbauen	/mcp/booking-engine + /mcp/reference

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.

Sie wollen trotzdem alles?

https://api.wink.travel/mcp und https://integrations.wink.travel/mcp sind weiterhin verfügbar und bieten alle Tools ihres Hosts an. Sie sind nützlich, um zu erkunden, was existiert, aber wir empfehlen sie nicht für die tägliche Arbeit: Die Tool-Liste ist groß genug, um Ihre Aufgabe zu überlagern und die Tool-Auswahl des Agenten zu verschlechtern. Bevorzugen Sie die oben genannten Toolsets.

---

Wie die Authentifizierung funktioniert

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 im Hintergrund still, 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.

---

Verbinden Sie Ihren KI-Client

Claude Code

1. Stellen Sie sicher, dass Claude Code aktuell ist:

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

2. Wählen Sie ein Toolset aus dem obigen Verzeichnis und fügen Sie es hinzu. Zum Beispiel Preise und Verfügbarkeit:

   claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --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.

Fügen Sie so viele Toolsets hinzu, wie Ihre Arbeit benötigt – jedes ist ein separater Servereintrag mit eigenem Namen:

claude mcp add wink-operations https://api.wink.travel/mcp/extranet/operations --transport http
claude mcp add wink-analytics  https://api.wink.travel/mcp/analytics           --transport http

Sie melden sich nur einmal an. Nach der ersten Browser-Genehmigung verwendet Claude Code Ihre Wink-Sitzung für weitere Wink-Endpunkte wieder.

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 Repository-Stamm. Committen Sie diese Datei – jedes Teammitglied erhält dieselben Toolsets und jeder 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-Servereinträge hinzu:

   claude_desktop_config.json

   {
     "mcpServers": {
       "wink-extranet-rates": {
         "type": "http",
         "url": "https://api.wink.travel/mcp/extranet/rates"
       },
       "wink-extranet-operations": {
         "type": "http",
         "url": "https://api.wink.travel/mcp/extranet/operations"
       }
     }
   }

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).

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 Steckersymbol 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-Servereinträge hinzu:

   ~/.codex/config.json

   {
     "mcpServers": {
       "wink-extranet-rates": {
         "type": "http",
         "url": "https://api.wink.travel/mcp/extranet/rates"
       },
       "wink-extranet-operations": {
         "type": "http",
         "url": "https://api.wink.travel/mcp/extranet/operations"
       }
     }
   }

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 lassen Sie sich die verfügbaren Tools auflisten, um zu überprüfen, ob die Wink-Server aktiv sind.

Hinweis

Codex CLI MCP-Unterstützung erfordert Version 1.0 oder höher. Prüfen Sie mit codex --version und aktualisieren Sie mit npm install -g @openai/codex.

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 eines Toolsets aus dem obigen Verzeichnis ein, zum Beispiel:

   https://api.wink.travel/mcp/extranet/rates

   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 weitere benötigte Toolsets, zum Beispiel:

   https://api.wink.travel/mcp/extranet/operations

7. Jedes Toolset erscheint 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-Servereinträge hinzu:

   ~/.cursor/mcp.json

   {
     "mcpServers": {
       "wink-extranet-rates": {
         "type": "http",
         "url": "https://api.wink.travel/mcp/extranet/rates"
       },
       "wink-extranet-operations": {
         "type": "http",
         "url": "https://api.wink.travel/mcp/extranet/operations"
       }
     }
   }

3. Öffnen Sie Cursor. Gehen Sie zu Einstellungen → Cursor-Einstellungen → MCP und prüfen Sie, ob 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 ablegen statt in ~/.cursor/. 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-Servereinträge hinzu:

   ~/.codeium/windsurf/mcp_config.json

   {
     "mcpServers": {
       "wink-extranet-rates": {
         "type": "http",
         "url": "https://api.wink.travel/mcp/extranet/rates"
       },
       "wink-extranet-operations": {
         "type": "http",
         "url": "https://api.wink.travel/mcp/extranet/operations"
       }
     }
   }

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-Werkzeugleiste 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-extranet-rates": {
         "type": "http",
         "url": "https://api.wink.travel/mcp/extranet/rates"
       },
       "wink-extranet-operations": {
         "type": "http",
         "url": "https://api.wink.travel/mcp/extranet/operations"
       }
     }
   }

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 im MCP Servers-Panel als aktiv.

Alternative: Hinzufügen per URL

Im MCP Servers-Panel klicken Sie auf Server hinzufügen und fügen eine Toolset-URL wie https://api.wink.travel/mcp/extranet/rates 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 dessen, was der Agent anfordert. MCP-Clients verwenden denselben Berechtigungswortschatz wie der Rest der Plattform – siehe die vollständige 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 wird an jeden Wink MCP-Endpunkt zugelassen, aber jedes Tool erzwingt weiterhin den Bereichsscope des Endpunkts, den es umschließt (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 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 Berechtigungen, 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.

---

Fehlerbehebung

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 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-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 das Tool und sehen dann nach, welches Toolset es listet.

404 Not Found bei einem Toolset-Endpunkt

Prü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, daher sagt ein 401 allein nicht, ob der Endpunkt existiert.

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

Diesen Endpunkt gibt es 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 „Konto nicht gefunden“ zurück

Sie sind bei einem Wink-Konto angemeldet, das keine Verwaltungseinheit hat. Gehen Sie zu 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 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 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 die Server immer noch nicht erscheinen, 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 benötigt Cline 2.0 oder höher. Öffnen Sie das VS Code-Erweiterungsfenster, suchen Sie Cline und klicken Sie auf Aktualisieren, falls verfügbar. Nach dem Update laden Sie VS Code neu (Ctrl+Shift+P → „Developer: Reload Window“).

---

Wink Portal öffnen Wink auf GitHub