Tovább a tartalomhoz

MCP szerverek

A Wink MCP eszközei eszközkészletek formájában érhetők el — fókuszált végpontok, amelyek mindegyike egy adott munkát fed le. Az AI kliensét ahhoz az egy vagy két végponthoz csatlakoztatja, amely megfelel a munkájának, nem mindegyikhez.

Minden végpont interaktív OAuth2 bejelentkezést használ (PKCE engedélyezési kód folyamat): az AI ügynök megnyit egy böngészőfület, bejelentkezik a Wink fiókjával, és ennyi. Nincs szükség kliens titkok kezelésére.

Egy csatornakezelő integrátor egy végponthoz csatlakozik
claude mcp add wink-channel-manager https://integrations.wink.travel/mcp/channel-manager --transport http
Egy szállásadó, aki saját árait kezeli, egy másik végponthoz csatlakozik
claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http

Miért vannak az eszközök külön végpontokon

Szekció neve “Miért vannak az eszközök külön végpontokon”

A Wink körülbelül 500 eszközt tesz elérhetővé. Az összes egyszerre való átadása egy ügynöknek technikailag lehetséges — de rossz ötlet.

Az eszközdefiníciók kontextust igényelnek. Minden eszköz, amit egy MCP szerver hirdet, betöltődik a modell kontextusablakába, mielőtt bármilyen munkát végezne, a leírásával és a teljes paraméter sémával együtt. Ötszáz ilyen eszköz jelentős részt fogyaszt el abból a keretből, amire a tényleges feladatának szüksége van, minden egyes kérésnél.

A választás minősége romlik, ahogy a lista nő. Egy ügynök, amely 500 hasonló nevű eszköz közül választ, rosszabb döntéseket hoz, mint egy, amely 40 közül választ. Ha egy csatornakezelőt integrál, körülbelül húsz eszköz releváns számára; a többi 480 zaj, ami megnehezíti a megfelelő eszköz megtalálását.

A munka valóban szétválasztható. Valaki, aki egy PMS-ből szinkronizálja a rendelkezésre állást, és valaki, aki affiliate céloldalakat szerkeszt, szinte semmilyen eszközt nem oszt meg. A munkák szerinti szétválasztás azt jelenti, hogy minden kapcsolat egy adott munka szókincsét hordozza.


Két hoszt szolgál ki eszközkészleteket. Az eszközszámok hozzávetőlegesek és idővel növekednek.

VégpontEszközökMit fed le
/mcp/extranet/facilities~64Foglalható és helyszíni készlet: vendégszobák és szobatípusok, spa-k, éttermek, tárgyalók, programok, látnivalók, helyszínek, egyéb eladható tételek
/mcp/extranet/property~62Az ingatlan adatai és kereskedelmi feltételei: profil és tartalom, kiegészítők, lemondási szabályzatok, kedvezmények, bejelentések
/mcp/settings~60Fiókadminisztráció: kezelő entitás profilja és arculata, menedzserek és jogosultságaik, testreszabás, webhookok, értesítési beállítások
/mcp/studio/embeds~48Kurált készlet közzététele: widgetek, rácsok és rangsorolt rácsok, kártyák, térképek, mélyhivatkozások készlethez és beszállítói oldalakhoz
/mcp/extranet/rates~44Árak és elérhetőség: készlet áridőszakok és allokációk, ártervek, főárak, speciális és promóciós árak
/mcp/extranet/operations~39Egy élő ingatlan működtetése: foglalások és életciklusuk, vendégértékelések és válaszok, naptárfolyamok, ütemezett feladatok
/mcp/extranet/distribution~37Hol értékesítik a készletet: értékesítési csatornák és ár módosítók, affiliate és beszállítói kapcsolatok kérései, regisztráció, lead gyűjtés
/mcp/studio/curation~35Eladható gyűjtemények építése: statikus és dinamikus listák, rangsorolt listák, mentett keresések, ingatlan összesítők
/mcp/link-manager~28Szindikált linkgyűjtemények, tervezésük, kategóriák és címkék, valamint rövidített URL-ek
/mcp/reference~24Csak olvasható keresőadatok: országok, valuták és árfolyamok, nyelvek, időzónák, földrajzi keresések, IP földrajzi helymeghatározás
/mcp/analytics~18Foglalási és bevételi elemzések: áttekintések, vonaldiagramok, ranglisták, affiliate teljesítmény, megosztási mutatók
/mcp/payment~18Pénzügyi műveletek: főkönyv, kifizetések és díjbecslések, foglalási pénzösszegek
/mcp/booking-engine~17Utazóbarát vásárlási útvonal: keresés és lekérdezés, bevásárlókosár és fizetés, kívánságlisták, kampány testreszabás
/mcp/social~17Kapcsolt közösségi fiókok, bejegyzések közzététele és ütemezése, bejegyzés elemzések olvasása
/mcp/travel-agent~8Ügynök által segített foglalások utazók nevében, és ügynöki jelentések

