Skip to content

Mga MCP Server

Ang mga MCP tool ng Wink ay ipinapublish bilang toolsets — mga nakatuong endpoints, bawat isa ay sumasaklaw sa isang trabaho. Ikokonekta mo ang iyong AI client sa isa o dalawang tumutugma sa iyong trabaho, hindi sa lahat.

Bawat endpoint ay gumagamit ng interactive OAuth2 login (PKCE authorization code flow): magbubukas ang iyong AI agent ng browser tab, mag-sign in ka gamit ang iyong Wink account, at iyon na. Walang kailangang i-manage na client secrets.

Isang channel manager integrator ang kumokonekta sa isang endpoint
claude mcp add wink-channel-manager https://integrations.wink.travel/mcp/channel-manager --transport http
Isang hotelier na nagma-manage ng sariling mga rate ang kumokonekta sa isa pa
claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http

Bakit hinati ang mga tool sa iba’t ibang endpoints

Section titled “Bakit hinati ang mga tool sa iba’t ibang endpoints”

Nag-eexpose ang Wink ng humigit-kumulang 500 tool. Posibleng ibigay lahat ito sa isang agent nang sabay-sabay — ngunit hindi ito magandang ideya.

Ang mga depinisyon ng tool ay kumakain ng context. Bawat tool na ina-advertise ng isang MCP server ay niloload sa context window ng modelo bago ito gumawa ng anumang trabaho, kasama ang paglalarawan at buong parameter schema nito. Limang daan sa mga iyon ay kumokonsumo ng malaking bahagi ng budget na kailangan ng iyong aktwal na gawain, sa bawat request.

Bumababa ang kalidad ng pagpili habang lumalaki ang listahan. Ang isang agent na pumipili mula sa 500 na halos magkaparehong pangalan ng tool ay gumagawa ng mas mahihirap na pagpili kaysa sa isang pumipili mula sa 40. Kung nag-iintegrate ka ng channel manager, mga dalawampung tool lang ang may kaugnayan sa iyo; ang iba pang 480 ay ingay na nagpapahirap hanapin ang tamang tool.

Ang trabaho ay tunay na nahahati. Ang isang tao na nagsi-sync ng availability mula sa PMS at ang isang tao na nagcu-curate ng affiliate landing pages ay halos walang pinagsasaluhang tool. Ang paghahati ayon sa trabaho ay nangangahulugan na bawat koneksyon ay nagdadala ng bokabularyo ng isang trabaho.


Dalawang host ang nagseserbisyo ng mga toolset. Ang bilang ng mga tool ay tinatayang at lumalaki sa paglipas ng panahon.

EndpointMga ToolSaklaw nito
/mcp/extranet/facilities~64Ang bookable at on-site na imbentaryo: mga guest room at uri ng kuwarto, spa, mga restawran, mga meeting room, mga aktibidad, atraksyon, mga lugar, at iba pang mga item na maaaring ibenta
/mcp/extranet/property~62Ang rekord ng property at mga komersyal na termino nito: profile at nilalaman, mga add-on, mga patakaran sa pagkansela, mga benepisyo, mga anunsyo
/mcp/settings~60Pamamahala ng account: profile at branding ng managing entity, mga manager at kanilang mga grant, customisasyon, webhooks, mga preference sa notification
/mcp/studio/embeds~48Pagpapublish ng curated na imbentaryo: mga widget, grids at ranked grids, mga card, mapa, mga deep link sa imbentaryo at mga pahina ng supplier
/mcp/extranet/rates~44Mga presyo at availability: mga rate period at allotment ng imbentaryo, mga rate plan, master rates, espesyal at promotional rates
/mcp/extranet/operations~39Pamamahala ng isang live na property: mga reservation at lifecycle nito, mga review ng guest at mga tugon, mga calendar feed, mga naka-schedule na gawain
/mcp/extranet/distribution~37Kung saan ibinebenta ang imbentaryo: mga sales channel at mga rate modifier, mga kahilingan sa relasyon ng affiliate at supplier, pagpaparehistro, lead capture
/mcp/studio/curation~35Pagbuo ng mga merchandisable na koleksyon: static at dynamic na listahan, ranked list, mga saved search, mga aggregate ng property
/mcp/link-manager~28Mga syndicated link collection, disenyo nito, mga kategorya at tag, pati na rin ang pinaikling URL
/mcp/reference~24Read-only na lookup data: mga bansa, mga pera at exchange rate, mga wika, mga timezone, geo lookup, IP geolocation
/mcp/analytics~18Booking at revenue analytics: mga overview, line chart, leaderboard, performance ng affiliate, mga metric ng share
/mcp/payment~18Mga financial operation: ledger, withdrawal at fee estimate, mga aggregate ng booking funds
/mcp/booking-engine~17Ang shopping path para sa mga biyahero: paghahanap at lookup, shopping cart at checkout, bucket list, customisasyon ng kampanya
/mcp/social~17Mga konektadong social account, pag-publish at pag-schedule ng mga post, pagbabasa ng post insights
/mcp/travel-agent~8Mga booking na pinadali ng agent para sa mga biyahero, at mga ulat ng agent

