MCP szerver

Áttekintés

A hosztolt Wink MCP szerver elérhető itt:

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

Irányítsd a kompatibilis AI klienseket (VS Code, Cursor, mások, amelyek MCP HTTP transportot valósítanak meg) erre a végpontra, hogy:

• Böngészhessék a termék- és platformdokumentációkat (wink://docs/...)
• Böngészhessék az élő OpenAPI specifikációkat és műveleti dokumentációkat (wink://api/...)
• Könnyű szemantikus / kulcsszavas keresést végezzenek a dokumentációk és élő API-k között

Transport

Használd az elsődleges streamelhető HTTP végpontot:

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

Ha az ügyfeled csak SSE-t támogat, használd:

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

Claude Code

Hivatalos dokumentáció: Csatlakoztasd a Claude Code-ot eszközökhöz MCP-n keresztül

Az Anthropic a távoli HTTP transportot ajánlja a felhőben hosztolt MCP szerverekhez:

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

A Claude Code-ban futtasd a /mcp parancsot a szerver állapotának megtekintéséhez. Ha az egész repóval meg akarod osztani a szervert, add hozzá a --scope project opciót, így a Claude Code a konfigurációt a .mcp.json fájlba írja.

Codex

Hivatalos dokumentáció: Docs MCP gyorsindítás Codex-hez

Az OpenAI a Codex CLI-n keresztül dokumentálja az MCP beállítást, és megjegyzi, hogy a konfiguráció megosztott az IDE kiterjesztéssel:

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

Cursor

Cursor MCP dokumentáció: https://cursor.com/docs/context/mcp Beállítás: Távoli szerver hozzáadása az MCP beállításokban.

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

VS Code

Hivatalos dokumentáció: https://code.visualstudio.com/docs/copilot/customization/mcp-servers Minimális távoli konfiguráció (felhasználói vagy munkaterületi mcp.json):

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

Tippek:

• Használd a Parancspalettát: „MCP: List Servers” a kapcsolat megerősítéséhez és az eszközök böngészéséhez.
• Az eszközválasztóval engedélyezheted/tilthatod az api_search és docs_search funkciókat.
• Kontextus hozzáadása: Csevegő nézet → Kontextus hozzáadása → MCP erőforrások a dokumentációs oldalak csatolásához.

Alapvető erőforrás URI-k

URI	Leírás
wink://docs	Dokumentáció index (kategóriák szerint csoportosítva)
wink://docs/{path}	Egy adott dokumentációs cikk (Markdown / MDX)
wink://api	Élő OpenAPI katalógus, amely a Wink swagger konfigurációból származik
wink://api/{apiName}	Kompakt API összefoglaló hitelesítéssel, címkékkel, fejlécekkel és mintaműveletekkel
wink://api/{apiName}/operations	Teljes műveleti lista címkék szerint csoportosítva
wink://api/{apiName}/operation/{key}	Egyedi művelet részletei (paraméterek, kérés törzse, válaszok)
wink://api/{apiName}/schema/{schemaName}	Feloldott komponens séma beágyazott mezőkkel, típusokkal és példákkal
wink://api/{apiName}/operation/{key}/request	Kérés-központú nézet a szükséges bemenetekkel és minimális példa payloaddal
wink://api/{apiName}/operation/{key}/response/{status}	Válasz-központú nézet egy adott státuszkódhoz
wink://api/{apiName}/operation/{key}/recipe	Feladatorientált folyamat a művelet helyes meghívásához

Keresőeszközök (Gyors referencia)

Eszköz	Cél	Tipikus lekérdezési példák
api_search	Megtalálni az élő API-t vagy műveletet az integrációhoz	create affiliate, payment receipt, lookup inventory, invite manager
docs_search	Megtalálni koncepcionális dokumentációkat / útmutatókat	authentication, webhooks, wordPress

Hagyd üresen a query mezőt, hogy javaslatokat kapj. Minden eredmény tartalmazza az MCP URI-t, amit megnyithatsz. Műveleti találatok esetén az api_search visszaadja a kapcsolódó kérés, válasz, séma és recept URI-kat is, így az ügynökök közvetlenül a legfontosabb al-erőforrásokra ugorhatnak.

Tipikus használati minta

1. Futtasd az api_search-t a szándékoddal (pl. “create affiliate” vagy “payment receipt”).
2. Nyisd meg a visszakapott wink://api/... URI-t, vagy kövesd a hozzá kapcsolódó request_uri, response_uris, request_schema_uris, response_schema_uris és recipe_uri mezőket.
3. Használd a docs_search-t a támogató fogalmakhoz (hitelesítés, webhookok, munkafolyamatok).

AI képességek

Az előre elkészített ügynöki képességek ezt az MCP szervert használják igazságforrásként. A képességek strukturált munkafolyamatot adnak a kódoló ügynöködnek a Wink API-k használatához — ahelyett, hogy találgatna a végpontokat illetően, az ügynök közvetlenül az MCP szerverről olvassa az élő szerződéseket.

Lásd az AI Skills oldalt a rendelkezésre álló képességekért és telepítési útmutatókért.

Megjegyzések

• Minden visszakapott URI megnyitható az ügynök által a teljes tartalom eléréséhez.
• A wink://api fa élő, és a jelenlegi upstream OpenAPI katalógust követi, nem egy generált repó indexet.
• Javaslatok automatikusan megjelennek, ha a lekérdezés üres.

Wink a GitHubon