https://integrations.wink.travel — csatornakezelő integrációk

Szekció neve “https://integrations.wink.travel — csatornakezelő integrációk”

Egy végpont, mert ez a hoszt egy munkára létezik.

VégpontEszközökMit fed le
/mcp/channel-manager~9Csatornakezelő, PMS vagy CRS integráció csatlakoztatása és ellenőrzése

Minden végpont tartalmaz egy ping eszközt is, így megerősítheti, hogy a kapcsolat élő, mielőtt valódi munkát kérne.


Mely eszközkészletekre van szükségem?

Szekció neve “Mely eszközkészletekre van szükségem?”
Ha Ön…Csatlakozzon ide
Csatornakezelőt, PMS-t vagy CRS-t integrálintegrations.wink.travel/mcp/channel-manager — csak ehhez
Ingatlan tartalmát kezeli/mcp/extranet/property + /mcp/extranet/facilities
Szobákat és szobatípusokat kezel/mcp/extranet/facilities
Árakat és elérhetőséget kezel/mcp/extranet/rates
Napi foglalásokat kezel/mcp/extranet/operations
Értékesítést növel/mcp/extranet/distribution + /mcp/analytics
Affiliate oldalakat épít/mcp/studio/curation + /mcp/studio/embeds
Link-in-bio oldalakat futtat/mcp/link-manager + /mcp/social
Utazók nevében foglal/mcp/travel-agent
Pénzügyi egyeztetést végez/mcp/payment
Foglalási élményt épít/mcp/booking-engine + /mcp/reference

Kezdje eggyel. Adjon hozzá egy másikat, amikor olyat kér, amit az előző nem tud — minden kapcsolat független, és egy hozzáadása soha nem befolyásolja a többit.


A Wink MCP szerverek az OAuth2 engedélyezési kód + PKCE folyamatot használják, és támogatják a Dinamikus kliensregisztrációt (RFC 7591). Így történik az első csatlakozás:

  1. Az AI kliens felfedezi az engedélyező szervert az MCP végpont /.well-known/oauth-protected-resource metaadataiból.
  2. A kliens önmagát regisztrálja a Dinamikus kliensregisztráció segítségével — nincs szükség kézi alkalmazásbeállításra.
  3. A kliens megnyit egy böngészőfület a https://iam.wink.travel címen. Bejelentkezik a Wink fiókjával, és jóváhagyja a kért jogosultságokat a hozzájárulási képernyőn.
  4. A Wink kiad egy hozzáférési tokent, amely a fiókjához kötött és azonosítójához kapcsolódik.
  5. Az AI kliens minden MCP kéréshez csatolja a tokent. Minden eszköz eredménye automatikusan a kezelő entitásához kötött.
  6. A tokenek 3 óra után lejárnak. Az AI kliens csendben frissíti őket a háttérben, újabb kérés nélkül.

