Skip to content

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ų iš karto.

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 klientų paslapčių.

Kanalo valdytojo integratorius jungiasi prie vieno galinio taško
claude mcp add wink-channel-manager https://integrations.wink.travel/mcp/channel-manager --transport http
Viešbučio valdytojas, valdantis savo kainas, jungiasi prie kito
claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http

Kodėl įrankiai padalinti į skirtingus galinius taškus

Section titled “Kodėl įrankiai padalinti į skirtingus galinius taškus”

Wink turi apie 500 įrankių. Pateikti visus vienu metu agentui techniškai įmanoma – bet tai bloga idėja.

Įrankių apibrėžimai kainuoja kontekstą. Kiekvienas MCP serverio skelbiamas įrankis įkeliamas į modelio konteksto langą prieš atliekant bet kokį darbą, kartu su aprašymu ir pilnu parametrų schema. 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ą.


Du serveriai teikia įrankių rinkinius. Įrankių skaičius apytikris ir laikui bėgant didėja.

Galinis taškasĮrankiaiApima
/mcp/extranet/facilities~64Rezervuojamas ir vietoje esantis inventorius: svečių kambariai ir kambarių tipai, SPA, restoranai, susitikimų kambariai, veiklos, lankytinos vietos, kitos parduodamos prekės
/mcp/extranet/property~62Objekto įrašas ir jo komercinės sąlygos: profilis ir turinys, priedai, atšaukimo politikos, privilegijos, pranešimai
/mcp/settings~60Paskyros administravimas: valdymo subjektų profilis ir prekės ženklas, vadybininkai ir jų suteikti leidimai, pritaikymas, webhooks, pranešimų nustatymai
/mcp/studio/embeds~48Kuriamo inventoriaus publikavimas: valdikliai, tinklai ir reitinguoti tinklai, kortelės, žemėlapiai, gilios nuorodos į inventorių ir tiekėjų puslapius
/mcp/extranet/rates~44Kainos ir prieinamumas: inventoriaus kainų laikotarpiai ir kvotos, kainų planai, pagrindinės kainos, specialios ir reklaminės kainos
/mcp/extranet/operations~39Veikiančio objekto valdymas: rezervacijos ir jų gyvavimo ciklas, svečių atsiliepimai ir atsakymai, kalendoriaus srautai, suplanuotos užduotys
/mcp/extranet/distribution~37Kur parduodamas inventorius: pardavimo kanalai ir kainų modifikatoriai, filialų ir tiekėjų santykių užklausos, registracija, potencialių klientų surinkimas
/mcp/studio/curation~35Prekių kolekcijų kūrimas: statiniai ir dinaminiai sąrašai, reitinguoti sąrašai, išsaugotos paieškos, objekto agregatai
/mcp/link-manager~28Syndikuotų nuorodų kolekcijos, jų dizainas, kategorijos ir žymos, taip pat sutrumpintos URL
/mcp/reference~24Tik skaitymui skirti duomenys: šalys, valiutos ir valiutų kursai, kalbos, laiko juostos, geografiniai užklausimai, IP geolokacija
/mcp/analytics~18Rezervacijų ir pajamų analizė: apžvalgos, linijiniai grafikai, lyderių lentelės, filialų veiklos rodikliai, dalijimosi metrika
/mcp/payment~18Finansinės operacijos: apskaita, išmokėjimai ir mokesčių įvertinimai, rezervacijų lėšų agregatai
/mcp/booking-engine~17Keliautojui skirtas pirkimo kelias: paieška ir užklausos, pirkinių krepšelis ir atsiskaitymas, norų sąrašai, kampanijų pritaikymas
/mcp/social~17Prijungtos socialinės paskyros, įrašų publikavimas ir planavimas, įrašų analizė
/mcp/travel-agent~8Agentų 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ĮrankiaiApima
/mcp/channel-manager~9Kanalo valdytojo, PMS ar CRS integracijos prijungimas ir patvirtinimas

Kiekvienas galinis taškas taip pat turi ping įrankį, kad galėtumėte patikrinti, ar ryšys veikia prieš prašydami atlikti tikrą darbą.

