Pāriet uz saturu

MCP serveri

Wink MCP rīki tiek publicēti kā rīku komplekti — fokusēti galapunkti, katrs aptver vienu darba uzdevumu. Jūs savienojat savu AI klientu ar vienu vai diviem, kas atbilst jūsu darbam, nevis ar visiem.

Katrs galapunkts izmanto interaktīvu OAuth2 pieteikšanos (PKCE autorizācijas koda plūsma): jūsu AI aģents atver pārlūkprogrammas cilni, jūs piesakāties ar savu Wink kontu, un tas arī viss. Nav jāuztur klienta noslēpumi.

Kanālu pārvaldnieka integrators savienojas ar vienu galapunktu
claude mcp add wink-channel-manager https://integrations.wink.travel/mcp/channel-manager --transport http
Viesnīcas pārvaldnieks, kas pārvalda savas cenas, savienojas ar citu
claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http

Kāpēc rīki ir sadalīti pa galapunktiem

Section titled “Kāpēc rīki ir sadalīti pa galapunktiem”

Wink piedāvā apmēram 500 rīkus. Visus tos nodot aģentam uzreiz ir tehniski iespējams — bet slikta ideja.

Rīku definīcijas aizņem kontekstu. Katrs rīks, ko MCP serveris reklamē, tiek ielādēts modeļa konteksta logā pirms darba veikšanas, kopā ar tā aprakstu un pilnu parametru shēmu. Pieci simti no tiem patērē lielu daļu no budžeta, kas nepieciešams jūsu faktiskajam uzdevumam, katrā pieprasījumā.

Izvēles kvalitāte samazinās, palielinoties sarakstam. Aģents, kas izvēlas no 500 līdzīgi nosauktiem rīkiem, pieņem sliktākas izvēles nekā tas, kas izvēlas no 40. Ja integrējat kanālu pārvaldnieku, aptuveni divdesmit rīki jums ir nozīmīgi; pārējie 480 ir troksnis, kas apgrūtina pareizā rīka atrašanu.

Darbs patiešām ir sadalāms. Kāds, kas sinhronizē pieejamību no PMS, un kāds, kas veido filiāļu nolaišanās lapas, gandrīz nesadala rīkus. Sadalīšana pēc darba nozīmē, ka katrs savienojums nes viena darba vārdu krājumu.


Divi saimniekdatori apkalpo rīku komplektus. Rīku skaits ir aptuvens un laika gaitā pieaug.

GalapunktsRīkiKo tas aptver
/mcp/extranet/facilities~64Rezervējamais un uz vietas esošais inventārs: viesu numuri un numuru tipi, spa, restorāni, sapulču telpas, aktivitātes, apskates objekti, vietas, citi pārdodami vienumi
/mcp/extranet/property~62Īpašuma ieraksts un tā komerciālie nosacījumi: profils un saturs, papildinājumi, atcelšanas politikas, priekšrocības, paziņojumi
/mcp/settings~60Konta administrēšana: pārvaldības vienības profils un zīmols, pārvaldnieki un viņu pilnvaras, pielāgošana, tīmekļa āķi, paziņojumu preferences
/mcp/studio/embeds~48Kurašu inventāra publicēšana: logrīki, režģi un rangoti režģi, kartītes, kartes, dziļās saites uz inventāru un piegādātāju lapām
/mcp/extranet/rates~44Cenas un pieejamība: inventāra cenu periodi un kvotas, cenu plāni, galvenās cenas, īpašās un reklāmas cenas
/mcp/extranet/operations~39Dzīvo īpašumu pārvaldība: rezervācijas un to dzīves cikls, viesu atsauksmes un atbildes, kalendāra plūsmas, ieplānotie uzdevumi
/mcp/extranet/distribution~37Kur inventārs tiek pārdots: pārdošanas kanāli un cenu modifikatori, filiāļu un piegādātāju attiecību pieprasījumi, reģistrācija, potenciālo klientu vākšana
/mcp/studio/curation~35Tirgojamu kolekciju veidošana: statiski un dinamiskie saraksti, rangoti saraksti, saglabātās meklēšanas, īpašuma apkopojumi
/mcp/link-manager~28Sindikētas saišu kolekcijas, to dizains, kategorijas un tagi, kā arī saīsinātie URL
/mcp/reference~24Tikai lasāmi meklēšanas dati: valstis, valūtas un valūtas kursi, valodas, laika joslas, ģeogrāfiskās meklēšanas, IP ģeolokācija
/mcp/analytics~18Rezervāciju un ieņēmumu analītika: pārskati, līniju diagrammas, līderu saraksti, filiāļu veiktspēja, koplietošanas rādītāji
/mcp/payment~18Finanšu operācijas: virsgrāmata, izņemšanas un maksu aplēses, rezervāciju līdzekļu apkopojumi
/mcp/booking-engine~17Ceļotājam paredzēta iepirkšanās ceļš: meklēšana un atlase, iepirkumu grozs un norēķini, vēlmju saraksti, kampaņu pielāgošana
/mcp/social~17Savienotie sociālie konti, ziņu publicēšana un plānošana, ziņu ieskatu lasīšana
/mcp/travel-agent~8Aģenta veiktas rezervācijas ceļotāju vārdā un aģenta atskaites