Minden eszközhívás az ön személyazonossága alatt fut — ugyanazok az ACL szabályok érvényesek, amelyek a webes portált védik az AI ügynökre is.


  1. Győződjön meg róla, hogy a Claude Code naprakész:

    Terminál
    npm install -g @anthropic-ai/claude-code
  2. Válasszon egy eszközkészletet a fenti könyvtárból és adja hozzá. Például árak és elérhetőség:

    Terminál
    claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http
  3. A Claude Code kapcsolatba lép a szerverrel, felfedezi az engedélyező szervert, és megnyitja az alapértelmezett böngészőt.

  4. Jelentkezzen be a Wink-be és hagyja jóvá a jogosultságkérést a hozzájárulási képernyőn.

  5. A Claude Code megerősíti a kapcsolatot. Írja be a /mcp parancsot, hogy ellenőrizze, megjelenik-e a szerver és betöltődtek-e az eszközök.

Adjon hozzá annyi eszközkészletet, amennyire a munkája igényli — mindegyik külön szerver bejegyzés a saját nevével:

Terminál
claude mcp add wink-operations https://api.wink.travel/mcp/extranet/operations --transport http
claude mcp add wink-analytics https://api.wink.travel/mcp/analytics --transport http

Csak egyszer kell bejelentkeznie. Az első böngészős jóváhagyás után a Claude Code újra felhasználja a Wink munkamenetét további Wink végpontokhoz.


Amikor jóváhagyja a hozzájárulási képernyőt, látni fogja, hogy az ügynök milyen jogosultságokat kér. Az MCP kliensek ugyanazt a jogosultsági szókincset használják, mint a platform többi része — lásd a teljes jogosultsági körök hivatkozását az Azonosítás oldalon.

Két dolog specifikus az MCP-re:

  • Az mcp.read, mcp.write, mcp.remove jogosultsági körök továbbiak a MCP kapcsolat megnyitásához. Egy kliens, amely rendelkezik mcp.* jogosultsággal, bármely Wink MCP végponthoz hozzáfér, de minden eszköz, amit meghív, továbbra is érvényesíti a végpont szekció jogosultságát (pl. booking.read).
  • Az AI kliens csak azokat a jogosultságokat kéri, amelyekre szüksége van. Egyéni jogosultságokat megtagadhat a hozzájárulási képernyőn — az ilyen jogosultságot igénylő eszközök hibát adnak vissza, ha meghívják.

Az eszközkészletek nem változtatnak ezen. Az, hogy melyik végponthoz csatlakozik, eldönti, mely eszközök vannak listázva, nem azt, hogy mit engedélyeznek. A /mcp/payment végponthoz való csatlakozás nem ad pénzügyi jogosultságot, amit korábban nem kapott, és a /mcp/reference végponthoz való csatlakozás sem akadályozza meg, hogy az ottani eszköz a saját jogosultságát érvényesítse. Az engedélyezés eszközhívásonként történik, az ön tokenje és fiókja jogosultságai alapján.


Nem nyílik meg böngészőfül

Lehet, hogy az AI kliens még nem támogatja az interaktív PKCE folyamatot. Ellenőrizze, hogy a legfrissebb verziót használja:

  • Claude Code: npm install -g @anthropic-ai/claude-code
  • Codex CLI: npm install -g @openai/codex
  • Claude Desktop / ChatGPT asztali: frissítse az alkalmazás beépített frissítőjével

401 Unauthorized bejelentkezés után

A gyorsítótárazott token lejárt lehet. Távolítsa el, majd adja hozzá újra a szervert, hogy friss bejelentkezést indítson:

Terminál
# Claude Code
claude mcp remove wink-rates
claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http

Claude Desktop és ChatGPT esetén távolítsa el a szerver bejegyzést a beállításokból, indítsa újra az alkalmazást, majd adja hozzá újra.

403 Forbidden egy adott eszköz hívásakor

Az eszköz olyan jogosultságot igényel, amit nem hagyott jóvá a hozzájárulási képernyőn, vagy olyan jogosultságot, amivel a fiókja nem rendelkezik. Csatlakoztassa újra a szervert — a hozzájárulási képernyő újra megjelenik, és jóváhagyhatja a hiányzó jogosultságot. Ha még mindig nem működik, az eszköz olyan fiókjogosultságot igényel, amivel nem rendelkezik; más eszközkészlethez való csatlakozás nem segít, mert az eszközkészletek nem adnak jogosultságokat.

Az általam keresett eszköz nincs a listában

