Skip to content

MCP Servers

Ang mga MCP tool ng Wink ay ipinapublish bilang toolsets — mga nakatuon na 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): nagbubukas ang iyong AI agent ng browser tab, mag-sign in ka gamit ang iyong Wink account, at iyon na iyon. 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 rates ay 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 — ngunit hindi magandang ideya.

Ang mga depinisyon ng tool ay kumakain ng context. Bawat tool na ina-advertise ng 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 mababang kalidad ng pagpili kaysa sa 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 taong nagsi-sync ng availability mula sa PMS at ang isang taong 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 toolsets. Ang bilang ng mga tool ay tinatayang at lumalaki sa paglipas ng panahon.

EndpointMga ToolSaklaw
/mcp/extranet/facilities~64Ang bookable at on-site na imbentaryo: mga guest room at uri ng kwarto, spa, restaurant, meeting room, aktibidad, atraksyon, 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, add-ons, mga patakaran sa pagkansela, perks, mga anunsyo
/mcp/settings~60Pamamahala ng account: profile at branding ng managing-entity, mga manager at kanilang mga grant, customization, webhooks, mga preference sa notification
/mcp/studio/embeds~48Pag-publish ng curated inventory: widgets, grids at ranked grids, cards, mapa, deep links sa inventory 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 live na property: mga reservation at lifecycle nito, mga review ng guest at tugon, calendar feeds, mga naka-schedule na gawain
/mcp/extranet/distribution~37Kung saan ibinebenta ang imbentaryo: mga sales channel at rate modifiers, mga kahilingan sa affiliate at supplier relationship, pagpaparehistro, lead capture
/mcp/studio/curation~35Pagbuo ng mga merchandisable na koleksyon: static at dynamic na listahan, ranked lists, mga saved search, mga aggregate ng property
/mcp/link-manager~28Mga syndicated link collection, disenyo nito, mga kategorya at tag, pati na rin pinaikling URL
/mcp/reference~24Read-only na lookup data: mga bansa, pera at exchange rate, mga wika, timezone, geo lookup, IP geolocation
/mcp/analytics~18Booking at revenue analytics: mga overview, line chart, leaderboard, performance ng affiliate, mga share metric
/mcp/payment~18Mga financial operation: ledger, withdrawal at fee estimate, booking funds aggregate
/mcp/booking-engine~17Ang shopping path para sa traveller: paghahanap at lookup, shopping cart at checkout, bucket list, campaign customization
/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 traveller, at mga ulat ng agent

https://integrations.wink.travel — channel manager integrations

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

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

EndpointMga ToolSaklaw
/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.

Para sa kumpletong traveler booking flow, ikonekta ang Wink Booking Engine sa https://api.wink.travel/mcp/booking-engine at isang compatible na payment wallet. Ang pagdagdag ng Wink MCP ay nagbubukas ng browser sign-in at pagpili ng permiso; ang iyong client ang humahawak ng authentication.

Kasama sa Booking Engine ang destination lookup, paghahanap ng hotel at kwarto, agentic_booking_quote, agentic_booking_pay, agentic_booking_book, pagkuha ng booking at mga resibo, kapag naka-enable ang agentic booking at payment para sa environment na iyon. Tingnan ang Agentic Payments para sa setup ng koneksyon, mga permiso na pipiliin at mga hakbang mula sa paghahanap hanggang kumpirmasyon.


Kung ikaw ay…Kumonekta sa
Nag-iintegrate ng channel manager, PMS o CRSintegrations.wink.travel/mcp/channel-manager — ito lang
Nagma-manage ng content ng property/mcp/extranet/property + /mcp/extranet/facilities
Nagma-manage ng mga kwarto at uri ng kwarto/mcp/extranet/facilities
Nagma-manage ng presyo at availability/mcp/extranet/rates
Nagpapatakbo ng araw-araw na reservation/mcp/extranet/operations
Nagpapalago ng distribution/mcp/extranet/distribution + /mcp/analytics
Gumagawa ng affiliate pages/mcp/studio/curation + /mcp/studio/embeds
Nagpapatakbo ng link-in-bio pages/mcp/link-manager + /mcp/social
Nagbo-booking para sa mga traveller/mcp/travel-agent
Nagre-reconcile ng pera/mcp/payment
Nagbo-book ng kwarto gamit ang AI agent/mcp/booking-engine + compatible payment wallet — tingnan ang Agentic Payments
Gumagawa ng booking experience/mcp/booking-engine; opsyonal ang /mcp/reference para sa karagdagang lookup

Kasama sa Booking Engine ang pangunahing booking workflow. Nagbibigay ito ng account at customization discovery, destination lookup, availability ng hotel at detalye ng room-rate, shopping cart, checkout, at pamamahala ng booking ng traveller. Kasama rin ang agentic booking at payment tools kapag naka-enable para sa environment na iyon.