https://integrations.wink.travel — kanālu pārvaldnieku integrācijas

Section titled “https://integrations.wink.travel — kanālu pārvaldnieku integrācijas”

Viens galapunkts, jo šis saimniekdators pastāv vienam darbam.

GalapunktsRīkiKo tas aptver
/mcp/channel-manager~9Kanālu pārvaldnieka, PMS vai CRS integrācijas savienošana un pārbaude

Katram galapunktam ir arī ping rīks, lai jūs varētu pārbaudīt, vai savienojums ir aktīvs, pirms lūgt tam veikt reālu darbu.

Pilnam ceļotāja rezervācijas plūsmas nodrošināšanai savienojiet Wink Booking Engine pie https://api.wink.travel/mcp/booking-engine un saderīgu maksājumu maku. Pievienojot Wink MCP, tiek atvērta pārlūkprogrammas pieteikšanās un atļauju izvēle; jūsu klients pēc tam pārvalda autentifikāciju.

Booking Engine ietver galamērķa atlasi, viesnīcu un numuru meklēšanu, agentic_booking_quote, agentic_booking_pay, agentic_booking_book, rezervāciju izgūšanu un kvītis, kad šajā vidē ir iespējotas agentiskas rezervācijas un maksājumi. Skatiet Agentic Payments savienojuma iestatīšanai, izvēlamajām atļaujām un soļiem no meklēšanas līdz apstiprināšanai.


Kuri rīku komplekti man ir nepieciešami?

Section titled “Kuri rīku komplekti man ir nepieciešami?”
Ja jūs esat…Savienojieties ar
Integrējat kanālu pārvaldnieku, PMS vai CRSintegrations.wink.travel/mcp/channel-manager — tikai šo
Pārvaldāt īpašuma saturu/mcp/extranet/property + /mcp/extranet/facilities
Pārvaldāt numurus un numuru tipus/mcp/extranet/facilities
Pārvaldāt cenas un pieejamību/mcp/extranet/rates
Vadāt ikdienas rezervācijas/mcp/extranet/operations
Palielināt izplatīšanu/mcp/extranet/distribution + /mcp/analytics
Veidojat filiāļu lapas/mcp/studio/curation + /mcp/studio/embeds
Vadāt link-in-bio lapas/mcp/link-manager + /mcp/social
Veicat rezervācijas ceļotāju vārdā/mcp/travel-agent
Saskaņojat naudu/mcp/payment
Rezervējat numuru ar AI aģentu/mcp/booking-engine + saderīgs maksājumu maks — skatiet Agentic Payments
Veidojat rezervācijas pieredzi/mcp/booking-engine; pēc izvēles /mcp/reference papildu meklējumiem

Booking Engine ietver galveno rezervācijas darba plūsmu. Tas nodrošina konta un pielāgošanas atklāšanu, galamērķa atlasi, viesnīcu pieejamību un numuru cenu detaļas, iepirkumu grozus, norēķinus un ceļotāju rezervāciju pārvaldību. Agentiskas rezervācijas un maksājumu rīki ir iekļauti, ja tie ir iespējoti šajā vidē.

Pilsētas viesnīcu meklēšanai izmantojiet destination_lookup_search_suggestions, lai noteiktu galamērķi, pēc tam inventory_search_city, lai atrastu pieejamās viesnīcas un cenas. Abi rīki ir /mcp/booking-engine, tāpēc šai plūsmai nav nepieciešams Reference savienojums.

Pievienojiet /mcp/reference, ja nepieciešamas atbalsta meklēšanas, piemēram, valstis, valūtas un valūtas kursi, atbalstītās valodas, laika joslas, plašākas ģeogrāfiskās meklēšanas, OTA klasifikācijas vai publiskās īpašuma zināšanas. Tie ir izvēles papildinājumi rezervācijas plūsmai.

Sāciet ar vienu. Pievienojiet citu, kad saprotat, ka kaut ko nevar izdarīt — katrs savienojums ir neatkarīgs, un viena pievienošana nekad neietekmē pārējos.


