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.
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 httpBakit 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.
Direktoryo ng mga endpoint
Section titled “Direktoryo ng mga endpoint”Dalawang host ang nagseserbisyo ng mga toolset. Ang bilang ng mga tool ay tinatayang at lumalaki sa paglipas ng panahon.
https://api.wink.travel — ang platform
Section titled “https://api.wink.travel — ang platform”| Endpoint | Mga Tool | Saklaw nito |
|---|---|---|
/mcp/extranet/facilities | ~64 | Ang 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 | ~62 | Ang 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 | ~60 | Pamamahala ng account: profile at branding ng managing entity, mga manager at kanilang mga grant, customisasyon, webhooks, mga preference sa notification |
/mcp/studio/embeds | ~48 | Pagpapublish 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 | ~44 | Mga presyo at availability: mga rate period at allotment ng imbentaryo, mga rate plan, master rates, espesyal at promotional rates |
/mcp/extranet/operations | ~39 | Pamamahala 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 | ~37 | Kung 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 | ~35 | Pagbuo ng mga merchandisable na koleksyon: static at dynamic na listahan, ranked list, mga saved search, mga aggregate ng property |
/mcp/link-manager | ~28 | Mga syndicated link collection, disenyo nito, mga kategorya at tag, pati na rin ang pinaikling URL |
/mcp/reference | ~24 | Read-only na lookup data: mga bansa, mga pera at exchange rate, mga wika, mga timezone, geo lookup, IP geolocation |
/mcp/analytics | ~18 | Booking at revenue analytics: mga overview, line chart, leaderboard, performance ng affiliate, mga metric ng share |
/mcp/payment | ~18 | Mga financial operation: ledger, withdrawal at fee estimate, mga aggregate ng booking funds |
/mcp/booking-engine | ~17 | Ang shopping path para sa mga biyahero: paghahanap at lookup, shopping cart at checkout, bucket list, customisasyon ng kampanya |
/mcp/social | ~17 | Mga konektadong social account, pag-publish at pag-schedule ng mga post, pagbabasa ng post insights |
/mcp/travel-agent | ~8 | Mga 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.
| Endpoint | Mga Tool | Saklaw nito |
|---|---|---|
/mcp/channel-manager | ~9 | Pagkonekta 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.
Anong mga toolset ang kailangan ko?
Section titled “Anong mga toolset ang kailangan ko?”| Kung ikaw ay… | Kumonekta sa |
|---|---|
| Nag-iintegrate ng channel manager, PMS o CRS | integrations.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.
Paano gumagana ang authentication
Section titled “Paano gumagana ang authentication”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:
- Nadidiskubre ng iyong AI client ang authorization server mula sa
/.well-known/oauth-protected-resourcemetadata ng MCP endpoint. - Nagse-self-register ang client gamit ang Dynamic Client Registration — walang kailangang manual na setup ng application.
- 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. - Nag-iisyu ang Wink ng access token na naka-scope sa iyong account at naka-link sa iyong pagkakakilanlan.
- Ina-attach ng AI client ang token sa bawat MCP request. Lahat ng resulta ng tool ay awtomatikong naka-scope sa iyong managing entity.
- 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.
Ikonekta ang iyong AI client
Section titled “Ikonekta ang iyong AI client”-
Siguraduhing updated ang Claude Code:
Terminal window npm install -g @anthropic-ai/claude-code -
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 -
Kinokontak ng Claude Code ang server, nadidiskubre ang authorization server, at binubuksan ang iyong default browser.
-
Mag-sign in sa Wink at aprubahan ang request ng permiso sa consent screen.
-
Kinukumpirma ng Claude Code ang koneksyon. I-type ang
/mcppara 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:
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 httpIsang 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.
-
I-edit ang Claude Desktop config file:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
- macOS:
-
Idagdag ang mga MCP server entry:
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"}}} -
Ganap na isara at i-restart ang Claude Desktop (gamitin ang Quit mula sa menu bar — hindi sapat ang pagsara lang ng window).
-
Nagbubukas ang Claude Desktop ng browser tab para sa bawat bagong server. Mag-sign in sa Wink at aprubahan ang mga permiso.
-
Ipinapakita ng plug icon sa ibabang toolbar na parehong server ay nakakonekta.
-
Siguraduhing naka-install ang Codex CLI:
Terminal window npm install -g @openai/codex -
Buksan (o gumawa) ng Codex config file:
- macOS / Linux:
~/.codex/config.json - Windows:
%USERPROFILE%\.codex\config.json
- macOS / Linux:
-
Idagdag ang mga Wink MCP server entry:
~/.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"}}} -
Simulan ang Codex. Sa unang paggamit, magbubukas ang Codex ng browser tab sa
https://iam.wink.travel. -
Mag-sign in sa Wink at aprubahan ang hinihinging permiso.
-
Kinukumpirma ng Codex ang koneksyon. Patakbuhin ang
codexat hilingin na ilista ang mga available na tool para i-verify na aktibo ang mga Wink server.
Available ang suporta sa MCP server sa ChatGPT desktop app para sa mga Plus, Pro, Team, at Enterprise subscriber.
-
I-download at i-install ang ChatGPT desktop app kung wala ka pa nito.
-
Buksan ang app at i-click ang iyong profile icon sa kanang itaas, pagkatapos piliin ang Settings.
-
Pumunta sa Connectors (o MCP Servers depende sa bersyon ng iyong app) at i-click ang Add.
-
Ipasok ang URL ng isang toolset mula sa directory sa itaas, halimbawa:
https://api.wink.travel/mcp/extranet/ratesPagkatapos i-click ang Connect.
-
Magbubukas ang ChatGPT ng browser tab sa
https://iam.wink.travel. Mag-sign in sa Wink at aprubahan ang mga permiso. -
Ulitin ang mga hakbang 4–5 para sa iba pang toolset na kailangan ng iyong trabaho, halimbawa:
https://api.wink.travel/mcp/extranet/operations -
Lalabas ang bawat toolset sa iyong listahan ng Connectors. Magsimula ng bagong chat — awtomatikong available ang mga Wink tool.
-
Buksan (o gumawa) ng Cursor MCP config file:
- macOS / Linux:
~/.cursor/mcp.json - Windows:
%USERPROFILE%\.cursor\mcp.json
- macOS / Linux:
-
Idagdag ang mga Wink MCP server entry:
~/.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"}}} -
Buksan ang Cursor. Pumunta sa Settings → Cursor Settings → MCP at tiyaking parehong lumalabas ang mga server na may berdeng status indicator. Kung pula ang kulay, i-click ang Refresh.
-
Nagbubukas ang Cursor ng browser tab sa
https://iam.wink.travel. Mag-sign in sa Wink at aprubahan ang mga permiso. -
Buksan ang chat (
Ctrl+L/Cmd+L) at hilingin sa Cursor na ilista ang mga available na Wink tool para kumpirmahin ang koneksyon.
-
Buksan (o gumawa) ng Windsurf MCP config file:
- macOS / Linux:
~/.codeium/windsurf/mcp_config.json - Windows:
%USERPROFILE%\.codeium\windsurf\mcp_config.json
- macOS / Linux:
-
Idagdag ang mga Wink MCP server entry:
~/.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"}}} -
Ganap na i-restart ang Windsurf (File → Quit, pagkatapos buksan muli).
-
Pumunta sa Settings → MCP Servers at tiyaking parehong nakakonekta ang mga server. Nagbubukas ang Windsurf ng browser tab sa
https://iam.wink.travelsa unang paggamit. -
Mag-sign in sa Wink at aprubahan ang mga permiso. Nagiging berde ang mga server sa settings panel kapag na-authenticate na.
Ang Cline ay isang VS Code extension na may built-in na MCP server manager. Hindi na kailangan ng manual na pag-edit ng JSON.
-
I-install ang Cline mula sa VS Code Marketplace:
- Buksan ang VS Code at pindutin ang
Ctrl+Shift+X/Cmd+Shift+X - Hanapin ang Cline at i-click ang Install
- Buksan ang VS Code at pindutin ang
-
I-click ang Cline icon sa Activity Bar (kaliwang sidebar) para buksan ang Cline panel.
-
I-click ang MCP Servers icon (plug icon) sa Cline toolbar, pagkatapos piliin ang Edit MCP Settings.
-
Binubuksan ng VS Code ang
cline_mcp_settings.json. Idagdag ang mga Wink entry: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"}}} -
I-save ang file. Awtomatikong magre-reload ang Cline at magbubukas ng browser tab sa
https://iam.wink.travel. -
Mag-sign in sa Wink at aprubahan ang mga permiso. Parehong lalabas na aktibo ang mga server sa MCP Servers panel.
Mga Scope
Section titled “Mga Scope”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.readmcp.writemcp.removepara mabuksan ang MCP transport. Ang client na may hawak namcp.*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.
Pag-troubleshoot
Section titled “Pag-troubleshoot”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:
# Claude Codeclaude mcp remove wink-ratesclaude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport httpPara 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
