MCP-server

Översikt

Den hostade Wink MCP-servern finns tillgänglig på:

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

Peka kompatibla AI-klienter (VS Code, Cursor, andra som implementerar MCP HTTP-transport) mot denna endpoint för att låta dem:

• Bläddra i produkt- och plattformsdokumentation (wink://docs/...)
• Bläddra i live OpenAPI-specifikationer och dokumentation för operationer (wink://api/...)
• Utföra lättviktig semantisk / nyckelordssökning över dokument och live-API:er

Transport

Använd den primära strömningsbara HTTP-endpointen:

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

Om din klient endast stödjer SSE, använd:

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

Claude Code

Officiell dokumentation: Connect Claude Code to tools via MCP

Anthropic rekommenderar den fjärrstyrda HTTP-transporten för molnhostade MCP-servrar:

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

Inuti Claude Code, kör /mcp för att inspektera serverstatus. Om du vill dela servern med hela repot, lägg till --scope project så att Claude Code skriver konfigurationen till .mcp.json.

Codex

Officiell dokumentation: Docs MCP quickstart for Codex

OpenAI dokumenterar MCP-inställning via Codex CLI och noterar att konfigurationen delas med IDE-tillägget:

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 Installation: Lägg till fjärrserver via MCP-inställningar.

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

VS Code

Officiell dokumentation: https://code.visualstudio.com/docs/copilot/customization/mcp-servers Minimal fjärrkonfiguration (användar- eller arbetsytans mcp.json):

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

Tips:

• Använd Kommandopaletten: “MCP: List Servers” för att bekräfta anslutning och bläddra i verktyg.
• Verktygsvalet låter dig aktivera/inaktivera api_search och docs_search.
• Lägg till kontext: Chattvy → Lägg till kontext → MCP-resurser för att bifoga dokumentsidor.

Kärnresurs-URI:er

URI	Beskrivning
wink://docs	Dokumentationsindex (grupperat efter kategori)
wink://docs/{path}	Specifik dokumentationsartikel (Markdown / MDX)
wink://api	Live OpenAPI-katalog upptäckt från Winks swagger-konfiguration
wink://api/{apiName}	Kompakt API-sammanfattning med autentisering, taggar, headers och exempeloperationer
wink://api/{apiName}/operations	Fullständig operationslista grupperad efter tagg
wink://api/{apiName}/operation/{key}	Detaljerad information om enskild operation (parametrar, request body, svar)
wink://api/{apiName}/schema/{schemaName}	Uppslagen komponent-schema med nästlade fält, typer och exempel
wink://api/{apiName}/operation/{key}/request	Request-fokuserad vy med obligatoriska indata och minimal exempelpayload
wink://api/{apiName}/operation/{key}/response/{status}	Svarsfokuserad vy för en specifik statuskod
wink://api/{apiName}/operation/{key}/recipe	Uppgiftsorienterat flöde för att anropa den operationen korrekt

Sökningsverktyg (Snabbreferens)

Verktyg	Syfte	Typiska sökexempel
api_search	Hitta live-API eller operation att integrera mot	create affiliate, payment receipt, lookup inventory, invite manager
docs_search	Hitta konceptuella dokument / guider	authentication, webhooks, wordPress

Lämna query tom för att få förslag. Varje resultat inkluderar MCP-URI som du kan öppna. För operationsträffar returnerar api_search även länkade request-, response-, schema- och recipe-URI:er så att agenter kan hoppa direkt till den mest användbara delresursen.

Typiskt användningsmönster

1. Kör api_search med din avsikt (t.ex. “create affiliate” eller “payment receipt”).
2. Öppna den returnerade wink://api/... URI:n, eller följ dess länkade request_uri, response_uris, request_schema_uris, response_schema_uris och recipe_uri fält.
3. Använd docs_search för stödjande koncept (autentisering, webhooks, arbetsflöden).

AI-färdigheter

Förbyggda agentfärdigheter använder denna MCP-server som sin sanningkälla. Färdigheter ger din kodningsagent ett strukturerat arbetsflöde för att bygga mot Wink-API:er — istället för att gissa endpoints läser agenten de live-kontrakten direkt från MCP-servern.

Se AI Skills för tillgängliga färdigheter och installationsinstruktioner.

Noteringar

• Varje returnerad URI kan öppnas av agenten för fullständigt innehåll.
• wink://api-trädet är live och följer den aktuella upstream OpenAPI-katalogen istället för ett genererat repo-index.
• Förslag visas automatiskt när sökfrågor är tomma.

Wink på GitHub