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.
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 á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.
Végpont könyvtár
Szekció neve “Végpont könyvtár”Két hoszt szolgál ki eszközkészleteket. Az eszközök száma hozzávetőleges és idővel növekszik.
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átványosságok, 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 | Á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 | ~39 | Egy é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 | ~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 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ó 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 | ~17 | Kapcsolt 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égpont | Eszközök | Mit fed le |
|---|---|---|
/mcp/channel-manager | ~9 | Channel 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.
Ügynöki fizetések
Szekció neve “Ügynöki fizetések”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átor | integrations.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.
Hogyan működik az autentikáció
Szekció neve “Hogyan működik az autentikáció”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:
- 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 Dynamic Client Registration 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 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 van kötve.
- 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.
Csatlakoztassa AI kliensét
Szekció neve “Csatlakoztassa AI kliensét”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.
-
Claude-ban nyissa meg a Customize › Connectors menüt, kattintson az Add gombra, majd az Add custom connector lehetőségre.
-
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-managerKattintson a Continue gombra.
-
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.
-
Kattintson a Connect gombra. Megnyílik egy Wink bejelentkezési oldal a
https://iam.wink.travelcímen. Jelentkezzen be Wink-be és hagyja jóvá a jogosultságokat a hozzájárulási képernyőn. -
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ó.
-
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 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ájához szüksége van — mindegyik külön szerver bejegyzés saját névvel:
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 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üsorban a Kilépés használatával — az ablak bezárása nem elég).
-
A Claude Desktop minden új szerverhez megnyit egy böngészőfület. Jelentkezzen be 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 Codex-et. Első használatkor a Codex megnyit egy böngészőfület a
https://iam.wink.travelcímen. -
Jelentkezzen be 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üt.
-
Menjen a Csatlakozók (vagy MCP szerverek az alkalmazás verziójától függően) részhez, és kattintson az Add 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/ratesEzután kattintson a Connect gombra.
-
A ChatGPT megnyit egy böngészőfület a
https://iam.wink.travelcímen. Jelentkezzen be Wink-be és hagyja jóvá a jogosultságokat. -
Ismételje meg a 4–5. lépéseket minden olyan eszközkészlethez, amire a munkájához szüksége van, 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 Cursor-t. 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 mutat, kattintson a Frissítés gombra.
-
A Cursor megnyit egy böngészőfület a
https://iam.wink.travelcímen. Jelentkezzen be Wink-be és hagyja jóvá a jogosultságokat. -
Nyisson meg egy beszélgetést (
Ctrl+L/Cmd+L), és kérje meg 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 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 JSON-t szerkeszteni.
-
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 és 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 lehetőséget.
-
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 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 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.removejogosultsági körök továbbiaként szükségesek az 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 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.
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
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:
# 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 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