Wink MCP serveri izmanto OAuth2 autorizācijas koda + PKCE plūsmu un atbalsta dinamisko klienta reģistrāciju (RFC 7591). Šeit ir, kas notiek, kad pieslēdzaties pirmo reizi:

  1. Jūsu AI klients atrod autorizācijas serveri no MCP galapunkta /.well-known/oauth-protected-resource metadatiem.
  2. Klients pats reģistrējas, izmantojot dinamisko klienta reģistrāciju — nav nepieciešama manuāla lietotnes iestatīšana.
  3. Klients atver pārlūkprogrammas cilni uz https://iam.wink.travel. Jūs piesakāties ar savu Wink kontu un apstiprināt pieprasītās atļaujas piekrišanas ekrānā.
  4. Wink izsniedz piekļuves žetonu, kas ir saistīts ar jūsu kontu un identitāti.
  5. AI klients pievieno žetonu katram MCP pieprasījumam. Visi rīku rezultāti automātiski tiek ierobežoti jūsu pārvaldības vienībai.
  6. Žetoni beidzas pēc 3 stundām. Jūsu AI klients klusējot atjauno tos fonā bez atkārtotas prasības.

Katrs rīka izsaukums tiek veikts jūsu identitātes vārdā — tās pašas ACL noteikumi, kas aizsargā tīmekļa portālu, attiecas arī uz AI aģentu.


Pievienojiet katru rīku komplektu Claude kā pielāgotu savienotāju. Nav konfigurācijas faila, ko rediģēt, un nav jāizveido lietotne vai noslēpums.

  1. Claude atveriet Customize › Connectors, noklikšķiniet uz Add, pēc tam uz Add custom connector.

  2. Ievadiet Nosaukumu (piemēram Wink Link manager) un kā MCP servera URL rīku komplektu no augstāk minētā katalogā, piemēram:

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

    Noklikšķiniet uz Continue.

  3. Claude atpazīst Wink pieteikšanos. Atstājiet Authentication: Sign in now un OAuth client: Register automatically, pēc tam noklikšķiniet uz Add.

  4. Noklikšķiniet uz Connect. Atvērsies Wink pieteikšanās lapa https://iam.wink.travel. Pierakstieties Wink un apstipriniet atļaujas piekrišanas ekrānā.

  5. Savienotāja rīki tagad ir pieejami jūsu sarunās. Atkārtojiet katram rīku komplektam, kas nepieciešams jūsu darbam; katrs ir savs savienotājs.


Apstiprinot piekrišanas ekrānu, redzēsiet sadalījumu par to, ko aģents pieprasa. MCP klienti izmanto to pašu atļauju vārdu krājumu kā pārējā platforma — skatiet pilnu jomu atsauci autentifikācijas lapā.

Trīs lietas ir specifiskas MCP:

  • mcp.read mcp.write mcp.remove jomas ir papildus nepieciešamas, lai atvērtu MCP transportu. Klients ar mcp.* jomu tiek pieņemts jebkurā Wink MCP galapunktā, bet katrs rīks, ko tas izsauc, joprojām ievēro galapunkta sadaļas jomu (piemēram, booking.read).
  • MCP vienmēr darbojas kā pierakstījies lietotājs. AI klients saņem mcp.* jomas caur jūsu pieteikšanos, nekad no lietotnes, ko izveidojat. Mašīna-mašīnai (klienta akreditācijas dati) žetoni nevar atvērt MCP transportu; izmantojiet REST API servera-servera darbam.
  • AI klients pieprasa tikai nepieciešamās jomas. Jūs varat noraidīt atsevišķas atļaujas piekrišanas ekrānā — rīki, kas prasa noraidītu jomu, atgriezīs kļūdu, kad tos izsauks.

Rīku komplekti neko no tā nemaina. Galapunkts, pie kura pieslēdzaties, nosaka, kuri rīki ir uzskaitīti, nevis ko tie drīkst darīt. Savienojums ar /mcp/payment nedod nekādas finanšu atļaujas, kas jums jau nav, un savienojums ar /mcp/reference neaptur rīku tur ievērot savu jomu. Autorizācija tiek lemta katram rīka izsaukumam, no jūsu žetona un konta pilnvarām.


Pārlūkprogrammas cilne neatveras

Jūsu AI klients var vēl neatbalstīt interaktīvo PKCE plūsmu. Pārbaudiet, vai izmantojat jaunāko versiju:

  • Claude Code: npm install -g @anthropic-ai/claude-code
  • Codex CLI: npm install -g @openai/codex
  • Claude Desktop / ChatGPT darbvirsma: atjauniniet no lietotnes iebūvētā atjauninātāja

401 Unauthorized pēc pieteikšanās

Jūsu kešotais žetons var būt novecojis. Noņemiet un pievienojiet serveri atkārtoti, lai izraisītu jaunu pieteikšanos:

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 un ChatGPT noņemiet servera ierakstu iestatījumos, restartējiet lietotni un pievienojiet to vēlreiz.

