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.
claude mcp add wink-channel-manager https://integrations.wink.travel/mcp/channel-manager --transport httpclaude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport httpMié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.
Végpont könyvtár
Szekció neve “Végpont könyvtár”Két hoszt szolgál ki eszközkészleteket. Az eszközszámok hozzávetőlegesek és idővel növekednek.
https://api.wink.travel — a platform
Szekció neve “https://api.wink.travel — a platform”| Végpont | Eszközök | Mit fed le |
|---|---|---|
/mcp/extranet/facilities | ~64 | Foglalható é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 | ~62 | Az ingatlan adatai és kereskedelmi feltételei: profil és tartalom, kiegészítők, lemondási szabályzatok, kedvezmények, bejelentések |
/mcp/settings | ~60 | Fió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 | ~48 | Kurá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 | ~39 | Egy é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 | ~37 | Hol é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 | ~35 | Eladható gyűjtemények építése: statikus és dinamikus listák, rangsorolt listák, mentett keresések, ingatlan összesítők |
/mcp/link-manager | ~28 | Szindikált linkgyűjtemények, tervezésük, kategóriák és címkék, valamint rövidített URL-ek |
/mcp/reference | ~24 | Csak 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 | ~18 | Foglalási és bevételi elemzések: áttekintések, vonaldiagramok, ranglisták, affiliate teljesítmény, megosztási mutatók |
/mcp/payment | ~18 | Pénzügyi műveletek: főkönyv, kifizetések és díjbecslések, foglalási pénzösszegek |
/mcp/booking-engine | ~17 | Utazó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 | ~17 | Kapcsolt 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égpont | Eszközök | Mit fed le |
|---|---|---|
/mcp/channel-manager | ~9 | Csatornakezelő, 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ál | integrations.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.
Hogyan működik az azonosítás
Szekció neve “Hogyan működik az azonosítás”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:
- Az AI kliens felfedezi az engedélyező szervert az MCP végpont
/.well-known/oauth-protected-resourcemetaadataiból. - 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.
- A kliens megnyit egy böngészőfület a
https://iam.wink.travelcímen. Bejelentkezik a Wink fiókjával, és jóváhagyja a kért jogosultságokat a hozzájárulási képernyőn. - A Wink kiad egy hozzáférési tokent, amely a fiókjához kötött és azonosítójához kapcsolódik.
- 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.
- 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.
Csatlakoztassa AI kliensét
Szekció neve “Csatlakoztassa AI kliensét”-
Győződjön meg róla, hogy a Claude Code naprakész:
Terminál npm install -g @anthropic-ai/claude-code -
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 -
A Claude Code kapcsolatba lép a szerverrel, felfedezi az engedélyező szervert, és megnyitja az alapértelmezett böngészőt.
-
Jelentkezzen be a Wink-be és hagyja jóvá a jogosultságkérést a hozzájárulási képernyőn.
-
A Claude Code megerősíti a kapcsolatot. Írja be a
/mcpparancsot, 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:
claude mcp add wink-operations https://api.wink.travel/mcp/extranet/operations --transport httpclaude mcp add wink-analytics https://api.wink.travel/mcp/analytics --transport httpCsak 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.
-
Szerkessze a Claude Desktop konfigurációs fájlt:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
- macOS:
-
Adja hozzá az MCP szerver bejegyzéseket:
claude_desktop_config.json {"mcpServers": {"wink-extranet-rates": {"type": "http","url": "https://api.wink.travel/mcp/extranet/rates"},"wink-extranet-operations": {"type": "http","url": "https://api.wink.travel/mcp/extranet/operations"}}} -
Teljesen lépjen ki és indítsa újra a Claude Desktopot (a menüsorból válassza a Kilépés opciót — az ablak bezárása nem elég).
-
A Claude Desktop minden új szerverhez megnyit egy böngészőfület. Jelentkezzen be a Wink-be és hagyja jóvá a jogosultságokat.
-
Az alsó eszköztáron a dugó ikon mindkét szervert csatlakoztatottnak mutatja.
-
Győződjön meg róla, hogy a Codex CLI telepítve van:
Terminál npm install -g @openai/codex -
Nyissa meg (vagy hozza létre) a Codex konfigurációs fájlt:
- macOS / Linux:
~/.codex/config.json - Windows:
%USERPROFILE%\.codex\config.json
- macOS / Linux:
-
Adja hozzá a Wink MCP szerver bejegyzéseket:
~/.codex/config.json {"mcpServers": {"wink-extranet-rates": {"type": "http","url": "https://api.wink.travel/mcp/extranet/rates"},"wink-extranet-operations": {"type": "http","url": "https://api.wink.travel/mcp/extranet/operations"}}} -
Indítsa el a Codexet. Első használatkor a Codex megnyit egy böngészőfület a
https://iam.wink.travelcímen. -
Jelentkezzen be a Wink-be és hagyja jóvá a kért jogosultságokat.
-
A Codex megerősíti a kapcsolatot. Futtassa a
codexparancsot, és kérje az elérhető eszközök listáját, hogy ellenőrizze a Wink szerverek aktívak-e.
Az MCP szerver támogatás elérhető a ChatGPT asztali alkalmazásban Plus, Pro, Team és Enterprise előfizetők számára.
-
Töltse le és telepítse a ChatGPT asztali alkalmazást, ha még nem tette meg.
-
Nyissa meg az alkalmazást, kattintson a profil ikonra a jobb felső sarokban, majd válassza a Beállítások menüpontot.
-
Menjen a Csatlakozók (vagy MCP szerverek az alkalmazás verziójától függően) részhez, és kattintson az Új hozzáadása gombra.
-
Adja meg egy eszközkészlet URL-jét a fenti könyvtárból, például:
https://api.wink.travel/mcp/extranet/ratesMajd kattintson a Csatlakozás gombra.
-
A ChatGPT megnyit egy böngészőfület a
https://iam.wink.travelcímen. Jelentkezzen be a Wink-be és hagyja jóvá a jogosultságokat. -
Ismételje meg a 4–5. lépéseket bármely más eszközkészlethez, amire a munkája igényt tart, például:
https://api.wink.travel/mcp/extranet/operations -
Minden eszközkészlet megjelenik a Csatlakozók listájában. Indítson új beszélgetést — a Wink eszközök automatikusan elérhetők.
-
Nyissa meg (vagy hozza létre) a Cursor MCP konfigurációs fájlt:
- macOS / Linux:
~/.cursor/mcp.json - Windows:
%USERPROFILE%\.cursor\mcp.json
- macOS / Linux:
-
Adja hozzá a Wink MCP szerver bejegyzéseket:
~/.cursor/mcp.json {"mcpServers": {"wink-extranet-rates": {"type": "http","url": "https://api.wink.travel/mcp/extranet/rates"},"wink-extranet-operations": {"type": "http","url": "https://api.wink.travel/mcp/extranet/operations"}}} -
Nyissa meg a Cursort. Menjen a Beállítások → Cursor beállítások → MCP részhez, és ellenőrizze, hogy mindkét szerver zöld státuszjelzővel jelenik meg. Ha pirosat mutatnak, kattintson a Frissítés gombra.
-
A Cursor megnyit egy böngészőfület a
https://iam.wink.travelcímen. Jelentkezzen be a Wink-be és hagyja jóvá a jogosultságokat. -
Nyisson meg egy csevegést (
Ctrl+L/Cmd+L), és kérje a Cursor-t, hogy listázza az elérhető Wink eszközöket a kapcsolat megerősítéséhez.
-
Nyissa meg (vagy hozza létre) a Windsurf MCP konfigurációs fájlt:
- macOS / Linux:
~/.codeium/windsurf/mcp_config.json - Windows:
%USERPROFILE%\.codeium\windsurf\mcp_config.json
- macOS / Linux:
-
Adja hozzá a Wink MCP szerver bejegyzéseket:
~/.codeium/windsurf/mcp_config.json {"mcpServers": {"wink-extranet-rates": {"type": "http","url": "https://api.wink.travel/mcp/extranet/rates"},"wink-extranet-operations": {"type": "http","url": "https://api.wink.travel/mcp/extranet/operations"}}} -
Teljesen indítsa újra a Windsurföt (Fájl → Kilépés, majd újraindítás).
-
Menjen a Beállítások → MCP szerverek részhez, és ellenőrizze, hogy mindkét szerver csatlakoztatva van. A Windsurf első használatkor megnyit egy böngészőfület a
https://iam.wink.travelcímen. -
Jelentkezzen be a Wink-be és hagyja jóvá a jogosultságokat. A szerverek zöldre váltanak a beállítások panelen, ha hitelesítve vannak.
A Cline egy VS Code kiterjesztés beépített MCP szerver kezelővel. Nem szükséges kézzel szerkeszteni a JSON fájlokat.
-
Telepítse a Cline-t a VS Code Marketplace-ből:
- Nyissa meg a VS Code-ot és nyomja meg a
Ctrl+Shift+X/Cmd+Shift+Xbillentyűket - Keressen rá a Cline kiterjesztésre, majd kattintson a Telepítés gombra
- Nyissa meg a VS Code-ot és nyomja meg a
-
Kattintson a Cline ikonra az Activity Bar-ban (bal oldali sáv), hogy megnyissa a Cline panelt.
-
Kattintson az MCP szerverek ikonra (dugó ikon) a Cline eszköztáron, majd válassza az MCP beállítások szerkesztése opciót.
-
A VS Code megnyitja a
cline_mcp_settings.jsonfájlt. Adja hozzá a Wink bejegyzéseket:cline_mcp_settings.json {"mcpServers": {"wink-extranet-rates": {"type": "http","url": "https://api.wink.travel/mcp/extranet/rates"},"wink-extranet-operations": {"type": "http","url": "https://api.wink.travel/mcp/extranet/operations"}}} -
Mentse el a fájlt. A Cline automatikusan újratölti, és megnyit egy böngészőfület a
https://iam.wink.travelcímen. -
Jelentkezzen be a Wink-be és hagyja jóvá a jogosultságokat. Mindkét szerver aktívként jelenik meg az MCP szerverek panelen.
Jogosultsági körök
Szekció neve “Jogosultsági körök”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.removejogosultsági körök továbbiak a MCP kapcsolat megnyitásához. Egy kliens, amely rendelkezikmcp.*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.
Hibakeresés
Szekció neve “Hibakeresés”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:
# Claude Codeclaude mcp remove wink-ratesclaude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport httpClaude 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
