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ðskiptaleyndarmá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 breytuskipan. 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 það bil 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, afpöntunarstefnur, fríðindi, tilkynningar |
/mcp/settings | ~60 | Reikningsstjórnun: prófíll og vörumerki stjórnunareiningar, stjórnendur og heimildir þeirra, sérsnið, vefkrokar, 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 síður birgja |
/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 samstarf 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 tenglasöfn, hönnun þeirra, flokka og merki, auk styttingar á slóðum |
/mcp/reference | ~24 | Lesaðgangsgögn: lönd, gjaldmiðlar og gengisvísar, tungumál, tímabelti, landfræðilegar leitir, IP staðsetning |
/mcp/analytics | ~18 | Bókunar- og tekjugreining: 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ðalanga: leit og uppfletting, innkaupakarfa og greiðsla, óskalistar, herferðarstillingar |
/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.
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 þennan |
| Stjórnar innihaldi 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 |
| Byggir bókunarupplifun | /mcp/booking-engine + /mcp/reference |
Byrjaðu á einu. Bættu við öðru þegar þú finnur þig biðja 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 heimildarkóða + PKCE ferlið og styðja Dynamic Client Registration (RFC 7591). Þetta gerist þegar þú tengir í fyrsta sinn:
- AI viðskiptavinurinn þinn finnur heimildarþjóninn úr MCP endapunktinum
/.well-known/oauth-protected-resourcemetadata. - 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ðgangslykil bundinn við reikninginn þinn og auðkenni.
- AI viðskiptavinurinn festir lykilinn við hverja MCP beiðni. Öll verkfæri eru sjálfkrafa bundin við stjórnunareiningu þína.
- Lyklar renna út eftir 3 klukkustundir. AI viðskiptavinurinn endurnýjar þá hljóðlaust í bakgrunni án frekari beiðna.
Hver verkfæra kalla 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 heimildarþjóninn og opnar sjálfgefinn vafra.
-
Skráðu þig inn í Wink og samþykktu beiðnina um heimildir á 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 þarf — 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 samþykkt í vafra endurnýtir 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 dugar ekki).
-
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ððu um lista yfir tiltæk verkfæri til að staðfesta að Wink þjónarnir séu virkir.
Stuðningur við MCP þjónar 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 í Tengla (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 í tenglalistanum þínum. Byrjaðu nýtt 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ænu stöðutákni. Ef þeir sýna rautt, 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ððu Cursor um að lista 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 innskráning 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ánum 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ð hvaða Wink MCP endapunkti sem er, 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álaheimildir sem þú hafðir ekki fyrir,
og að tengjast /mcp/reference hindrar ekki verkfæri þar í að framfylgja eigin heimildum. Heimildastýring er ákvörðuð fyrir hvert verkfæri út frá lykli þínum 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 lykill þinn gæti verið úreltur. 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ð reikningsheimild 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 hefur það, 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 einföldu 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æri 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.
Lykill rennur út á miðju tímabili
Lyklar gilda í 3 klukkustundir. Claude Code og Claude Desktop endurnýja lykla hljóðlaust án truflunar. Ef þú sérð auðkennisvillur eftir langa kyrrsetu, sláðu inn 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 staðfestu áskrift í Stillingar → Reikningur.
Cursor þjónn sýnir rautt / “Failed to connect”
Staðfestu 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 sést ekki
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, endurhleðslu VS Code (Ctrl+Shift+P → “Developer: Reload Window”).
Opna Wink Portal Wink á GitHub
