Servidor MCP

Visió general

El servidor MCP allotjat de Wink està disponible a:

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

Apunta clients d’IA compatibles (VS Code, Cursor, altres que implementin el transport HTTP MCP) a aquest punt final per permetre’ls:

Navegar per la documentació de productes i plataforma (wink://docs/...)
Navegar per les especificacions OpenAPI en viu i la documentació d’operacions (wink://api/...)
Realitzar cerques semàntiques lleugeres / per paraules clau sobre la documentació i les API en viu

Transport

Utilitza el punt final HTTP principal i transmissible:

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

Si el teu client només suporta SSE, utilitza:

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

Claude Code

Documentació oficial: Connecta Claude Code a eines via MCP

Anthropic recomana el transport HTTP remot per a servidors MCP allotjats al núvol:

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

Dins de Claude Code, executa /mcp per inspeccionar l’estat del servidor. Si vols compartir el servidor amb tot el repositori, afegeix --scope project perquè Claude Code escrigui la configuració a .mcp.json.

Codex

Documentació oficial: Docs MCP quickstart per a Codex

OpenAI documenta la configuració MCP a través del CLI de Codex, i indica que la configuració es comparteix amb l’extensió IDE:

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

Cursor

Docs MCP de Cursor: https://cursor.com/docs/context/mcp Configuració: Afegeix servidor remot via configuració MCP.

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

VS Code

Documentació oficial: https://code.visualstudio.com/docs/copilot/customization/mcp-servers Configuració remota mínima (usuari o espai de treball mcp.json):

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

Consells:

Utilitza la Command Palette: “MCP: List Servers” per confirmar la connexió i navegar per les eines.
El selector d’eines et permet activar/desactivar api_search i docs_search.
Afegeix context: Vista de xat → Afegeix context → Recursos MCP per adjuntar pàgines de documentació.

URIs principals de recursos

URI	Descripció
`wink://docs`	Índex de documentació (agrupat per categoria)
`wink://docs/{path}`	Article de documentació específic (Markdown / MDX)
`wink://api`	Catàleg OpenAPI en viu descobert a partir de la configuració swagger de Wink
`wink://api/{apiName}`	Resum compacte de l’API amb autenticació, etiquetes, capçaleres i operacions d’exemple
`wink://api/{apiName}/operations`	Llista completa d’operacions agrupades per etiqueta
`wink://api/{apiName}/operation/{key}`	Detall individual d’operació (paràmetres, cos de la sol·licitud, respostes)
`wink://api/{apiName}/schema/{schemaName}`	Esquema de component resolt amb camps anidats, tipus i exemples
`wink://api/{apiName}/operation/{key}/request`	Vista centrada en la sol·licitud amb entrades requerides i càrrega d’exemple mínima
`wink://api/{apiName}/operation/{key}/response/{status}`	Vista centrada en la resposta per a un codi d’estat específic
`wink://api/{apiName}/operation/{key}/recipe`	Flux orientat a tasques per cridar correctament aquesta operació

Eines de cerca (referència ràpida)

Eina	Propòsit	Exemples típics de consulta
`api_search`	Trobar l’API o operació en viu per integrar	`create affiliate`, `payment receipt`, `lookup inventory`, `invite manager`
`docs_search`	Trobar documentació conceptual / guies	`authentication`, `webhooks`, `wordPress`

Deixa query buit per rebre suggeriments. Cada resultat inclou la URI MCP que pots obrir. Per a coincidències d’operacions, api_search també retorna URIs vinculades de sol·licitud, resposta, esquema i recepta perquè els agents puguin saltar directament al subrecurs més útil.

Patró d’ús típic

Executa api_search amb la teva intenció (per exemple “create affiliate” o “payment receipt”).
Obre la URI retornada wink://api/..., o segueix els camps vinculats request_uri, response_uris, request_schema_uris, response_schema_uris i recipe_uri.
Utilitza docs_search per a conceptes de suport (autenticació, webhooks, fluxos de treball).

Habilitats d’IA

Les habilitats d’agent preconstruïdes utilitzen aquest servidor MCP com a font de veritat. Les habilitats proporcionen al teu agent de programació un flux de treball estructurat per construir sobre les API de Wink — en lloc d’endevinar punts finals, l’agent llegeix els contractes en viu directament des del servidor MCP.

Consulta AI Skills per a habilitats disponibles i instruccions d’instal·lació.

Notes

Cada URI retornada pot ser oberta per l’agent per obtenir el contingut complet.
L’arbre wink://api és en viu i segueix el catàleg OpenAPI ascendent actual en lloc d’un índex generat del repositori.
Les suggerències apareixen automàticament quan les consultes estan buides.

Wink a GitHub