MCP serveriai
Wink MCP įrankiai skelbiami kaip įrankių rinkiniai – specializuoti galiniai taškai, kiekvienas apimantis vieną užduotį. Jūs prijungiate savo AI klientą prie vieno ar dviejų, kurie atitinka jūsų darbą, o ne prie visų.
Kiekvienas galinis taškas naudoja interaktyvų OAuth2 prisijungimą (PKCE autorizacijos kodo srautas): jūsų AI agentas atidaro naršyklės skirtuką, jūs prisijungiate su savo Wink paskyra, ir viskas. Nereikia valdyti kliento slaptumo.
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 httpKodėl įrankiai padalinti į galinius taškus
Section titled “Kodėl įrankiai padalinti į galinius taškus”Wink siūlo apie 500 įrankių. Pateikti visus vienu metu agentui techniškai įmanoma – bet tai bloga idėja.
Įrankių apibrėžimai kainuoja kontekstą. Kiekvienas MCP serverio reklamuojamas įrankis įkeliamas į modelio konteksto langą prieš atliekant bet kokį darbą, kartu su aprašymu ir pilnu parametrų schemu. Penki šimtai tokių įrankių sunaudoja didelę dalį biudžeto, kurio reikia jūsų užduočiai, kiekviename užklausoje.
Pasirinkimo kokybė mažėja didėjant sąrašui. Agentas, renkantis iš 500 panašiai pavadintų įrankių, priima prastesnius sprendimus nei tas, kuris renkasi iš 40. Jei integruojate kanalo valdytoją, apie dvidešimt įrankių jums aktualūs; likę 480 yra triukšmas, kuris apsunkina tinkamo įrankio radimą.
Darbas iš tiesų yra atskiriamas. Kas nors, sinchronizuojantis prieinamumą iš PMS, ir kas nors, kuruojantis filialų nukreipimo puslapius, beveik nesidalija įrankiais. Darbo padalijimas reiškia, kad kiekvienas ryšys turi vienos užduoties žodyną.
Galinių taškų katalogas
Section titled “Galinių taškų katalogas”Du serveriai teikia įrankių rinkinius. Įrankių skaičius apytikris ir laikui bėgant didėja.
https://api.wink.travel — platforma
Section titled “https://api.wink.travel — platforma”| Galinis taškas | Įrankiai | Apima |
|---|---|---|
/mcp/extranet/facilities | ~64 | Rezervuojamas ir vietoje esantis inventorius: svečių kambariai ir kambarių tipai, SPA, restoranai, susitikimų kambariai, veiklos, lankytinos vietos, kitos parduodamos prekės |
/mcp/extranet/property | ~62 | Objekto įrašas ir jo komercinės sąlygos: profilis ir turinys, priedai, atšaukimo taisyklės, privilegijos, pranešimai |
/mcp/settings | ~60 | Paskyros administravimas: valdymo subjekto profilis ir prekės ženklas, vadybininkai ir jų teisės, pritaikymas, webhooks, pranešimų nustatymai |
/mcp/studio/embeds | ~48 | Kuriamo inventoriaus publikavimas: valdikliai, tinklai ir reitinguoti tinklai, kortelės, žemėlapiai, gilūs nuorodų saitai į inventorių ir tiekėjų puslapius |
/mcp/extranet/rates | ~44 | Kainos ir prieinamumas: inventoriaus kainų laikotarpiai ir kvotos, kainų planai, pagrindinės kainos, specialios ir reklaminės kainos |
/mcp/extranet/operations | ~39 | Veikiančio objekto valdymas: rezervacijos ir jų gyvavimo ciklas, svečių atsiliepimai ir atsakymai, kalendoriaus srautai, suplanuotos užduotys |
/mcp/extranet/distribution | ~37 | Kur parduodamas inventorius: pardavimo kanalai ir kainų modifikatoriai, filialų ir tiekėjų santykių užklausos, registracija, potencialių klientų surinkimas |
/mcp/studio/curation | ~35 | Prekybinių kolekcijų kūrimas: statiniai ir dinaminiai sąrašai, reitinguoti sąrašai, išsaugotos paieškos, objekto agregatai |
/mcp/link-manager | ~28 | Sindikuotų nuorodų kolekcijos, jų dizainas, kategorijos ir žymos, taip pat sutrumpinti URL |
/mcp/reference | ~24 | Tik skaitymui skirti duomenys: šalys, valiutos ir valiutų kursai, kalbos, laiko juostos, geografiniai paieškos duomenys, IP geolokacija |
/mcp/analytics | ~18 | Rezervacijų ir pajamų analizė: apžvalgos, linijiniai grafikai, lyderių lentelės, filialų veiklos rodikliai, dalijimosi metrika |
/mcp/payment | ~18 | Finansinės operacijos: apskaita, išmokėjimai ir mokesčių įvertinimai, rezervacijų lėšų agregatai |
/mcp/booking-engine | ~17 | Keliautojui skirtas pirkimo kelias: paieška ir paieškos duomenys, pirkinių krepšelis ir atsiskaitymas, norų sąrašai, kampanijų pritaikymas |
/mcp/social | ~17 | Prijungtos socialinės paskyros, įrašų publikavimas ir planavimas, įrašų analizė |
/mcp/travel-agent | ~8 | Agentų vykdomos rezervacijos keliautojų vardu ir agentų ataskaitos |
https://integrations.wink.travel — kanalo valdytojo integracijos
Section titled “https://integrations.wink.travel — kanalo valdytojo integracijos”Vienas galinis taškas, nes šis serveris skirtas vienai užduočiai.
| Galinis taškas | Įrankiai | Apima |
|---|---|---|
/mcp/channel-manager | ~9 | Kanalo valdytojo, PMS ar CRS integracijos prijungimas ir patvirtinimas |
Kiekvienas galinis taškas taip pat turi ping įrankį, kad galėtumėte patvirtinti, jog ryšys veikia prieš prašydami atlikti tikrą darbą.
Kokius įrankių rinkinius man reikia?
Section titled “Kokius įrankių rinkinius man reikia?”| Jei jūs… | Prisijunkite prie |
|---|---|
| Integruojate kanalo valdytoją, PMS ar CRS | integrations.wink.travel/mcp/channel-manager – tik šio |
| Valdote objekto turinį | /mcp/extranet/property + /mcp/extranet/facilities |
| Valdote kambarius ir kambarių tipus | /mcp/extranet/facilities |
| Valdote kainas ir prieinamumą | /mcp/extranet/rates |
| Vykdote kasdienes rezervacijas | /mcp/extranet/operations |
| Plečiate platinimą | /mcp/extranet/distribution + /mcp/analytics |
| Kuriate filialų puslapius | /mcp/studio/curation + /mcp/studio/embeds |
| Vykdote link-in-bio puslapius | /mcp/link-manager + /mcp/social |
| Rezervuojate keliautojų vardu | /mcp/travel-agent |
| Tvarkote finansus | /mcp/payment |
| Kuriate rezervavimo patirtį | /mcp/booking-engine + /mcp/reference |
Pradėkite nuo vieno. Pridėkite kitą, kai prireiks kažko, ko jis negali – kiekvienas ryšys yra nepriklausomas, ir pridėjus vieną kiti nebus paveikti.
Kaip veikia autentifikacija
Section titled “Kaip veikia autentifikacija”Wink MCP serveriai naudoja OAuth2 autorizacijos kodo + PKCE srautą ir palaiko dinaminę kliento registraciją (RFC 7591). Štai kas vyksta, kai jungiatės pirmą kartą:
- Jūsų AI klientas atranda autorizacijos serverį iš MCP galinio taško
/.well-known/oauth-protected-resourcemetaduomenų. - Klientas pats užsiregistruoja per dinaminę kliento registraciją – nereikia rankinio programos nustatymo.
- Klientas atidaro naršyklės skirtuką adresu
https://iam.wink.travel. Jūs prisijungiate su savo Wink paskyra ir patvirtinate prašomas teises sutikimo ekrane. - Wink išduoda prieigos žetoną, susietą su jūsų paskyra ir tapatybe.
- AI klientas prideda žetoną prie kiekvieno MCP užklausos. Visi įrankių rezultatai automatiškai taikomi jūsų valdymo subjektui.
- Žetonai galioja 3 valandas. Jūsų AI klientas tyliai atnaujina žetoną fone be papildomo prašymo.
Kiekvienas įrankio kvietimas vykdomas jūsų tapatybės vardu – ta pati ACL taisyklė, sauganti interneto portalą, taikoma AI agentui.
Prijunkite savo AI klientą
Section titled “Prijunkite savo AI klientą”-
Įsitikinkite, kad Claude Code yra atnaujintas:
Terminal window npm install -g @anthropic-ai/claude-code -
Pasirinkite įrankių rinkinį iš aukščiau pateikto katalogo ir pridėkite jį. Pavyzdžiui, kainas ir prieinamumą:
Terminal window claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http -
Claude Code susisiekia su serveriu, atranda autorizacijos serverį ir atidaro numatytąją naršyklę.
-
Prisijunkite prie Wink ir patvirtinkite leidimų prašymą sutikimo ekrane.
-
Claude Code patvirtina ryšį. Įveskite
/mcp, kad patikrintumėte, ar serveris matomas ir įrankiai įkelti.
Pridėkite tiek įrankių rinkinių, kiek reikia jūsų darbui – kiekvienas yra atskiras serverio įrašas su savo pavadinimu:
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 httpPrisijungiate tik vieną kartą. Po pirmo naršyklės patvirtinimo Claude Code naudoja jūsų Wink sesiją papildomiems Wink galiniams taškams.
-
Redaguokite Claude Desktop konfigūracijos failą:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
- macOS:
-
Pridėkite MCP serverių įrašus:
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"}}} -
Pilnai uždarykite ir paleiskite iš naujo Claude Desktop (naudokite Quit meniu juostoje – lango uždarymas nepakanka).
-
Claude Desktop atidaro naršyklės skirtuką kiekvienam naujam serveriui. Prisijunkite prie Wink ir patvirtinkite leidimus.
-
Apatinėje įrankių juostoje esanti kištuko piktograma rodo abu serverius kaip prijungtus.
-
Įsitikinkite, kad Codex CLI įdiegtas:
Terminal window npm install -g @openai/codex -
Atidarykite (arba sukurkite) Codex konfigūracijos failą:
- macOS / Linux:
~/.codex/config.json - Windows:
%USERPROFILE%\.codex\config.json
- macOS / Linux:
-
Pridėkite Wink MCP serverių įrašus:
~/.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"}}} -
Paleiskite Codex. Pirmą kartą naudojant Codex atidaro naršyklės skirtuką adresu
https://iam.wink.travel. -
Prisijunkite prie Wink ir patvirtinkite prašomas teises.
-
Codex patvirtina ryšį. Paleiskite
codexir paprašykite parodyti galimus įrankius, kad patvirtintumėte, jog Wink serveriai veikia.
MCP serverių palaikymas yra ChatGPT darbalaukio programoje Plus, Pro, Team ir Enterprise prenumeratoriams.
-
Atsisiųskite ir įdiekite ChatGPT darbalaukio programą, jei dar neturite.
-
Atidarykite programą ir spustelėkite savo profilio piktogramą viršutiniame dešiniajame kampe, tada pasirinkite Nustatymai.
-
Eikite į Jungiklius (arba MCP serveriai priklausomai nuo programos versijos) ir spustelėkite Pridėti.
-
Įveskite įrankių rinkinio URL iš aukščiau pateikto katalogo, pavyzdžiui:
https://api.wink.travel/mcp/extranet/ratesTada spustelėkite Prisijungti.
-
ChatGPT atidaro naršyklės skirtuką adresu
https://iam.wink.travel. Prisijunkite prie Wink ir patvirtinkite leidimus. -
Pakartokite 4–5 žingsnius su kitais reikalingais įrankių rinkiniais, pavyzdžiui:
https://api.wink.travel/mcp/extranet/operations -
Kiekvienas įrankių rinkinys pasirodo jūsų Jungiklių sąraše. Pradėkite naują pokalbį – Wink įrankiai bus automatiškai prieinami.
-
Atidarykite (arba sukurkite) Cursor MCP konfigūracijos failą:
- macOS / Linux:
~/.cursor/mcp.json - Windows:
%USERPROFILE%\.cursor\mcp.json
- macOS / Linux:
-
Pridėkite Wink MCP serverių įrašus:
~/.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"}}} -
Atidarykite Cursor. Eikite į Nustatymai → Cursor nustatymai → MCP ir patikrinkite, ar abu serveriai rodomi su žaliu statuso indikatoriumi. Jei rodo raudoną, spustelėkite Atnaujinti.
-
Cursor atidaro naršyklės skirtuką adresu
https://iam.wink.travel. Prisijunkite prie Wink ir patvirtinkite leidimus. -
Atidarykite pokalbį (
Ctrl+L/Cmd+L) ir paprašykite Cursor parodyti galimus Wink įrankius, kad patvirtintumėte ryšį.
-
Atidarykite (arba sukurkite) Windsurf MCP konfigūracijos failą:
- macOS / Linux:
~/.codeium/windsurf/mcp_config.json - Windows:
%USERPROFILE%\.codeium\windsurf\mcp_config.json
- macOS / Linux:
-
Pridėkite Wink MCP serverių įrašus:
~/.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"}}} -
Pilnai paleiskite Windsurf iš naujo (Failas → Išeiti, tada vėl atidarykite).
-
Eikite į Nustatymai → MCP serveriai ir patikrinkite, ar abu serveriai rodomi kaip prijungti. Pirmą kartą naudojant Windsurf atidaro naršyklės skirtuką adresu
https://iam.wink.travel. -
Prisijunkite prie Wink ir patvirtinkite leidimus. Serveriai nustatymų lange pasidaro žali, kai autentifikuojatės.
Cline yra VS Code plėtinys su integruotu MCP serverių valdymu. Rankinis JSON redagavimas nereikalingas.
-
Įdiekite Cline iš VS Code Marketplace:
- Atidarykite VS Code ir paspauskite
Ctrl+Shift+X/Cmd+Shift+X - Ieškokite Cline ir spustelėkite Įdiegti
- Atidarykite VS Code ir paspauskite
-
Spustelėkite Cline piktogramą veiklos juostoje (kairėje šoninėje juostoje), kad atidarytumėte Cline panelę.
-
Spustelėkite MCP serverių piktogramą (kištuko piktogramą) Cline įrankių juostoje, tada pasirinkite Redaguoti MCP nustatymus.
-
VS Code atidaro
cline_mcp_settings.json. Pridėkite Wink įrašus: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"}}} -
Išsaugokite failą. Cline automatiškai perkrauna ir atidaro naršyklės skirtuką adresu
https://iam.wink.travel. -
Prisijunkite prie Wink ir patvirtinkite leidimus. Abu serveriai rodomi kaip aktyvūs MCP serverių panelėje.
Leidimai
Section titled “Leidimai”Patvirtindami sutikimo ekraną matysite, kokias teises agentas prašo. MCP klientai naudoja tą pačią leidimų žodyną kaip ir visa platforma – pilną leidimų aprašymą rasite Autentifikacijos puslapyje.
Du dalykai yra specifiniai MCP:
mcp.read,mcp.write,mcp.removeleidimai papildomai reikalingi atidaryti MCP transportą. Klientas, turintismcp.*leidimą, gali jungtis prie bet kurio Wink MCP galinio taško, bet kiekvienas įrankis, kurį jis kviečia, vis tiek taiko to galinio taško skyriaus leidimą (pvz.,booking.read).- AI klientas prašo tik reikalingų leidimų. Galite atmesti atskirus leidimus sutikimo ekrane – įrankiai, kuriems reikalingas atmestas leidimas, grąžins klaidą kviečiant.
Įrankių rinkiniai nieko nekeičia. Galinis taškas, prie kurio jungiatės, nusprendžia, kurie įrankiai yra pateikti sąraše, o ne ką jie gali daryti. Prisijungimas prie /mcp/payment nesuteikia jokių finansinių teisių, kurių jau neturėjote, o prisijungimas prie /mcp/reference nesustabdo įrankio taikyti savo leidimą. Autorizacija sprendžiama kiekvieno įrankio kvietimo metu pagal jūsų žetoną ir paskyros teises.
Trikčių šalinimas
Section titled “Trikčių šalinimas”Naršyklės skirtukas neatidaromas
Jūsų AI klientas gali dar nepalaikyti interaktyvaus PKCE srauto. Patikrinkite, ar naudojate naujausią versiją:
- Claude Code:
npm install -g @anthropic-ai/claude-code - Codex CLI:
npm install -g @openai/codex - Claude Desktop / ChatGPT darbalaukis: atnaujinkite per programos vidinį atnaujinimą
401 Unauthorized po prisijungimo
Jūsų talpykloje esantis žetonas gali būti pasenęs. Pašalinkite ir pridėkite serverį iš naujo, kad suaktyvintumėte naują prisijungimą:
# Claude Codeclaude mcp remove wink-ratesclaude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport httpClaude Desktop ir ChatGPT pašalinkite serverio įrašą iš nustatymų, paleiskite programą iš naujo ir pridėkite jį vėl.
403 Forbidden kviečiant konkretų įrankį
Įrankiui reikalingas leidimas, kurio nesutikote sutikimo ekrane, arba jūsų paskyra neturi reikiamos teisės. Prisijunkite prie serverio iš naujo – sutikimo ekranas pasirodys dar kartą ir galėsite patvirtinti trūkstamą leidimą. Jei vis tiek nepavyksta, įrankiui reikia paskyros leidimo, kurio neturite; jungimasis prie kito įrankių rinkinio nepadės, nes įrankių rinkiniai nesuteikia leidimų.
Įrankis, kurio reikia, nėra sąraše
Tikėtina, kad esate prisijungę prie įrankių rinkinio, kuris neapima tos užduoties. Patikrinkite galinių taškų katalogą ir pridėkite tinkamą įrankių rinkinį – ryšiai yra nepriklausomi, todėl pridėjus vieną niekas kitas nesikeičia. Jei nesate tikri, kuris jį turi, laikinai prisijunkite prie https://api.wink.travel/mcp, raskite įrankį, tada pažiūrėkite, kuris įrankių rinkinys jį pateikia.
404 Not Found įrankių rinkinio galiniame taške
Atidžiai patikrinkite kelią – įrankių rinkiniai su dviem segmentais (/mcp/extranet/rates, o ne /mcp/extranet-rates), o plokšti turi vieną segmentą (/mcp/link-manager). Atkreipkite dėmesį, kad neautentifikuota užklausa bet kuriame /mcp kelyje grąžina 401, o ne 404, todėl vien 401 nepasako, ar galinis taškas egzistuoja.
Prisijungiau prie api.wink.travel/mcp/channel-manager ir nieko negavau
Toks galinis taškas neegzistuoja. Kanalo valdytojo integracija teikiama tik per https://integrations.wink.travel/mcp/channel-manager. Jei taip pat reikia rankiniu būdu skaityti ar rašyti objekto kainas, tai atskira užduotis atskirame galiniame taške – žr. /mcp/extranet/rates.
Serveris matomas, bet įrankių kvietimai grąžina „account not found“
Jūs esate prisijungę prie Wink paskyros, kuri neturi valdymo subjekto. Eikite į Wink Portal ir įsitikinkite, kad jūsų paskyra yra tinkamai sukonfigūruota prieš naudojant MCP serverį.
Žetonas baigiasi sesijos viduryje
Žetonai galioja 3 valandas. Claude Code ir Claude Desktop tyliai atnaujina žetonus be pertraukos jūsų sesijoje. Jei po ilgo neveikimo matote autentifikacijos klaidas, įveskite naują žinutę – klientas automatiškai persijungs.
Codex CLI rodo „MCP server unreachable“
Patikrinkite, ar jūsų ~/.codex/config.json yra galiojantis JSON (be užbaigiančių kablelių) ir ar "type": "http" yra nustatytas. Codex reikalauja HTTP transporto nuotoliniams serveriams; stdio transportas skirtas tik vietiniams binariniams failams.
ChatGPT „Connectors“ meniu nėra
MCP palaikymas reikalauja ChatGPT darbalaukio programos versijos 1.2024.352 ar naujesnės ir aktyvios Plus, Pro, Team arba Enterprise prenumeratos. Atnaujinkite programą ir patikrinkite planą Nustatymai → Paskyra.
Cursor serveris rodo raudoną / „Nepavyko prisijungti“
Patikrinkite, ar jūsų ~/.cursor/mcp.json yra galiojantis JSON ir turi "type": "http". Tada eikite į Nustatymai → Cursor nustatymai → MCP ir spustelėkite Atnaujinti. Jei klaida išlieka, pilnai paleiskite Cursor iš naujo – konfigūracijos pakeitimai ne visada įsigalioja be perkrovimo.
Windsurf MCP serveriai nerodomi nustatymuose
Windsurf reikalauja pilno perkrovimo (ne tik lango perkrovimo), kad paimtų pakeitimus mcp_config.json. Naudokite Failas → Išeiti ir paleiskite iš naujo. Jei serveriai vis dar nerodomi, įsitikinkite, kad naudojate Windsurf 1.4+ per Pagalba → Apie Windsurf.
Cline „Pridėti serverį“ parinktis nematoma
MCP serverių valdymui reikalinga Cline versija 2.0 ar naujesnė. Atidarykite VS Code plėtinių panelę, suraskite Cline ir spustelėkite Atnaujinti, jei yra atnaujinimas. Po atnaujinimo perkraukite VS Code (Ctrl+Shift+P → „Developer: Reload Window“).
Atidaryti Wink Portalą Wink GitHub