Valószínűleg olyan eszközkészlethez csatlakozott, amely nem fedi le azt a munkát. Ellenőrizze a végpont könyvtárat, és adja hozzá a megfelelő eszközkészletet — a kapcsolatok függetlenek, így egy hozzáadása nem változtat a többin. Ha nem biztos benne, melyik tartalmazza, ideiglenesen csatlakozzon a https://api.wink.travel/mcp végponthoz, keresse meg az eszközt, majd nézze meg, melyik eszközkészlet listázza.

404 Not Found egy eszközkészlet végpontján

Ellenőrizze a pontos útvonalat — a beágyazott eszközkészletek két szegmensből állnak (/mcp/extranet/rates, nem /mcp/extranet-rates), a laposak egyből (/mcp/link-manager). Vegye figyelembe, hogy egy nem hitelesített kérés bármely /mcp alatti útvonalra 401 választ ad, nem 404-et, így egy 401 önmagában nem jelzi, hogy létezik-e a végpont.

Csatlakoztam az api.wink.travel/mcp/channel-manager végponthoz, de nem kaptam semmit

Ez a végpont nem létezik. A csatornakezelő integráció csak a https://integrations.wink.travel/mcp/channel-manager végponton érhető el. Ha kézzel is szeretné kezelni egy ingatlan árait, az egy külön munka, külön végponton — lásd /mcp/extranet/rates.

A szerver megjelenik, de az eszközhívások “account not found” hibát adnak

Olyan Wink fiókba van bejelentkezve, amelyhez nincs kezelő entitás rendelve. Látogasson el a Wink Portálra, és győződjön meg róla, hogy a fiókja be van állítva az MCP szerver használata előtt.

A token lejár a munkamenet közben

A tokenek 3 óráig érvényesek. A Claude Code és Claude Desktop csendben frissíti a tokeneket megszakítás nélkül. Ha hosszú tétlenség után hitelesítési hibákat tapasztal, írjon be egy új üzenetet — a kliens automatikusan újra hitelesít.

A Codex CLI “MCP server unreachable” hibát jelez

Ellenőrizze, hogy a ~/.codex/config.json érvényes JSON (nincsenek felesleges vesszők), és hogy a "type": "http" beállítás megvan. A Codex távoli szerverekhez HTTP transportot igényel; a stdio transport csak helyi binárisokhoz használható.

A ChatGPT “Csatlakozók” menüje hiányzik

Az MCP támogatáshoz a ChatGPT asztali alkalmazás 1.2024.352 vagy újabb verziója szükséges, valamint aktív Plus, Pro, Team vagy Enterprise előfizetés. Frissítse az alkalmazást, és ellenőrizze a tervét a Beállítások → Fiók menüpontban.

A Cursor szerver piros, vagy “Csatlakozás sikertelen” üzenetet mutat

Ellenőrizze, hogy a ~/.cursor/mcp.json érvényes JSON és tartalmazza a "type": "http" beállítást. Ezután menjen a Beállítások → Cursor beállítások → MCP részhez, és kattintson a Frissítés gombra. Ha a hiba továbbra is fennáll, indítsa újra teljesen a Cursort — a konfigurációs változtatásokat nem mindig veszi észre újraindítás nélkül.

A Windsurf MCP szerverek nem jelennek meg a beállításokban

A Windsurf teljes újraindítást igényel (Fájl → Kilépés), nem elég csak az ablakot bezárni, hogy észlelje a mcp_config.json változásait. Indítsa újra az alkalmazást. Ha a szerverek még mindig nem jelennek meg, ellenőrizze, hogy Windsurf 1.4+ verziót használ a Súgó → A Windsurf névjegye menüpontban.

A Cline “Szerver hozzáadása” opciója nem látható

Az MCP szerver kezelőhöz Cline 2.0 vagy újabb verzió szükséges. Nyissa meg a VS Code Kiterjesztések panelt, keresse meg a Cline-t, és ha elérhető frissítés, kattintson a Frissítés gombra. A frissítés után töltse újra a VS Code-ot (Ctrl+Shift+P → “Developer: Reload Window”).


Wink Portál megnyitása Wink a GitHubon