Pāriet uz saturu

MCP serveri

Wink MCP rīki tiek publicēti kā rīku komplekti — fokusēti galapunkti, katrs aptver vienu darba jomu. 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 izmanto 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 ir patiesi 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. Darba sadalīšana 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 kopsavilkumi
/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 kopsavilkumi
/mcp/booking-engine~17Ceļotājam paredzēta iepirkšanās ceļš: meklēšana un meklēšana, 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

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


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
Veidojat rezervēšanas pieredzi/mcp/booking-engine + /mcp/reference

Sāciet ar vienu. Pievienojiet citu, kad atklājat, ka kaut ko nevar izdarīt — katrs savienojums ir neatkarīgs, un pievienošana nekad neietekmē citus.


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 žetonus fonā bez atkārtotas pieprasīšanas.

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.


  1. Pārliecinieties, ka Claude Code ir atjaunināts:

    Terminal window
    npm install -g @anthropic-ai/claude-code
  2. Izvēlieties rīku komplektu no augstāk redzamā katalogā un pievienojiet to. Piemēram, cenas un pieejamība:

    Terminal window
    claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http
  3. Claude Code sazinās ar serveri, atrod autorizācijas serveri un atver jūsu noklusējuma pārlūkprogrammu.

  4. Pierakstieties Wink un apstipriniet atļauju pieprasījumu piekrišanas ekrānā.

  5. Claude Code apstiprina savienojumu. Ierakstiet /mcp, lai pārbaudītu, vai serveris parādās un tā rīki ir ielādēti.

Pievienojiet tik daudz rīku komplektu, cik nepieciešams jūsu darbam — katrs ir atsevišķs servera ieraksts ar savu nosaukumu:

Terminal window
claude mcp add wink-operations https://api.wink.travel/mcp/extranet/operations --transport http
claude mcp add wink-analytics https://api.wink.travel/mcp/analytics --transport http

Jūs pierakstāties tikai vienreiz. Pēc pirmās pārlūkprogrammas apstiprināšanas Claude Code atkārtoti izmanto jūsu Wink sesiju papildu Wink galapunktiem.


Apstiprinot piekrišanas ekrānu, redzēsiet, 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ā.

Divas 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).
  • AI klients pieprasa tikai tās jomas, kas tam nepieciešamas. 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 to 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 katrā rīka izsaukumā, 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 darbvirsmas lietotne: atjauniniet, izmantojot lietotnes iebūvēto atjauninātāju

401 Unauthorized pēc pieteikšanās

Jūsu kešotais žetons var būt novecojis. Noņemiet un pievienojiet serveri vēlreiz, 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ā. Pārslēdziet serveri — piekrišanas ekrāns parādīsies vēlreiz, un jūs varat 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 neatdod atļaujas.

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

Iespējams, 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 pievienošana neko nemaina citos. 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 rīku komplekta galapunktā

Pārbaudiet ceļu uzmanīgi — 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.

Savienojos ar 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ž “konts nav atrasts”

Jūs esat pierakstījies Wink kontā, kam nav pārvaldības vienības. Dodieties uz Wink portālu 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ņojumu — klients automātiski pārreģistrēsies.

Codex CLI rāda “MCP serveris nav sasniedzams”

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 “Savienotāji” 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 / “Neizdevās savienoties”

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

Windsurf MCP serveri nav redzami iestatījumos

Windsurf prasa pilnīgu restartu (ne tikai loga pārlādi), lai ielādētu izmaiņas mcp_config.json. Izmantojiet Fails → Iziet un palaidiet no jauna. Ja serveri joprojām nav redzami, pārliecinieties, ka izmantojat Windsurf 1.4+ caur Palīdzība → Par Windsurf.

Cline “Pievienot serveri” opcija nav redzama

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


Atvērt Wink portālu Wink GitHub