MCP þjónar
MCP verkfæri Wink eru birt sem verkfærasett — sérhæfðir endapunktar, hver og einn fyrir eitt verkefni. Þú tengir AI viðskiptavininn þinn við einn eða tvo sem passa við vinnuna þína, ekki alla.
Hver endapunktur notar gagnvirka OAuth2 innskráningu (PKCE heimildarkóðaferli): AI-umboðsmaðurinn þinn opnar vafraglugga, þú skráir þig inn með Wink reikningnum þínum, og það er það. Engar viðskiptavina leyndarmál til að stjórna.
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 httpAf hverju verkfærin eru skipt á milli endapunkta
Section titled “Af hverju verkfærin eru skipt á milli endapunkta”Wink býður um 500 verkfæri. Að gefa öllum þeim til umboðsmanns í einu er tæknilega mögulegt — en slæm hugmynd.
Verkfæra skilgreiningar kosta samhengi. Hvert verkfæri sem MCP þjónn auglýsir er hlaðið inn í samhengi líkanins áður en það vinnur, ásamt lýsingu og fullri breytusniðmáti. Fimm hundruð þeirra taka stóran hluta af fjárhagsáætlun sem raunverulegt verkefni þitt þarf, í hverri beiðni.
Gæði valkosta minnka þegar listinn stækkar. Umboðsmaður sem velur úr 500 svipuðum verkfærum gerir verri val en sá sem velur úr 40. Ef þú samþættir channel manager eru um tuttugu verkfæri viðeigandi fyrir þig; hin 480 eru hávaði sem gerir rétt verkfæri erfiðara að finna.
Verkefnið er raunverulega aðskiljanlegt. Sá sem samstillir framboð úr PMS og sá sem sér um samstarfsaðila lendingssíður deila næstum engum verkfærum. Að skipta eftir verkefni þýðir að hver tenging ber orðaforða eins verkefnis.
Endapunkta skrá
Section titled “Endapunkta skrá”Tveir hýsingarþjónar þjónusta verkfærasett. Fjöldi verkfæra er áætlaður og vex með tímanum.
https://api.wink.travel — vettvangurinn
Section titled “https://api.wink.travel — vettvangurinn”| Endapunktur | Verkfæri | Hvað það nær yfir |
|---|---|---|
/mcp/extranet/facilities | ~64 | Bókanlegt og staðbundið birgðasafn: gestaherbergi og herbergistegundir, heilsulindir, veitingastaðir, fundarherbergi, afþreying, aðdráttarafl, staðir, önnur seljanleg atriði |
/mcp/extranet/property | ~62 | Skrá eignar og viðskiptaskilmálar: prófíll og efni, viðbætur, afbókunarskilmálar, fríðindi, tilkynningar |
/mcp/settings | ~60 | Reikningsstjórnun: prófíll og vörumerki stjórnunareiningar, stjórnendur og heimildir þeirra, sérsnið, vefkranar, tilkynningastillingar |
/mcp/studio/embeds | ~48 | Birting valinna birgða: búnaður, grindur og raðaðar grindur, spil, kort, djúplenkir á birgðir og birgjavefi |
/mcp/extranet/rates | ~44 | Verð og framboð: verðtímabil og úthlutanir, verðáætlanir, aðalverð, sér- og kynningarverð |
/mcp/extranet/operations | ~39 | Rekstur lifandi eignar: bókanir og lífsferill þeirra, gestagagnrýni og svör, dagatalsstraumar, skipulagðar aðgerðir |
/mcp/extranet/distribution | ~37 | Hvar birgðir eru seldar: sölurásir og verðbreytur, beiðnir um samstarfsaðila og birgja, skráning, leiðtogaöflun |
/mcp/studio/curation | ~35 | Uppbygging söluhæfra safna: föst og breytileg listi, raðaðar listi, vistaðar leitir, eignasafn |
/mcp/link-manager | ~28 | Samnýtt safn tengla, hönnun þeirra, flokka og merki, auk styttingar á slóðum |
/mcp/reference | ~24 | Lesa-einungis uppflettigögn: lönd, gjaldmiðlar og gengisbreytingar, tungumál, tímabelti, landfræðilegar uppflettingar, IP staðsetning |
/mcp/analytics | ~18 | Bókunar- og tekjugreiningar: yfirlit, línurit, stigatöflur, frammistaða samstarfsaðila, hlutdeildarmælingar |
/mcp/payment | ~18 | Fjármálarekstur: bókhald, úttektir og kostnaðaráætlanir, safn bókunarfjármuna |
/mcp/booking-engine | ~17 | Kaupferli ferðalangs: leit og uppfletting, innkaupakarfa og greiðsla, óskalistar, herferðarsérsnið |
/mcp/social | ~17 | Tengdir samfélagsreikningar, birting og tímasetning pósta, lestur innsýna í pósta |
/mcp/travel-agent | ~8 | Bókanir gerðar af umboðsmönnum fyrir ferðalanga, og skýrslur umboðsmanna |
https://integrations.wink.travel — samþættingar channel manager
Section titled “https://integrations.wink.travel — samþættingar channel manager”Einn endapunktur, því þessi hýsing er fyrir eitt verkefni.
| Endapunktur | Verkfæri | Hvað það nær yfir |
|---|---|---|
/mcp/channel-manager | ~9 | Tenging og staðfesting channel manager, PMS eða CRS samþættingar |
Hver endapunktur ber einnig með sér ping verkfæri, svo þú getir staðfest að tenging sé virk áður en þú biður um raunverulega vinnu.
Agentic greiðslur
Section titled “Agentic greiðslur”Fyrir fullkomið bókunarferli ferðalangs, tengdu Wink Booking Engine á https://api.wink.travel/mcp/booking-engine og samhæft greiðsluvösu. Að bæta við Wink MCP opnar vafra fyrir innskráningu og heimildaval; viðskiptavinurinn þinn sér um auðkenningu.
Booking Engine inniheldur áfangastaðaleit, hótel- og herbergjaleit, agentic_booking_quote, agentic_booking_pay, agentic_booking_book, bókunarheimt og kvittanir, þegar agentic bókun og greiðsla eru virkjuð fyrir umhverfið. Sjá Agentic Payments fyrir uppsetningu tengingar, heimildir til að velja og skref frá leit að staðfestingu.
Hvaða verkfærasett þarf ég?
Section titled “Hvaða verkfærasett þarf ég?”| Ef þú ert… | Tengdu við |
|---|---|
| Samþættir channel manager, PMS eða CRS | integrations.wink.travel/mcp/channel-manager — bara þetta eitt |
| Stjórnar efni eignar | /mcp/extranet/property + /mcp/extranet/facilities |
| Stjórnar herbergjum og herbergistegundum | /mcp/extranet/facilities |
| Stjórnar verði og framboði | /mcp/extranet/rates |
| Rekur daglegar bókanir | /mcp/extranet/operations |
| Eykur dreifingu | /mcp/extranet/distribution + /mcp/analytics |
| Byggir samstarfsaðila síður | /mcp/studio/curation + /mcp/studio/embeds |
| Rekur link-in-bio síður | /mcp/link-manager + /mcp/social |
| Bókar fyrir hönd ferðalanga | /mcp/travel-agent |
| Samræmir fjármál | /mcp/payment |
| Bókar herbergi með AI umboðsmanni | /mcp/booking-engine + samhæfð greiðsluvösu — sjá Agentic Payments |
| Byggir bókunarupplifun | /mcp/booking-engine; valfrjálst /mcp/reference fyrir aukalegar uppflettingar |
Booking Engine inniheldur kjarnabókunarferlið. Það býður upp á reiknings- og sérsniðsupplýsingar, áfangastaðaleit, hótel- og herbergisverðaupplýsingar, innkaupakörfur, greiðslu og stjórnun bókana ferðalanga. Agentic bókunar- og greiðslutól eru einnig innifalin þegar þau eru virkjuð fyrir umhverfið.
Fyrir borgargrundaða hótelleit, notaðu destination_lookup_search_suggestions til að leysa áfangastaðinn, síðan inventory_search_city til að finna fáanleg hótel og verð. Bæði verkfæri eru í /mcp/booking-engine, svo þetta ferli krefst ekki tengingar við Reference.
Bættu við /mcp/reference þegar þú þarft stuðningsuppflettingar eins og lönd, gjaldmiðla og gengisbreytingar, studd tungumál, tímabelti, víðtækari landfræðilegar leitar, OTA flokkun eða opinberar eignaupplýsingar. Þetta eru valfrjáls viðbætur við bókunarferlið.
Byrjaðu á einu. Bættu við öðru þegar þú finnur þig spyrja um eitthvað sem það getur ekki gert — hver tenging er sjálfstæð og að bæta við einni hefur aldrei áhrif á aðrar.
Hvernig auðkenning virkar
Section titled “Hvernig auðkenning virkar”Wink MCP þjónar nota OAuth2 Authorization Code + PKCE ferlið og styðja Dynamic Client Registration (RFC 7591). Þetta gerist þegar þú tengir í fyrsta sinn:
- AI viðskiptavinurinn þinn finnur auðkenningarþjóninn úr MCP endapunktinum
/.well-known/oauth-protected-resourcelýsingu. - Viðskiptavinurinn skráir sig sjálfur með Dynamic Client Registration — engin handvirk umsóknaruppsetning nauðsynleg.
- Viðskiptavinurinn opnar vafraglugga á
https://iam.wink.travel. Þú skráir þig inn með Wink reikningnum þínum og samþykkir beiðnar heimildir á samþykkisskjánum. - Wink gefur út aðgangstákna bundinn við reikninginn þinn og auðkenni.
- AI viðskiptavinurinn festir táknann við hverja MCP beiðni. Öll verkfæri eru sjálfkrafa bundin við stjórnunareiningu þína.
- Tákn renna út eftir 3 klukkustundir. AI viðskiptavinurinn endurnýjar þau hljóðlaust í bakgrunni án frekari beiðna.
Hver verkfærakall keyrir undir þínu auðkenni — sömu aðgangsreglur og verja vefsvæðið gilda um AI umboðsmanninn.
Tengdu AI viðskiptavininn þinn
Section titled “Tengdu AI viðskiptavininn þinn”-
Gakktu úr skugga um að Claude Code sé uppfærður:
Terminal window npm install -g @anthropic-ai/claude-code -
Veldu verkfærasett úr skránni hér að ofan og bættu því við. Til dæmis verð og framboð:
Terminal window claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http -
Claude Code tengist þjóninum, finnur auðkenningarþjóninn og opnar sjálfgefinn vafra.
-
Skráðu þig inn í Wink og samþykktu heimildarbeiðnina á samþykkisskjánum.
-
Claude Code staðfestir tenginguna. Sláðu inn
/mcptil að staðfesta að þjónninn birtist og verkfærin hafi hlaðist.
Bættu við eins mörgum verkfærasettum og vinnan þín krefst — hvert er sér þjónn með eigin nafni:
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 httpÞú skráir þig aðeins inn einu sinni. Eftir fyrstu vafra samþykktina notar Claude Code Wink lotuna þína fyrir fleiri Wink endapunkta.
-
Breyttu stillingarskránni fyrir Claude Desktop:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
- macOS:
-
Bættu við MCP þjónnaskrám:
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"}}} -
Lokaðu alveg og ræstu Claude Desktop aftur (notaðu Quit úr valmyndastikunni — að loka glugga er ekki nóg).
-
Claude Desktop opnar vafraglugga fyrir hvern nýjan þjón. Skráðu þig inn í Wink og samþykktu heimildir.
-
Tengi-tákn í neðri tólstikunni sýnir báða þjónana sem tengda.
-
Gakktu úr skugga um að Codex CLI sé uppsett:
Terminal window npm install -g @openai/codex -
Opnaðu (eða búðu til) Codex stillingarskrána:
- macOS / Linux:
~/.codex/config.json - Windows:
%USERPROFILE%\.codex\config.json
- macOS / Linux:
-
Bættu við Wink MCP þjónnaskrám:
~/.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"}}} -
Ræstu Codex. Í fyrsta skipti opnar Codex vafraglugga á
https://iam.wink.travel. -
Skráðu þig inn í Wink og samþykktu beiðnar heimildir.
-
Codex staðfestir tenginguna. Keyrðu
codexog biðjið um lista yfir tiltæk verkfæri til að staðfesta að Wink þjónarnir séu virkir.
Stuðningur við MCP þjónustu er í boði í ChatGPT skjáborðsforritinu fyrir Plus, Pro, Team og Enterprise áskrifendur.
-
Sæktu og settu upp ChatGPT skjáborðsforritið ef þú hefur ekki gert það.
-
Opnaðu forritið og smelltu á prófílmyndina þína efst til hægri, veldu svo Stillingar.
-
Farðu í Tengingar (eða MCP Servers eftir útgáfu) og smelltu á Bæta við.
-
Sláðu inn slóð verkfærasets úr skránni hér að ofan, til dæmis:
https://api.wink.travel/mcp/extranet/ratesSmelltu svo á Tengja.
-
ChatGPT opnar vafraglugga á
https://iam.wink.travel. Skráðu þig inn í Wink og samþykktu heimildir. -
Endurtaktu skref 4–5 fyrir önnur verkfærasett sem vinnan þín þarf, til dæmis:
https://api.wink.travel/mcp/extranet/operations -
Hvert verkfærasett birtist í tengingalistanum þínum. Byrjaðu nýjan spjall — Wink verkfæri eru sjálfkrafa tiltæk.
-
Opnaðu (eða búðu til) Cursor MCP stillingarskrána:
- macOS / Linux:
~/.cursor/mcp.json - Windows:
%USERPROFILE%\.cursor\mcp.json
- macOS / Linux:
-
Bættu við Wink MCP þjónnaskrám:
~/.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"}}} -
Opnaðu Cursor. Farðu í Stillingar → Cursor Stillingar → MCP og staðfestu að báðir þjónar birtist með grænum stöðutákni. Ef þeir sýna rauðan, smelltu á Endurnýja.
-
Cursor opnar vafraglugga á
https://iam.wink.travel. Skráðu þig inn í Wink og samþykktu heimildir. -
Opnaðu spjall (
Ctrl+L/Cmd+L) og biðjið Cursor um að lista yfir tiltæk Wink verkfæri til að staðfesta tenginguna.
-
Opnaðu (eða búðu til) Windsurf MCP stillingarskrána:
- macOS / Linux:
~/.codeium/windsurf/mcp_config.json - Windows:
%USERPROFILE%\.codeium\windsurf\mcp_config.json
- macOS / Linux:
-
Bættu við Wink MCP þjónnaskrám:
~/.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"}}} -
Endurræstu Windsurf alveg (Skrá → Hætta, opnaðu svo aftur).
-
Farðu í Stillingar → MCP Servers og staðfestu að báðir þjónar sýni sem tengdir. Windsurf opnar vafraglugga á
https://iam.wink.travelí fyrsta skipti. -
Skráðu þig inn í Wink og samþykktu heimildir. Þjónarnir verða grænir í stillingum þegar auðkenning er staðfest.
Cline er VS Code viðbót með innbyggðum MCP þjónastjóra. Engin handvirk JSON breyting er nauðsynleg.
-
Settu upp Cline úr VS Code Marketplace:
- Opnaðu VS Code og ýttu á
Ctrl+Shift+X/Cmd+Shift+X - Leitaðu að Cline og smelltu á Install
- Opnaðu VS Code og ýttu á
-
Smelltu á Cline táknið í Activity Bar (vinstri hliðarstiku) til að opna Cline gluggann.
-
Smelltu á MCP Servers táknið (tengi tákn) í Cline tólstikunni, veldu svo Edit MCP Settings.
-
VS Code opnar
cline_mcp_settings.json. Bættu við Wink færslunum: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"}}} -
Vistaðu skrána. Cline hleður aftur sjálfkrafa og opnar vafraglugga á
https://iam.wink.travel. -
Skráðu þig inn í Wink og samþykktu heimildir. Báðir þjónar birtast sem virkir í MCP Servers glugganum.
Heimildir
Section titled “Heimildir”Þegar þú samþykkir samþykkisskjáinn sérðu sundurliðun á því sem umboðsmaðurinn biður um. MCP viðskiptavinir nota sama heimildamál og restin af vettvangnum — sjá fulla heimildaskráningu á Auðkenningarsíðu.
Tveir hlutir eru sértækir fyrir MCP:
mcp.readmcp.writemcp.removeheimildir eru aukalega nauðsynlegar til að opna MCP flutningsrásina. Viðskiptavinur meðmcp.*heimild fær aðgang að öllum Wink MCP endapunktum, en hvert verkfæri sem hann kallar fram framfylgir samt heimildum endapunktsins sem það umlykur (t.d.booking.read).- AI viðskiptavinurinn biður aðeins um þær heimildir sem hann þarf. Þú getur neitað einstökum heimildum á samþykkisskjánum — verkfæri sem krefjast neitaðrar heimildar skila villu þegar þau eru kölluð.
Verkfærasett breyta engu af þessu. Endapunkturinn sem þú tengir við ákveður hvaða verkfæri eru skráð,
ekki hvað þeim er heimilt að gera. Að tengjast /mcp/payment veitir engar fjármálalegar heimildir sem þú
hafðir ekki fyrir, og að tengjast /mcp/reference hindrar ekki verkfæri þar í að framfylgja
sinn eigin heimildum. Heimildastýring er ákvörðuð fyrir hvert verkfærakall, út frá tákninu þínu og heimildum reikningsins.
Villuleit
Section titled “Villuleit”Vafragluggi opnast ekki
AI viðskiptavinurinn þinn styður kannski ekki gagnvirka PKCE ferlið ennþá. Gakktu úr skugga um að þú sért með nýjustu útgáfu:
- Claude Code:
npm install -g @anthropic-ai/claude-code - Codex CLI:
npm install -g @openai/codex - Claude Desktop / ChatGPT skjáborð: uppfærðu með innbyggðum uppfærslutæki appsins
401 Unauthorized eftir innskráningu
Geymdur aðgangstákn þitt gæti verið úrelt. Fjarlægðu og bættu þjóninum aftur til að kveikja á nýrri innskráningu:
# Claude Codeclaude mcp remove wink-ratesclaude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport httpFyrir Claude Desktop og ChatGPT, fjarlægðu þjóninn úr stillingum, ræstu forritið aftur og bættu honum við á ný.
403 Forbidden þegar kallað er á ákveðið verkfæri
Verkfærið krefst heimildar sem þú hafðir ekki samþykkt á samþykkisskjánum, eða heimildar sem reikningurinn þinn hefur ekki. Tengdu þjóninn aftur — samþykkisskjárinn birtist á ný og þú getur samþykkt vantar heimild. Ef það bilar enn, þarf verkfærið aðgang sem þú hefur ekki; að tengjast öðru verkfærasetti hjálpar ekki, því verkfærasett veita ekki heimildir.
Verkfærið sem ég þarf er ekki á listanum
Þú ert líklega tengdur við verkfærasett sem nær ekki yfir það verkefni. Skoðaðu endapunkta skrána og bættu við verkfærasetti sem nær yfir það — tengingar eru sjálfstæðar, svo að bæta við einu breytir engu um hin. Ef þú ert óviss um hvaða setti það er, tengdu tímabundið við https://api.wink.travel/mcp, finndu verkfærið og athugaðu hvaða verkfærasett skráir það.
404 Not Found á endapunkti verkfærasets
Athugaðu slóðina vel — innbyggðu verkfærasettin hafa tvö stig (/mcp/extranet/rates, ekki /mcp/extranet-rates), og þau flötu hafa eitt (/mcp/link-manager). Athugaðu að óauðkennd beiðni á hvaða slóð undir /mcp sem er skilar 401, ekki 404, svo 401 segir ekki hvort endapunkturinn sé til.
Ég tengdist api.wink.travel/mcp/channel-manager og fékk ekkert
Sá endapunktur er ekki til. Channel manager samþætting er aðeins í boði á https://integrations.wink.travel/mcp/channel-manager. Ef þú þarft líka að lesa eða breyta eigin verðskrá handvirkt, er það annað verkefni á öðrum endapunkti — sjá /mcp/extranet/rates.
Þjónninn birtist en verkfæraköll skila “account not found”
Þú ert skráður inn með Wink reikningi sem hefur enga stjórnunareiningu. Farðu á Wink Portal og tryggðu að reikningurinn þinn sé rétt stilltur áður en þú notar MCP þjóninn.
Tákn rennur út á miðju tímabili
Tákn eru gild í 3 klukkustundir. Claude Code og Claude Desktop endurnýja tákn hljóðlaust án truflunar. Ef þú sérð auðkennisvillur eftir langa kyrrsetu, sendu nýja skilaboð — viðskiptavinurinn auðkennir sig sjálfkrafa aftur.
Codex CLI sýnir “MCP server unreachable”
Athugaðu að ~/.codex/config.json sé gilt JSON (engin aukakomma) og að "type": "http" sé stillt. Codex krefst HTTP flutnings fyrir fjarþjóna; stdio flutningur er aðeins fyrir staðbundna keyrslu.
ChatGPT “Connectors” valmynd vantar
MCP stuðningur krefst ChatGPT skjáborðsforrits útgáfu 1.2024.352 eða nýrri og virks Plus, Pro, Team eða Enterprise áskriftar. Uppfærðu forritið og athugaðu áætlun í Stillingar → Reikningur.
Cursor þjónn sýnir rauðan / “Failed to connect”
Gakktu úr skugga um að ~/.cursor/mcp.json sé gilt JSON og innihaldi "type": "http". Farðu svo í Stillingar → Cursor Stillingar → MCP og smelltu á Endurnýja. Ef villan heldur áfram, endurræstu Cursor alveg — stillingabreytingar eru ekki alltaf sóttar án endurræsingar.
Windsurf MCP þjónar birtast ekki í stillingum
Windsurf krefst fullrar endurræsingar (ekki bara gluggahleðslu) til að taka breytingar á mcp_config.json upp. Notaðu Skrá → Hætta og ræstu aftur. Ef þjónar birtast ekki, staðfestu að þú sért með Windsurf 1.4+ í Hjálp → Um Windsurf.
Cline “Add Server” valkostur er ekki sýnilegur
MCP þjónastjóri krefst Cline 2.0 eða nýrri. Opnaðu VS Code Extensions gluggann, finndu Cline og smelltu á Update ef uppfærsla er í boði. Eftir uppfærslu, endurhlaða VS Code (Ctrl+Shift+P → “Developer: Reload Window”).
Opna Wink Portal Wink á GitHub
