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 csak az egy vagy két, a munkájához illeszkedő végponthoz csatlakoztatja, 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 Wink fiókjával, és ennyi. Nincs szükség kliens titkok kezelésére.

Egy channel manager 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 á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 költségvetésbő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 channel managert 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ál elérhetőséget, és valaki, aki affiliate céloldalakat készít, 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özök száma hozzávetőleges és idővel növekszik.

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átványosságok, 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Ár és elérhetőség: készlet áridőszakok és kvótá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ár feedek, ü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 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ó felé irányuló 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, posztok közzététele és ütemezése, poszt 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 — channel manager integrációk

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

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

VégpontEszközökMit fed le
/mcp/channel-manager~9Channel manager, 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.

A teljes utazói foglalási folyamatért csatlakoztassa a Wink Booking Engine-t a https://api.wink.travel/mcp/booking-engine végponton és egy kompatibilis fizetési tárcát. A Wink MCP hozzáadása megnyitja a böngésző bejelentkezést és a jogosultság kiválasztást; az Ön kliense ezután kezeli az autentikációt.

A Booking Engine tartalmazza az úti cél keresést, szálloda- és szobakeresést, agentic_booking_quote, agentic_booking_pay, agentic_booking_book, foglalás lekérést és bizonylatokat, amikor az ügynöki foglalás és fizetés engedélyezve van az adott környezetben. Lásd az Agentic Payments oldalt a csatlakozás beállításához, a kiválasztandó jogosultságokhoz és a kereséstől a megerősítésig tartó lépésekhez.


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

Szekció neve “Mely eszközkészletekre van szükségem?”
Ha Ön…Csatlakozzon ide
Channel manager, PMS vagy CRS integrátorintegrations.wink.travel/mcp/channel-manager — csak ez az egy
Ingatlan tartalmának kezelése/mcp/extranet/property + /mcp/extranet/facilities
Szobák és szobatípusok kezelése/mcp/extranet/facilities
Árak és elérhetőség kezelése/mcp/extranet/rates
Napi foglalások kezelése/mcp/extranet/operations
Értékesítési csatornák bővítése/mcp/extranet/distribution + /mcp/analytics
Affiliate oldalak építése/mcp/studio/curation + /mcp/studio/embeds
Link-in-bio oldalak működtetése/mcp/link-manager + /mcp/social
Utazók nevében történő foglalás/mcp/travel-agent
Pénzügyi egyeztetés/mcp/payment
Szoba foglalása AI ügynökkel/mcp/booking-engine + kompatibilis fizetési tárca — lásd az Agentic Payments oldalt
Foglalási élmény építése/mcp/booking-engine; opcionálisan /mcp/reference további keresésekhez

A Booking Engine tartalmazza az alap foglalási munkafolyamatot. Biztosítja a fiók- és testreszabás-felderítést, úti cél keresést, szálloda elérhetőséget és szobaár részleteket, bevásárlókosarakat, fizetést és utazói foglaláskezelést. Az ügynöki foglalási és fizetési eszközök is benne vannak, ha az adott környezetben engedélyezve vannak.

Város alapú szállodakereséshez használja a destination_lookup_search_suggestions eszközt az úti cél feloldásához, majd az inventory_search_city eszközt a rendelkezésre álló szállodák és árak megtalálásához. Mindkét eszköz a /mcp/booking-engine végponton van, így ehhez a folyamathoz nem szükséges Reference kapcsolat.

Adja hozzá a /mcp/reference végpontot, ha támogatott keresésekre van szüksége, mint országok, valuták és árfolyamok, támogatott nyelvek, időzónák, szélesebb földrajzi keresések, OTA besorolások vagy nyilvános ingatlanismeret. Ezek opcionális kiegészítések a foglalási folyamathoz.

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


A Wink MCP szerverek az OAuth2 Authorization Code + PKCE folyamatot használják, és támogatják a Dynamic Client Registration (RFC 7591)-t. Í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 Dynamic Client Registration 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 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 van kötve.
  6. A tokenek 3 óra után lejárnak. Az AI kliens csendben frissíti őket a háttérben, ismételt 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, mint a webes portálon az AI ügynökre.


Adjon hozzá minden eszközkészletet Claude-hoz egyéni csatlakozóként. Nincs konfigurációs fájl szerkesztése és nincs szükség alkalmazás vagy titok létrehozására.

  1. Claude-ban nyissa meg a Customize › Connectors menüt, kattintson az Add gombra, majd az Add custom connector lehetőségre.

  2. Adjon meg egy Nevet (például Wink Link manager) és az MCP szerver URL-jét a fenti könyvtárból, például:

    https://api.wink.travel/mcp/link-manager

    Kattintson a Continue gombra.

  3. Claude érzékeli a Wink bejelentkezést. Tartsa meg az Authentication: Sign in now és az OAuth client: Register automatically beállításokat, majd kattintson az Add gombra.

  4. Kattintson a Connect gombra. Megnyílik egy Wink bejelentkezési oldal a https://iam.wink.travel címen. Jelentkezzen be Wink-be és hagyja jóvá a jogosultságokat a hozzájárulási képernyőn.

  5. A csatlakozó eszközei mostantól elérhetők a beszélgetéseiben. Ismételje meg minden olyan eszközkészlethez, amire a munkájához szüksége van; mindegyik saját csatlakozó.


Amikor jóváhagyja a hozzájárulási képernyőt, látni fogja, hogy az ügynök mit 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 listáját az Authentication oldalon.

Három dolog specifikus az MCP-re:

  • Az mcp.read, mcp.write, mcp.remove jogosultsági körök továbbiaként szükségesek az 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 szakasz jogosultságát (pl. booking.read).
  • Az MCP mindig bejelentkezett felhasználóként működik. Az AI kliens az mcp.* jogosultságokat a bejelentkezésén keresztül kapja meg, soha nem egy Ön által létrehozott Alkalmazástól. Gépről gépre (client-credentials) tokenek nem nyithatják meg az MCP kapcsolatot; szerver-szerver munkához használja a REST API-t.
  • Az AI kliens csak a szükséges jogosultságokat kéri. 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 a jogosultságot megtagadtá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 már nem birtokol, és a /mcp/reference végponthoz való csatlakozás sem akadályozza meg, hogy az ottani eszköz saját jogosultságot érvényesítsen. Az engedélyezés eszközhívásonként dől el, a token és a fiók 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

Lehet, hogy a gyorsítótárazott token lejárt. Távolítsa el és 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 befolyásolja a többit. 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 történt semmi

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

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 lát, írjon be egy új üzenetet — a kliens automatikusan újra hitelesít.

Codex CLI “MCP server unreachable” hibát jelez

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

ChatGPT “Connectors” menü 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 előfizetését a Beállítások → Fiók menüben.

Cursor szerver piros / “Failed to connect”

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 Cursor-t — a konfigurációs változtatásokat nem mindig veszi észre újraindítás nélkül.

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

A Windsurf teljes újraindítást igényel (nem csak az ablak újratöltése), hogy észlelje a mcp_config.json változásait. Használja a Fájl → Kilépés menüpontot, majd indítsa újra. 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.

Cline “Add Server” opció nem látható

Az MCP szerver kezelőhöz Cline 2.0 vagy újabb verzió szükséges. Nyissa meg a VS Code Extensions panelt, keresse meg a Cline-t, és kattintson a Frissítés gombra, ha elérhető. 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