https://integrations.wink.travel — mga integrasyon ng channel manager

Section titled “https://integrations.wink.travel — mga integrasyon ng channel manager”

Isang endpoint lang, dahil ang host na ito ay para sa isang trabaho lang.

EndpointMga ToolSaklaw nito
/mcp/channel-manager~9Pagkonekta at pag-verify ng channel manager, PMS o CRS integration

Bawat endpoint ay may kasamang ping tool, kaya maaari mong kumpirmahin na live ang koneksyon bago ito utusan ng totoong trabaho.


Kung ikaw ay…Kumonekta sa
Nag-iintegrate ng channel manager, PMS o CRSintegrations.wink.travel/mcp/channel-manager — ito lang
Nagma-manage ng nilalaman ng property/mcp/extranet/property + /mcp/extranet/facilities
Nagma-manage ng mga kuwarto at uri ng kuwarto/mcp/extranet/facilities
Nagma-manage ng mga presyo at availability/mcp/extranet/rates
Nagpapatakbo ng araw-araw na mga reservation/mcp/extranet/operations
Nagpapalago ng distribution/mcp/extranet/distribution + /mcp/analytics
Gumagawa ng mga affiliate page/mcp/studio/curation + /mcp/studio/embeds
Nagpapatakbo ng link-in-bio pages/mcp/link-manager + /mcp/social
Nagbu-booking para sa mga biyahero/mcp/travel-agent
Nagre-reconcile ng pera/mcp/payment
Gumagawa ng booking experience/mcp/booking-engine + /mcp/reference

Magsimula sa isa. Magdagdag ng isa pa kapag kailangan mo ng isang bagay na hindi nito magagawa — bawat koneksyon ay independyente, at ang pagdagdag ng isa ay hindi nakakaapekto sa iba.


Gumagamit ang mga MCP server ng Wink ng OAuth2 Authorization Code + PKCE flow at sumusuporta sa Dynamic Client Registration (RFC 7591). Ganito ang nangyayari kapag kumonekta ka sa unang pagkakataon:

  1. Nadidiskubre ng iyong AI client ang authorization server mula sa /.well-known/oauth-protected-resource metadata ng MCP endpoint.
  2. Nagse-self-register ang client gamit ang Dynamic Client Registration — walang kailangang manual na setup ng application.
  3. Nagbubukas ang client ng browser tab sa https://iam.wink.travel. Mag-sign in ka gamit ang iyong Wink account at aprubahan ang mga hinihinging permiso sa consent screen.
  4. Nag-iisyu ang Wink ng access token na naka-scope sa iyong account at naka-link sa iyong pagkakakilanlan.
  5. Ina-attach ng AI client ang token sa bawat MCP request. Lahat ng resulta ng tool ay awtomatikong naka-scope sa iyong managing entity.
  6. Nag-e-expire ang mga token pagkatapos ng 3 oras. Silent na nire-refresh ng iyong AI client ang mga ito sa background nang hindi na muling humihingi ng pahintulot.

