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.
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 httpKā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.
Galapunktu katalogs
Section titled “Galapunktu katalogs”Divi saimniekdatori apkalpo rīku komplektus. Rīku skaits ir aptuvens un laika gaitā pieaug.
https://api.wink.travel — platforma
Section titled “https://api.wink.travel — platforma”| Galapunkts | Rīki | Ko tas aptver |
|---|---|---|
/mcp/extranet/facilities | ~64 | Rezervē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 | ~60 | Konta 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 | ~48 | Kuraš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 | ~44 | Cenas un pieejamība: inventāra cenu periodi un kvotas, cenu plāni, galvenās cenas, īpašās un reklāmas cenas |
/mcp/extranet/operations | ~39 | Dzī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 | ~37 | Kur 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 | ~35 | Tirgojamu kolekciju veidošana: statiski un dinamiskie saraksti, rangoti saraksti, saglabātās meklēšanas, īpašuma kopsavilkumi |
/mcp/link-manager | ~28 | Sindikētas saišu kolekcijas, to dizains, kategorijas un tagi, kā arī saīsinātie URL |
/mcp/reference | ~24 | Tikai 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 | ~18 | Rezervā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 | ~18 | Finanšu operācijas: virsgrāmata, izņemšanas un maksu aplēses, rezervāciju līdzekļu kopsavilkumi |
/mcp/booking-engine | ~17 | Ceļ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 | ~17 | Savienotie sociālie konti, ziņu publicēšana un plānošana, ziņu ieskatu lasīšana |
/mcp/travel-agent | ~8 | Aģ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.
| Galapunkts | Rīki | Ko tas aptver |
|---|---|---|
/mcp/channel-manager | ~9 | Kanā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 CRS | integrations.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.
Kā darbojas autentifikācija
Section titled “Kā darbojas autentifikācija”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:
- Jūsu AI klients atrod autorizācijas serveri no MCP galapunkta
/.well-known/oauth-protected-resourcemetadatiem. - Klients pats reģistrējas, izmantojot dinamisko klienta reģistrāciju — nav nepieciešama manuāla lietotnes iestatīšana.
- 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ā. - Wink izsniedz piekļuves žetonu, kas ir saistīts ar jūsu kontu un identitāti.
- 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.
- Ž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.
Savienojiet savu AI klientu
Section titled “Savienojiet savu AI klientu”-
Pārliecinieties, ka Claude Code ir atjaunināts:
Terminal window npm install -g @anthropic-ai/claude-code -
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 -
Claude Code sazinās ar serveri, atrod autorizācijas serveri un atver jūsu noklusējuma pārlūkprogrammu.
-
Pierakstieties Wink un apstipriniet atļauju pieprasījumu piekrišanas ekrānā.
-
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:
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 httpJū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.
-
Rediģējiet Claude Desktop konfigurācijas failu:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
- macOS:
-
Pievienojiet MCP serveru ierakstus:
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"}}} -
Pilnībā aizveriet un restartējiet Claude Desktop (izmantojiet Quit no izvēlnes joslas — loga aizvēršana nav pietiekama).
-
Claude Desktop atver pārlūkprogrammas cilni katram jaunam serverim. Pierakstieties Wink un apstipriniet atļaujas.
-
Apakšējā rīkjoslā spraudņa ikona rāda abus serverus kā savienotus.
-
Pārliecinieties, ka Codex CLI ir instalēts:
Terminal window npm install -g @openai/codex -
Atveriet (vai izveidojiet) Codex konfigurācijas failu:
- macOS / Linux:
~/.codex/config.json - Windows:
%USERPROFILE%\.codex\config.json
- macOS / Linux:
-
Pievienojiet Wink MCP serveru ierakstus:
~/.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"}}} -
Sāciet Codex. Pirmo reizi tas atver pārlūkprogrammas cilni uz
https://iam.wink.travel. -
Pierakstieties Wink un apstipriniet pieprasītās atļaujas.
-
Codex apstiprina savienojumu. Palaidiet
codexun lūdziet uzskaitīt pieejamos rīkus, lai pārbaudītu, vai Wink serveri ir aktīvi.
MCP serveru atbalsts ir pieejams ChatGPT darbvirsmas lietotnē Plus, Pro, Team un Enterprise abonentiem.
-
Lejupielādējiet un instalējiet ChatGPT darbvirsmas lietotni, ja vēl neesat to izdarījis.
-
Atveriet lietotni un noklikšķiniet uz savā profila ikonā augšējā labajā stūrī, pēc tam izvēlieties Iestatījumi.
-
Dodieties uz Savienotāji (vai MCP serveri atkarībā no jūsu lietotnes versijas) un noklikšķiniet uz Pievienot.
-
Ievadiet rīku komplekta URL no augstāk redzamā katalogā, piemēram:
https://api.wink.travel/mcp/extranet/ratesPēc tam noklikšķiniet uz Savienot.
-
ChatGPT atver pārlūkprogrammas cilni uz
https://iam.wink.travel. Pierakstieties Wink un apstipriniet atļaujas. -
Atkārtojiet 4.–5. soli ar citiem nepieciešamajiem rīku komplektiem, piemēram:
https://api.wink.travel/mcp/extranet/operations -
Katrs rīku komplekts parādās jūsu Savienotāju sarakstā. Sāciet jaunu tērzēšanu — Wink rīki ir pieejami automātiski.
-
Atveriet (vai izveidojiet) Cursor MCP konfigurācijas failu:
- macOS / Linux:
~/.cursor/mcp.json - Windows:
%USERPROFILE%\.cursor\mcp.json
- macOS / Linux:
-
Pievienojiet Wink MCP serveru ierakstus:
~/.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"}}} -
Atveriet Cursor. Dodieties uz Iestatījumi → Cursor iestatījumi → MCP un pārliecinieties, ka abi serveri parādās ar zaļu statusa indikatoru. Ja tie ir sarkani, noklikšķiniet uz Atjaunot.
-
Cursor atver pārlūkprogrammas cilni uz
https://iam.wink.travel. Pierakstieties Wink un apstipriniet atļaujas. -
Atveriet tērzēšanu (
Ctrl+L/Cmd+L) un lūdziet Cursor uzskaitīt pieejamos Wink rīkus, lai apstiprinātu savienojumu.
-
Atveriet (vai izveidojiet) Windsurf MCP konfigurācijas failu:
- macOS / Linux:
~/.codeium/windsurf/mcp_config.json - Windows:
%USERPROFILE%\.codeium\windsurf\mcp_config.json
- macOS / Linux:
-
Pievienojiet Wink MCP serveru ierakstus:
~/.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"}}} -
Pilnībā restartējiet Windsurf (Fails → Iziet, pēc tam atveriet no jauna).
-
Dodieties uz Iestatījumi → MCP serveri un pārliecinieties, ka abi serveri ir savienoti. Windsurf pirmo reizi atver pārlūkprogrammas cilni uz
https://iam.wink.travel. -
Pierakstieties Wink un apstipriniet atļaujas. Serveri iedegas zaļi iestatījumu panelī, kad autentifikācija ir veiksmīga.
Cline ir VS Code paplašinājums ar iebūvētu MCP serveru pārvaldnieku. Nav nepieciešama manuāla JSON rediģēšana.
-
Instalējiet Cline no VS Code Marketplace:
- Atveriet VS Code un nospiediet
Ctrl+Shift+X/Cmd+Shift+X - Meklējiet Cline un noklikšķiniet uz Instalēt
- Atveriet VS Code un nospiediet
-
Noklikšķiniet uz Cline ikonas aktivitāšu joslā (kreisajā sānjoslā), lai atvērtu Cline paneli.
-
Noklikšķiniet uz MCP serveru ikonas (spraudņa ikona) Cline rīkjoslā, pēc tam izvēlieties Rediģēt MCP iestatījumus.
-
VS Code atver
cline_mcp_settings.json. Pievienojiet Wink ierakstus: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"}}} -
Saglabājiet failu. Cline automātiski pārlādējas un atver pārlūkprogrammas cilni uz
https://iam.wink.travel. -
Pierakstieties Wink un apstipriniet atļaujas. Abi serveri parādās kā aktīvi MCP serveru panelī.
Atļauju jomas
Section titled “Atļauju jomas”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.readmcp.writemcp.removejomas ir papildus nepieciešamas, lai atvērtu MCP transportu. Klients armcp.*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.
Problēmu novēršana
Section titled “Problēmu novēršana”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:
# Claude Codeclaude mcp remove wink-ratesclaude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport httpClaude 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
