MCP Server

Overzicht

De gehoste Wink MCP-server is beschikbaar op:

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

Richt compatibele AI-clients (VS Code, Cursor, anderen die MCP HTTP-transport implementeren) op dit eindpunt om ze te laten:

• Bladeren door product- en platformdocumentatie (wink://docs/...)
• Bladeren door live OpenAPI-specificaties en operationele documentatie (wink://api/...)
• Uitvoeren van lichte semantische / trefwoordzoekopdrachten over documentatie en live API’s

Transport

Gebruik het primaire streambare HTTP-eindpunt:

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

Als je client alleen SSE ondersteunt, gebruik dan:

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

Claude Code

Officiële documentatie: Verbind Claude Code met tools via MCP

Anthropic raadt de remote HTTP-transport aan voor cloud-gehoste MCP-servers:

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

Binnen Claude Code, voer /mcp uit om de serverstatus te controleren. Als je de server met het hele repo wilt delen, voeg dan --scope project toe zodat Claude Code de configuratie schrijft naar .mcp.json.

Codex

Officiële documentatie: Docs MCP quickstart voor Codex

OpenAI documenteert MCP-configuratie via de Codex CLI, en vermeldt dat de configuratie gedeeld wordt met de IDE-extensie:

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

Cursor

Cursor MCP-documentatie: https://cursor.com/docs/context/mcp Setup: Voeg remote server toe via MCP-instellingen.

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

VS Code

Officiële documentatie: https://code.visualstudio.com/docs/copilot/customization/mcp-servers Minimale remote configuratie (user of workspace mcp.json):

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

Tips:

• Gebruik Command Palette: “MCP: List Servers” om verbinding te bevestigen en tools te bekijken.
• Tools-picker laat je api_search en docs_search in- of uitschakelen.
• Voeg context toe: Chat-weergave → Add Context → MCP Resources om documentatiepagina’s toe te voegen.

Kern Resource URI’s

URI	Beschrijving
wink://docs	Documentatie-index (gegroepeerd per categorie)
wink://docs/{path}	Specifiek documentatieartikel (Markdown / MDX)
wink://api	Live OpenAPI-catalogus ontdekt vanuit Wink’s swagger-configuratie
wink://api/{apiName}	Compact API-overzicht met authenticatie, tags, headers en voorbeeldoperaties
wink://api/{apiName}/operations	Volledige lijst van operaties gegroepeerd per tag
wink://api/{apiName}/operation/{key}	Detail van individuele operatie (parameters, request body, responses)
wink://api/{apiName}/schema/{schemaName}	Opgeloste componentenschema met geneste velden, types en voorbeelden
wink://api/{apiName}/operation/{key}/request	Request-georiënteerde weergave met vereiste inputs en minimaal voorbeeldpayload
wink://api/{apiName}/operation/{key}/response/{status}	Response-georiënteerde weergave voor een specifieke statuscode
wink://api/{apiName}/operation/{key}/recipe	Taakgerichte flow om die operatie correct aan te roepen

Zoektools (Snelle Referentie)

Tool	Doel	Typische Zoekvoorbeelden
api_search	Vind de live API of operatie om tegen te integreren	create affiliate, payment receipt, lookup inventory, invite manager
docs_search	Vind conceptuele documentatie / handleidingen	authentication, webhooks, wordPress

Laat query leeg om suggesties te ontvangen. Elk resultaat bevat de MCP URI die je kunt openen. Voor operatie-resultaten retourneert api_search ook gekoppelde request-, response-, schema- en recipe-URI’s zodat agents direct naar de meest bruikbare subresource kunnen springen.

Typisch Gebruikspatroon

1. Voer api_search uit met je intentie (bijv. “create affiliate” of “payment receipt”).
2. Open de geretourneerde wink://api/... URI, of volg de gekoppelde request_uri, response_uris, request_schema_uris, response_schema_uris en recipe_uri velden.
3. Gebruik docs_search voor ondersteunende concepten (authenticatie, webhooks, workflows).

AI Skills

Vooraf gebouwde agent skills gebruiken deze MCP-server als hun bron van waarheid. Skills geven je codeeragent een gestructureerde workflow om tegen Wink API’s te bouwen — in plaats van te gokken naar endpoints, leest de agent de live contracten direct van de MCP-server.

Zie AI Skills voor beschikbare skills en installatie-instructies.

Notities

• Elke geretourneerde URI kan door de agent worden geopend voor volledige inhoud.
• De wink://api boom is live en volgt de huidige upstream OpenAPI-catalogus in plaats van een gegenereerde repo-index.
• Suggesties verschijnen automatisch wanneer zoekopdrachten leeg zijn.

Wink op GitHub