Bawat tawag sa tool ay tumatakbo sa ilalim ng iyong pagkakakilanlan — ang parehong mga patakaran ng ACL na nagpoprotekta sa web portal ay nalalapat sa AI agent.


  1. Siguraduhing updated ang Claude Code:

    Terminal window
    npm install -g @anthropic-ai/claude-code
  2. Pumili ng toolset mula sa directory sa itaas at idagdag ito. Halimbawa, para sa mga presyo at availability:

    Terminal window
    claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http
  3. Kinokontak ng Claude Code ang server, nadidiskubre ang authorization server, at binubuksan ang iyong default browser.

  4. Mag-sign in sa Wink at aprubahan ang request ng permiso sa consent screen.

  5. Kinukumpirma ng Claude Code ang koneksyon. I-type ang /mcp para i-verify na lumitaw ang server at na-load ang mga tool nito.

Magdagdag ng maraming toolset hangga’t kailangan ng iyong trabaho — bawat isa ay hiwalay na server entry na may sariling pangalan:

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

Isang beses ka lang mag-sign in. Pagkatapos ng unang pag-apruba sa browser, nire-reuse ng Claude Code ang iyong Wink session para sa karagdagang mga Wink endpoint.


Kapag inaprubahan mo ang consent screen makikita mo ang breakdown ng hinihingi ng agent. Gumagamit ang mga MCP client ng parehong bokabularyo ng permiso tulad ng buong platform — tingnan ang buong scope reference sa Authentication page.

Dalawang bagay ang partikular sa MCP:

  • Kinakailangan din ang mga scope na mcp.read mcp.write mcp.remove para mabuksan ang MCP transport. Ang client na may hawak na mcp.* scope ay pinapayagang pumasok sa anumang Wink MCP endpoint, ngunit bawat tool na tinatawag nito ay nagpapatupad pa rin ng section scope ng endpoint na kinabibilangan nito (hal. booking.read).
  • Humihiling lang ang AI client ng mga scope na kailangan nito. Maaari mong tanggihan ang indibidwal na permiso sa consent screen — ang mga tool na nangangailangan ng tinanggihan na scope ay magbabalik ng error kapag tinawag.

Hindi binabago ng mga toolset ang alinman dito. Ang endpoint na kinokonekta mo ang nagdedesisyon kung aling mga tool ang naka-lista, hindi kung ano ang pinapayagan. Ang pagkonekta sa /mcp/payment ay hindi nagbibigay ng karagdagang permiso sa pananalapi na wala ka pa, at ang pagkonekta sa /mcp/reference ay hindi pumipigil sa tool doon na ipatupad ang sariling scope nito. Ang awtorisasyon ay dinidesisyonan bawat tawag sa tool, mula sa iyong token at mga grant ng iyong account.


Hindi nagbubukas ang browser tab

Maaaring hindi pa sinusuportahan ng iyong AI client ang interactive PKCE flow. Siguraduhing tumatakbo ka ng bagong bersyon:

  • Claude Code: npm install -g @anthropic-ai/claude-code
  • Codex CLI: npm install -g @openai/codex
  • Claude Desktop / ChatGPT desktop: i-update mula sa built-in updater ng app

401 Unauthorized pagkatapos mag-sign in

Maaaring luma na ang iyong cached token. Alisin at idagdag muli ang server para mag-trigger ng bagong sign-in:

Terminal window
# Claude Code
claude mcp remove wink-rates
claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http

Para sa Claude Desktop at ChatGPT, alisin ang server entry sa settings, i-restart ang app, at idagdag muli.

403 Forbidden kapag tumatawag ng partikular na tool

Kailangan ng tool ng scope na hindi mo inaprubahan sa consent screen, o permiso na wala ang iyong account. Ikonekta muli ang server — lalabas ulit ang consent screen at maaari mong aprubahan ang nawawalang permiso. Kung hindi pa rin ito gumana, nangangailangan ang tool ng permiso ng account na wala ka; hindi makakatulong ang pagkonekta sa ibang toolset dahil hindi nagbibigay ng permiso ang mga toolset.