Para sa paghahanap ng hotel sa isang lungsod, gamitin ang destination_lookup_search_suggestions para i-resolve ang destinasyon, pagkatapos ay inventory_search_city para hanapin ang mga available na hotel at rate. Parehong tool ay nasa /mcp/booking-engine, kaya hindi kailangan ng Reference connection ang flow na ito.

Idagdag ang /mcp/reference kapag kailangan mo ng mga supporting lookup tulad ng mga bansa, pera at exchange rate, mga suportadong wika, timezone, mas malawak na geographic search, klasipikasyon ng OTA, o pampublikong kaalaman tungkol sa property. Opsyonal ang mga ito sa booking flow.

Magsimula sa isa. Magdagdag ng isa pa kapag napansin mong may hinahanap kang hindi kaya ng isa — bawat koneksyon ay independyente, at ang pagdagdag ng isa ay hindi nakakaapekto sa iba.


Gumagamit ang Wink MCP servers 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 token sa background nang hindi na muling nagtatanong.

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


Idagdag ang bawat toolset sa Claude bilang custom connector. Walang config file na kailangang i-edit at walang application o secret na kailangang likhain.

  1. Sa Claude, buksan ang Customize › Connectors, i-click ang Add, pagkatapos ay Add custom connector.

  2. Ilagay ang Name (halimbawa Wink Link manager) at bilang MCP server URL, isang toolset mula sa directory sa itaas, halimbawa:

    https://api.wink.travel/mcp/link-manager

    I-click ang Continue.

  3. Nakikita ng Claude ang Wink sign-in. Panatilihin ang Authentication: Sign in now at OAuth client: Register automatically, pagkatapos ay i-click ang Add.

  4. I-click ang Connect. Magbubukas ang Wink sign-in page sa https://iam.wink.travel. Mag-sign in sa Wink at aprubahan ang mga permiso sa consent screen.

  5. Available na ang mga tool ng connector sa iyong mga chat. Ulitin para sa bawat toolset na kailangan ng iyong trabaho; bawat isa ay sariling connector.


Kapag inaprubahan mo ang consent screen makikita mo ang breakdown ng hinihingi ng agent. Gumagamit ang MCP clients ng parehong permission vocabulary tulad ng buong platform — tingnan ang buong scope reference sa Authentication page.

Tatlong bagay ang partikular sa MCP:

  • Kinakailangan din ang mcp.read mcp.write mcp.remove scopes para mabuksan ang MCP transport. Ang client na may hawak ng mcp.* scope ay pinapayagang makapasok 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).
  • Palaging kumikilos ang MCP bilang naka-sign-in na user. Nakukuha ng AI client ang mcp.* scopes sa pamamagitan ng iyong sign-in, hindi mula sa Application na iyong nilikha. Hindi makakabukas ng MCP transport ang machine-to-machine (client-credentials) tokens; gamitin ang REST API para sa server-to-server na trabaho.
  • Humihiling lang ang AI client ng scopes 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 toolsets ang alinman dito. Ang endpoint na kinokonekta mo ang nagdedesisyon kung aling mga tool ang nakalista, hindi kung ano ang pinapayagan. Ang pagkonekta sa /mcp/payment ay hindi nagbibigay ng karagdagang financial permission 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 pinapasiya 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 naka-cache na token mo. 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 gumana, kailangan ng tool ng permiso na wala ka; hindi makakatulong ang pagkonekta sa ibang toolset dahil hindi nagbibigay ng permiso ang mga toolsets.

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 walang epekto ang pagdagdag ng isa sa iba. Kung hindi ka sigurado kung alin ang may tool, pansamantalang kumonekta sa https://api.wink.travel/mcp, hanapin ang tool, pagkatapos tingnan kung aling toolset ang naglilista nito.

404 Not Found sa toolset endpoint

Suriing mabuti ang path — ang nested toolsets ay may dalawang segment (/mcp/extranet/rates, hindi /mcp/extranet-rates), at ang 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 may endpoint o wala.

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

Walang ganitong endpoint. Ang channel manager integration ay nasa https://integrations.wink.travel/mcp/channel-manager lang. Kung kailangan mo ring basahin o isulat ang sariling rates ng property nang mano-mano, hiwalay iyon na trabaho sa hiwalay na endpoint — tingnan ang /mcp/extranet/rates.

Lumilitaw ang server pero ang tawag sa tool ay “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 errors 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". Kailangan ng Codex ang 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 bersyon 1.2024.352 o mas bago at aktibong Plus, Pro, Team, o Enterprise subscription ang MCP support. I-update ang app at tingnan ang iyong plano sa Settings → Account.

Pulang status / “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 config changes nang walang restart.

Hindi nakalista ang Windsurf MCP servers sa settings

Kailangan ng Windsurf ng ganap na restart (hindi lang reload ng window) 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 lumalabas 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 update. Pagkatapos mag-update, i-reload ang VS Code (Ctrl+Shift+P → “Developer: Reload Window”).


Buksan ang Wink Portal Wink sa GitHub