403 Forbidden izsaucot konkrētu rīku

Rīks prasa jomu, ko neapstiprinājāt piekrišanas ekrānā, vai atļauju, kas nav jūsu kontā. Pieslēdziet serveri atkārtoti — piekrišanas ekrāns parādīsies vēlreiz, un varēsiet apstiprināt trūkstošo atļauju. Ja tas joprojām neizdodas, rīks prasa konta atļauju, kas jums nav; savienojums ar citu rīku komplektu nepalīdzēs, jo rīku komplekti nedod atļaujas.

Rīks, kas man vajadzīgs, nav sarakstā

Droši vien esat pieslēdzies rīku komplektam, kas neaptver šo darbu. Pārbaudiet galapunkta katalogu un pievienojiet rīku komplektu, kas to aptver — savienojumi ir neatkarīgi, tāpēc viena pievienošana neko nemaina pārējos. Ja neesat pārliecināts, kurš to satur, īslaicīgi pieslēdzieties https://api.wink.travel/mcp, atrodiet rīku un tad noskaidrojiet, kurš rīku komplekts to uzskaita.

404 Not Found uz rīku komplekta galapunkta

Rūpīgi pārbaudiet ceļu — ligzdotajiem rīku komplektiem ir divi segmenti (/mcp/extranet/rates, nevis /mcp/extranet-rates), bet plakanajiem viens (/mcp/link-manager). Ņemiet vērā, ka neautentificēts pieprasījums jebkuram ceļam zem /mcp atgriež 401, nevis 404, tāpēc tikai 401 nepasaka, vai galapunkts pastāv.

Pieslēdzos api.wink.travel/mcp/channel-manager un nesaņēmu neko

Šāds galapunkts nepastāv. Kanālu pārvaldnieka integrācija tiek apkalpota tikai no https://integrations.wink.travel/mcp/channel-manager. Ja jums arī jālasa vai jāmaina īpašuma cenas manuāli, tas ir atsevišķs darbs atsevišķā galapunktā — skatiet /mcp/extranet/rates.

Serveris parādās, bet rīku izsaukumi atgriež “account not found”

Jūs esat pierakstījies Wink kontā, kam nav pārvaldības vienības. Dodieties uz Wink Portal un pārliecinieties, ka jūsu konts ir iestatīts pirms MCP servera lietošanas.

Žetons beidzas sesijas vidū

Žetoni ir derīgi 3 stundas. Claude Code un Claude Desktop klusējot atjauno žetonus bez pārtraukuma. Ja pēc ilga dīkstāves perioda redzat autentifikācijas kļūdas, ierakstiet jaunu ziņu — klients automātiski pārreģistrēsies.

Codex CLI rāda “MCP server unreachable”

Pārbaudiet, vai jūsu ~/.codex/config.json ir derīgs JSON (bez pēdējām komatiem) un "type": "http" ir iestatīts. Codex prasa HTTP transportu attāliem serveriem; stdio transports ir tikai lokāliem binārajiem failiem.

ChatGPT “Connectors” izvēlne nav redzama

MCP atbalsts prasa ChatGPT darbvirsmas lietotnes versiju 1.2024.352 vai jaunāku un aktīvu Plus, Pro, Team vai Enterprise abonementu. Atjauniniet lietotni un pārbaudiet plānu Iestatījumos → Konts.

Cursor serveris rāda sarkanu / “Failed to connect”

Pārbaudiet, vai jūsu ~/.cursor/mcp.json ir derīgs JSON un satur "type": "http". Tad dodieties uz Settings → Cursor Settings → MCP un noklikšķiniet uz Refresh. Ja kļūda saglabājas, pilnībā restartējiet Cursor — konfigurācijas izmaiņas ne vienmēr tiek uzreiz ņemtas vērā bez restartēšanas.

Windsurf MCP serveri nav redzami iestatījumos

Windsurf prasa pilnu restartu (ne tikai loga pārlādi), lai ielādētu izmaiņas mcp_config.json. Izmantojiet File → Quit un palaidiet no jauna. Ja serveri joprojām nav redzami, pārliecinieties, ka esat Windsurf versijā 1.4+ caur Help → About Windsurf.

Cline “Add Server” opcija nav redzama

MCP serveru pārvaldnieks prasa Cline versiju 2.0 vai jaunāku. Atveriet VS Code Extensions paneli, atrodiet Cline un noklikšķiniet uz Update, ja ir pieejams atjauninājums. Pēc atjaunināšanas pārlādējiet VS Code (Ctrl+Shift+P → “Developer: Reload Window”).


Atvērt Wink Portal Wink GitHub