Walang tool na kailangan ko sa listahan

Malamang nakakonekta ka sa toolset na hindi sumasaklaw sa trabahong iyon. Tingnan ang endpoint directory at idagdag ang toolset na sumasaklaw — independyente ang mga koneksyon, kaya ang pagdagdag ng isa ay hindi nakakaapekto sa iba. Kung hindi ka sigurado kung alin ang may tool, pansamantalang kumonekta sa https://api.wink.travel/mcp, hanapin ang tool, at tingnan kung aling toolset ito kabilang.

404 Not Found sa toolset endpoint

Suriing mabuti ang path — ang mga nested toolset ay may dalawang segment (/mcp/extranet/rates, hindi /mcp/extranet-rates), at ang mga flat ay may isa (/mcp/link-manager). Tandaan na ang hindi authenticated na request sa anumang path sa ilalim ng /mcp ay nagbabalik ng 401, hindi 404, kaya ang 401 lang ay hindi nagsasabi kung umiiral ang endpoint.

Kumonekta ako sa api.wink.travel/mcp/channel-manager pero walang nangyari

Walang ganoong endpoint. Ang channel manager integration ay nagseserbisyo lamang mula sa https://integrations.wink.travel/mcp/channel-manager. Kung kailangan mo ring basahin o baguhin ang sariling mga rate ng property nang mano-mano, ito ay hiwalay na trabaho sa hiwalay na endpoint — tingnan ang /mcp/extranet/rates.

Lumilitaw ang server pero ang mga tawag sa tool ay nagbabalik ng “account not found”

Naka-sign in ka sa Wink account na walang managing entity. Pumunta sa Wink Portal at siguraduhing naka-setup ang iyong account bago gamitin ang MCP server.

Nag-e-expire ang token habang session

Valid ang mga token ng 3 oras. Silent na nire-refresh ng Claude Code at Claude Desktop ang mga token nang hindi nilalabag ang session. Kung makakita ka ng auth error pagkatapos ng matagal na idle, mag-type ng bagong mensahe — magre-re-authenticate ang client nang awtomatiko.

Nagpapakita ang Codex CLI ng “MCP server unreachable”

Suriin na valid ang iyong ~/.codex/config.json (walang trailing commas) at naka-set ang "type": "http". Nangangailangan ang Codex ng HTTP transport para sa remote servers; ang stdio transport ay para lang sa local binaries.

Walang “Connectors” menu sa ChatGPT

Kailangan ng ChatGPT desktop app version 1.2024.352 o mas bago at aktibong Plus, Pro, Team, o Enterprise subscription ang suporta sa MCP. I-update ang app at tingnan ang iyong plano sa Settings → Account.

Nagpapakita ng pula / “Failed to connect” ang Cursor server

Suriin na valid ang iyong ~/.cursor/mcp.json at may "type": "http". Pumunta sa Settings → Cursor Settings → MCP at i-click ang Refresh. Kung patuloy ang error, ganap na i-restart ang Cursor — hindi palaging nakukuha ang mga pagbabago sa config nang walang restart.

Hindi nakalista ang Windsurf MCP servers sa settings

Kailangan ng Windsurf ng ganap na restart (hindi lang window reload) para makuha ang mga pagbabago sa mcp_config.json. Gamitin ang File → Quit at buksan muli. Kung hindi pa rin lumalabas, siguraduhing nasa Windsurf 1.4+ ka sa pamamagitan ng Help → About Windsurf.

Hindi nakikita ang “Add Server” option sa Cline

Kailangan ng MCP server manager ang Cline 2.0 o mas bago. Buksan ang VS Code Extensions panel, hanapin ang Cline, at i-click ang Update kung may available na update. Pagkatapos mag-update, i-reload ang VS Code (Ctrl+Shift+P → “Developer: Reload Window”).


Buksan ang Wink Portal Wink sa GitHub