Pilnam keliautojo rezervacijos srautui prijunkite Wink Booking Engine adresu https://api.wink.travel/mcp/booking-engine ir suderinamą mokėjimo piniginę. Pridėjus Wink MCP atsidaro naršyklės prisijungimas ir leidimų pasirinkimas; jūsų klientas tada tvarko autentifikaciją.

Booking Engine apima kelionės tikslų paiešką, viešbučių ir kambarių paiešką, agentic_booking_quote, agentic_booking_pay, agentic_booking_book, rezervacijų gavimą ir kvitus, kai agentinė rezervacija ir mokėjimas įjungti tam aplinkai. Žr. Agentic Payments dėl prijungimo nustatymų, pasirenkamų leidimų ir žingsnių nuo paieškos iki patvirtinimo.


Jei jūs…Prijunkite prie
Integruojate kanalo valdytoją, PMS ar CRSintegrations.wink.travel/mcp/channel-manager – tik šį
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 nuorodų puslapius/mcp/link-manager + /mcp/social
Rezervuojate keliautojų vardu/mcp/travel-agent
Tvarkote finansus/mcp/payment
Rezervuojate kambarį su AI agentu/mcp/booking-engine + suderinama mokėjimo piniginė – žr. Agentic Payments
Kuriate rezervacijos patirtį/mcp/booking-engine; papildomai /mcp/reference papildomoms užklausoms

Booking Engine apima pagrindinį rezervacijos srautą. Jis suteikia paskyros ir pritaikymo atradimą, kelionės tikslų paiešką, viešbučių prieinamumą ir kambarių kainų detales, pirkinių krepšelius, atsiskaitymą ir keliautojų rezervacijų valdymą. Agentinės rezervacijos ir mokėjimo įrankiai taip pat įtraukti, kai įjungti tam aplinkai.

Miestų viešbučių paieškai naudokite destination_lookup_search_suggestions kelionės tikslui nustatyti, tada inventory_search_city – prieinamų viešbučių ir kainų radimui. Abu įrankiai yra /mcp/booking-engine, todėl šiam srautui nereikia Reference ryšio.

Pridėkite /mcp/reference, kai reikia papildomų užklausų, tokių kaip šalys, valiutos ir valiutų kursai, palaikomos kalbos, laiko juostos, platesnės geografinės paieškos, OTA klasifikacijos ar viešos objekto žinios. Tai yra neprivalomi papildymai rezervacijos srautui.

Pradėkite nuo vieno. Pridėkite kitą, kai pastebite, kad kažko trūksta – kiekvienas ryšys yra nepriklausomas, ir pridėjus vieną, kiti nesikeičia.


Wink MCP serveriai naudoja OAuth2 autorizacijos kodo + PKCE srautą ir palaiko dinaminę kliento registraciją (RFC 7591). Štai kas vyksta, kai jungiatės pirmą kartą:

  1. Jūsų AI klientas atranda autorizacijos serverį iš MCP galinio taško /.well-known/oauth-protected-resource metaduomenų.
  2. Klientas pats užsiregistruoja per dinaminę kliento registraciją – nereikia rankinio programos nustatymo.
  3. Klientas atidaro naršyklės skirtuką adresu https://iam.wink.travel. Jūs prisijungiate su savo Wink paskyra ir patvirtinate prašomus leidimus sutikimo ekrane.
  4. Wink išduoda prieigos žetoną, susietą su jūsų paskyra ir tapatybe.
  5. AI klientas prideda žetoną prie kiekvieno MCP užklausos. Visi įrankių rezultatai automatiškai ribojami pagal jūsų valdomą subjektą.
  6. Ž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 žiniatinklio portalą, taikoma AI agentui.


Pridėkite kiekvieną įrankių rinkinį prie Claude kaip pasirinktą jungtį. Nereikia redaguoti konfigūracijos failo ar kurti programos ar paslapties.

  1. Claude atidarykite Customize › Connectors, spustelėkite Add, tada Add custom connector.

  2. Įveskite Pavadinimą (pvz., Wink Link manager) ir kaip MCP serverio URL – įrankių rinkinį iš aukščiau pateikto katalogo, pvz.:

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

    Spustelėkite Continue.

  3. Claude aptinka Wink prisijungimą. Palikite Authentication: Sign in now ir OAuth client: Register automatically, tada spustelėkite Add.

  4. Spustelėkite Connect. Atsidarys Wink prisijungimo puslapis https://iam.wink.travel. Prisijunkite prie Wink ir patvirtinkite leidimus sutikimo ekrane.

  5. Jungties įrankiai dabar pasiekiami jūsų pokalbiuose. Kartokite kiekvienam reikalingam įrankių rinkiniui; kiekvienas yra atskira jungtis.


