MCP-Server

Übersicht

Der gehostete Wink MCP-Server ist verfügbar unter:

https://docs.mcp.wink.travel/mcp

Richten Sie kompatible KI-Clients (VS Code, Cursor, andere mit MCP HTTP-Transport) auf diesen Endpunkt, um ihnen zu ermöglichen:

Durchsuchen von Produkt- & Plattformdokumentationen (wink://docs/...)
Durchsuchen von Live-OpenAPI-Spezifikationen und Operationsdokumentationen (wink://api/...)
Durchführung leichter semantischer / Stichwortsuchen über Dokumente und Live-APIs

Transport

Verwenden Sie den primären streamfähigen HTTP-Endpunkt:

https://docs.mcp.wink.travel/mcp

Wenn Ihr Client nur SSE unterstützt, verwenden Sie:

https://docs.mcp.wink.travel/sse

Claude Code

Offizielle Dokumentation: Verbinden Sie Claude Code über MCP mit Tools

Anthropic empfiehlt den Remote-HTTP-Transport für cloud-gehostete MCP-Server:

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

Innerhalb von Claude Code führen Sie /mcp aus, um den Serverstatus zu prüfen. Wenn Sie den Server mit dem gesamten Repository teilen möchten, fügen Sie --scope project hinzu, damit Claude Code die Konfiguration in .mcp.json schreibt.

Codex

Offizielle Dokumentation: Docs MCP Quickstart für Codex

OpenAI dokumentiert die MCP-Einrichtung über die Codex-CLI und weist darauf hin, dass die Konfiguration mit der IDE-Erweiterung geteilt wird:

codex mcp add wink-docs --url https://docs.mcp.wink.travel/mcp
codex mcp list

Cursor

Cursor MCP-Dokumentation: https://cursor.com/docs/context/mcp Einrichtung: Fügen Sie den Remote-Server über die MCP-Einstellungen hinzu.

{
  "mcpServers": {
    "wink-docs": {
      "url": "https://docs.mcp.wink.travel/mcp",
    }
  }
}

VS Code

Offizielle Dokumentation: https://code.visualstudio.com/docs/copilot/customization/mcp-servers Minimale Remote-Konfiguration (Benutzer- oder Arbeitsbereichs-mcp.json):

{
  "servers": {
    "wink-docs": {
      "type": "http",
      "url": "https://docs.mcp.wink.travel/mcp"
    }
  }
}

Tipps:

Verwenden Sie die Befehls-Palette: „MCP: List Servers“, um die Verbindung zu bestätigen und Tools zu durchsuchen.
Der Tool-Auswahlpicker ermöglicht das Aktivieren/Deaktivieren von api_search und docs_search.
Kontext hinzufügen: Chat-Ansicht → Kontext hinzufügen → MCP-Ressourcen, um Dokumentseiten anzuhängen.

Kern-Resource-URIs

URI	Beschreibung
`wink://docs`	Dokumentationsindex (nach Kategorien gruppiert)
`wink://docs/{path}`	Spezifischer Dokumentationsartikel (Markdown / MDX)
`wink://api`	Live-OpenAPI-Katalog, entdeckt aus Winks Swagger-Konfiguration
`wink://api/{apiName}`	Kompakte API-Zusammenfassung mit Authentifizierung, Tags, Headern und Beispieloperationen
`wink://api/{apiName}/operations`	Vollständige Auflistung der Operationen, gruppiert nach Tag
`wink://api/{apiName}/operation/{key}`	Einzelne Operationsdetails (Parameter, Anfragetext, Antworten)
`wink://api/{apiName}/schema/{schemaName}`	Aufgelöstes Komponentenschema mit verschachtelten Feldern, Typen und Beispielen
`wink://api/{apiName}/operation/{key}/request`	Anfragetypische Ansicht mit erforderlichen Eingaben und minimalem Beispiel-Payload
`wink://api/{apiName}/operation/{key}/response/{status}`	Antworttypische Ansicht für einen bestimmten Statuscode
`wink://api/{apiName}/operation/{key}/recipe`	Aufgabenorientierter Ablauf für den korrekten Aufruf dieser Operation

Suchwerkzeuge (Kurzübersicht)

Werkzeug	Zweck	Typische Suchbeispiele
`api_search`	Finden der Live-API oder Operation zur Integration	`create affiliate`, `payment receipt`, `lookup inventory`, `invite manager`
`docs_search`	Finden von konzeptuellen Dokumenten / Anleitungen	`authentication`, `webhooks`, `wordPress`

Lassen Sie query leer, um Vorschläge zu erhalten. Jedes Ergebnis enthält die MCP-URI, die Sie öffnen können. Bei Operationstreffern liefert api_search auch verlinkte Request-, Response-, Schema- und Recipe-URIs, sodass Agenten direkt in die nützlichsten Unterressourcen springen können.

Typisches Nutzungsmuster

Führen Sie api_search mit Ihrer Absicht aus (z. B. “create affiliate” oder “payment receipt”).
Öffnen Sie die zurückgegebene wink://api/... URI oder folgen Sie den verlinkten Feldern request_uri, response_uris, request_schema_uris, response_schema_uris und recipe_uri.
Verwenden Sie docs_search für unterstützende Konzepte (Authentifizierung, Webhooks, Workflows).

KI-Fähigkeiten

Vorgefertigte Agentenfähigkeiten verwenden diesen MCP-Server als ihre Quelle der Wahrheit. Fähigkeiten geben Ihrem Coding-Agenten einen strukturierten Workflow für die Entwicklung gegen Wink-APIs – anstatt Endpunkte zu erraten, liest der Agent die Live-Verträge direkt vom MCP-Server.

Siehe AI Skills für verfügbare Skills und Installationsanweisungen.

Hinweise

Jede zurückgegebene URI kann vom Agenten geöffnet werden, um den vollständigen Inhalt zu erhalten.
Der wink://api-Baum ist live und folgt dem aktuellen Upstream-OpenAPI-Katalog anstelle eines generierten Repo-Index.
Vorschläge erscheinen automatisch, wenn Abfragen leer sind.

Wink auf GitHub