Patvirtindami sutikimo ekraną matysite, kokius leidimus agentas prašo. MCP klientai naudoja tą patį leidimų žodyną kaip ir visa platforma – žr. pilną leidimų aprašymą Autentifikacijos puslapyje.

Trys dalykai yra specifiniai MCP:

  • mcp.read, mcp.write, mcp.remove leidimai papildomai reikalingi atidaryti MCP transportą. Klientas, turintis mcp.* leidimą, gali jungtis prie bet kurio Wink MCP galinio taško, bet kiekvienas įrankis vis tiek taiko savo galinio taško leidimų ribojimus (pvz., booking.read).
  • MCP visada veikia kaip prisijungęs vartotojas. AI klientas gauna mcp.* leidimus per jūsų prisijungimą, niekada iš Programos, kurią sukuriate. Mašinos-mašinai (client-credentials) žetonai negali atidaryti MCP transporto; naudokite REST API serverių darbui.
  • AI klientas prašo tik reikalingų leidimų. Galite atmesti atskirus leidimus sutikimo ekrane – įrankiai, kuriems reikalingas atmestas leidimas, grąžins klaidą kvietimo metu.

Įrankių rinkiniai nieko nekeičia. Galinis taškas, prie kurio jungiatės, nusprendžia, kurie įrankiai yra pateikti, o ne ką jie gali daryti. Prisijungimas prie /mcp/payment nesuteikia finansinių leidimų, kurių jau neturėjote, o prisijungimas prie /mcp/reference nesustabdo įrankio taikyti savo leidimų ribojimų. Autorizacija sprendžiama kiekvieno įrankio kvietimo metu pagal jūsų žetoną ir paskyros leidimus.


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 pradėtumėte naują prisijungimą:

Terminal window
# Claude Code
claude mcp remove wink-rates
claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http

Claude Desktop ir ChatGPT pašalinkite serverio įrašą nustatymuose, paleiskite programą iš naujo ir pridėkite serverį dar kartą.

403 Forbidden kviečiant konkretų įrankį

Įrankiui reikalingas leidimas, kurio nesutikote sutikimo ekrane, arba leidimas, kurio jūsų paskyra neturi. 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; jungtis prie kito įrankių rinkinio nepadės, nes įrankių rinkiniai nesuteikia leidimų.

Įrankio, kurio reikia, nėra sąraše

Tikriausiai esate prijungę įrankių rinkinį, kuris neapima tos užduoties. Patikrinkite galinio taško 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, kuriame įrankių rinkinyje jis yra.

404 Not Found galinio taško adresu

Atidžiai patikrinkite kelią – įrankių rinkiniai turi du segmentus (/mcp/extranet/rates, o ne /mcp/extranet-rates), o plokšti – vieną (/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“

Esate prisijungę prie Wink paskyros, kuri neturi valdomo 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 pertraukimo. 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" nustatytas. Codex reikalauja HTTP transporto nuotoliniams serveriams; stdio transportas skirtas tik vietiniams binariniams failams.

ChatGPT „Connectors“ meniu nerodomas

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ą / „Failed to connect“

Patikrinkite, ar jūsų ~/.cursor/mcp.json yra galiojantis JSON ir turi "type": "http". Tada eikite į Settings → Cursor Settings → MCP ir spustelėkite Refresh. 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 įkeltų pakeitimus mcp_config.json. Naudokite File → Quit ir paleiskite iš naujo. Jei serveriai vis dar nerodomi, įsitikinkite, kad naudojate Windsurf 1.4+ per Help → About Windsurf.

Cline „Add Server“ parinktis nematoma

MCP serverių valdymas reikalauja Cline 2.0 ar naujesnės versijos. Atidarykite VS Code Extensions panelę, raskite Cline ir spustelėkite Update, jei yra atnaujinimas. Po atnaujinimo perkraukite VS Code (Ctrl+Shift+P → „Developer: Reload Window“).


Atidaryti Wink Portalą Wink GitHub