Mga MCP Server

Ang mga MCP tool ng Wink ay ipinapublish bilang toolsets — mga nakatuong endpoint, 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): binubuksan ng iyong AI agent ang isang 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 mga endpoint

Nag-eexpose ang Wink ng humigit-kumulang 500 na mga 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 nito at buong parameter schema. 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 mga tool ay gumagawa ng mas masamang 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 mga tool. Ang paghahati ayon sa trabaho ay nangangahulugan na bawat koneksyon ay nagdadala ng bokabularyo ng isang trabaho.

Ang mga toolset ay hindi mga permiso

Ang pagpili ng makitid na toolset ay hindi naglilimita sa kung ano ang magagawa ng iyong account, at ang pagpili ng malawak ay hindi nagbibigay ng anumang dagdag. Bawat tool ay nagpapatupad ng parehong mga permiso ng account tulad ng web portal, sa ilalim ng iyong naka-sign in na pagkakakilanlan. Kung hindi maaaring mag-cancel ng booking ang iyong account sa Wink Portal, hindi rin magagawa iyon ng agent — kahit anong endpoint pa ang nakakonekta dito.

Pumili ng mga toolset para sa pokús, hindi para sa seguridad.

---

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

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, 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 perk, mga anunsyo
/mcp/settings	~60	Pamamahala ng account: profile at branding ng managing-entity, mga manager at kanilang mga grant, customization, webhooks, mga preference sa notification
/mcp/studio/embeds	~48	Pag-publish ng curated na imbentaryo: mga widget, grids at ranked grids, mga card, mga 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 rate, mga espesyal at promotional na rate
/mcp/extranet/operations	~39	Pagpapatakbo 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 affiliate at supplier relationship, 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 fund
/mcp/booking-engine	~17	Ang shopping path na nakatuon sa traveller: paghahanap at lookup, shopping cart at checkout, bucket list, customization ng campaign
/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 traveller, at mga ulat ng agent

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

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

Pag-integrate ng channel manager vs. pamamahala ng sariling mga rate

Iba’t ibang trabaho ito para sa iba’t ibang tao, at hindi sila nagbabahagi ng endpoint.

Ang isang channel manager, PMS o CRS vendor ay nag-iintegrate nang isang beses sa pamamagitan ng integrations.wink.travel/mcp/channel-manager, at mula noon ay nagpapalitan ng mga property, rate, availability at reservation sa pamamagitan ng integration na iyon. Ang iisang endpoint na iyon ang buong surface.

Ang isang hotelier na nagbabago ng sariling mga rate nang mano-mano ay gumagamit ng extranet toolset sa api.wink.travel — /mcp/extranet/rates at mga kaibigan nito. Hindi ito bahagi ng channel manager integration at walang dahilan ang integrator na kumonekta dito.

Ang pamamahala ng account ay nasa api.wink.travel din, sa /mcp/settings. Walang /mcp/settings sa integrations host.

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

Agentic payments

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 kuwarto, agentic_booking_quote, agentic_booking_pay, agentic_booking_book, pagkuha ng booking at mga resibo, kapag pinagana 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.

---

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 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
Nagbo-booking para sa mga traveller	/mcp/travel-agent
Nagre-reconcile ng pera	/mcp/payment
Nagbo-book ng kuwarto gamit ang AI agent	/mcp/booking-engine + isang compatible na 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 pinagana 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, mga timezone, mas malawak na geographic search, mga 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.

Gusto mo pa rin lahat?

Ang https://api.wink.travel/mcp at https://integrations.wink.travel/mcp ay nananatiling available at nagseserbisyo ng lahat ng tool sa kanilang host. Magagamit ito para tuklasin kung ano ang meron, ngunit hindi namin inirerekomenda para sa araw-araw na trabaho: sapat na ang laki ng listahan ng tool para matabunan ang iyong gawain at pababain ang pagpili ng tool ng agent. Mas piliin ang mga toolset sa itaas.

---

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:

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 sa pamamagitan ng Dynamic Client Registration — walang kailangang manual na setup ng application.
3. Binubuksan ng client ang isang 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 mga ACL rule na nagpoprotekta sa web portal ay nalalapat sa AI agent.

---

Ikonekta ang iyong AI client

Claude Code

1. Siguraduhing updated ang Claude Code:

   npm install -g @anthropic-ai/claude-code

2. Pumili ng toolset mula sa direktoryo sa itaas at idagdag ito. Halimbawa, mga presyo at availability:

   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 entry ng server na may sariling pangalan:

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.

Ibahagi sa iyong team

Idagdag ang --scope project sa claude mcp add at isusulat ng Claude Code ang URL ng server sa .mcp.json sa root ng repo. I-commit ang file na iyon — makakakuha ang bawat miyembro ng team ng parehong mga toolset, at bawat isa ay makakumpleto ng sariling browser sign-in sa unang koneksyon.

Claude Desktop

1. 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

2. 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"
       }
     }
   }

3. Ganap na isara at i-restart ang Claude Desktop (gamitin ang Quit mula sa menu bar — hindi sapat ang pagsara lang ng window).

4. Binubuksan ng Claude Desktop ang browser tab para sa bawat bagong server. Mag-sign in sa Wink at aprubahan ang mga permiso.

5. Ipinapakita ng plug icon sa bottom toolbar na parehong server ay nakakonekta.

OpenAI Codex

1. Siguraduhing naka-install ang Codex CLI:

   npm install -g @openai/codex

2. Buksan (o gumawa) ng Codex config file:

   • macOS / Linux: ~/.codex/config.json
   • Windows: %USERPROFILE%\.codex\config.json

3. Idagdag ang mga MCP server entry ng Wink:

   ~/.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"
       }
     }
   }

4. Simulan ang Codex. Sa unang paggamit, binubuksan ng Codex ang browser tab sa https://iam.wink.travel.

5. Mag-sign in sa Wink at aprubahan ang mga hinihinging permiso.

6. Kinukumpirma ng Codex ang koneksyon. Patakbuhin ang codex at hilingin na ilista ang mga available na tool para i-verify na aktibo ang mga Wink server.

Note

Ang suporta ng Codex CLI MCP ay nangangailangan ng bersyon 1.0 o mas bago. Patakbuhin ang codex --version para i-check, at npm install -g @openai/codex para mag-upgrade.

ChatGPT

Available ang suporta sa MCP server sa ChatGPT desktop app para sa mga Plus, Pro, Team, at Enterprise subscriber.

1. I-download at i-install ang ChatGPT desktop app kung wala ka pa nito.

2. Buksan ang app at i-click ang iyong profile icon sa kanang itaas, pagkatapos piliin ang Settings.

3. Pumunta sa Connectors (o MCP Servers depende sa bersyon ng iyong app) at i-click ang Add.

4. Ipasok ang URL ng isang toolset mula sa direktoryo sa itaas, halimbawa:

   https://api.wink.travel/mcp/extranet/rates

   Pagkatapos i-click ang Connect.

5. Binubuksan ng ChatGPT ang browser tab sa https://iam.wink.travel. Mag-sign in sa Wink at aprubahan ang mga permiso.

6. Ulitin ang mga hakbang 4–5 para sa iba pang toolset na kailangan ng iyong trabaho, halimbawa:

   https://api.wink.travel/mcp/extranet/operations

7. Lalabas ang bawat toolset sa iyong listahan ng Connectors. Magsimula ng bagong chat — awtomatikong available ang mga Wink tool.

Limitasyon sa web app

Ang mga MCP server ay maaaring i-configure lamang sa desktop app. Hindi sinusuportahan ng ChatGPT web interface sa chatgpt.com ang custom MCP server.

Cursor

1. Buksan (o gumawa) ng Cursor MCP config file:

   • macOS / Linux: ~/.cursor/mcp.json
   • Windows: %USERPROFILE%\.cursor\mcp.json

2. Idagdag ang mga MCP server entry ng Wink:

   ~/.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"
       }
     }
   }

3. Buksan ang Cursor. Pumunta sa Settings → Cursor Settings → MCP at tiyaking parehong server ay may berdeng status indicator. Kung pula, i-click ang Refresh.

4. Binubuksan ng Cursor ang browser tab sa https://iam.wink.travel. Mag-sign in sa Wink at aprubahan ang mga permiso.

5. Buksan ang chat (Ctrl+L / Cmd+L) at hilingin sa Cursor na ilista ang mga available na Wink tool para kumpirmahin ang koneksyon.

Project-scoped config

Maaari ka ring maglagay ng mcp.json file sa root ng iyong proyekto sa halip na sa ~/.cursor/. Mas prayoridad ang project-level config at ginagawa nitong available ang mga server sa bawat miyembro ng team na nagbubukas ng proyekto sa Cursor.

Windsurf

1. Buksan (o gumawa) ng Windsurf MCP config file:

   • macOS / Linux: ~/.codeium/windsurf/mcp_config.json
   • Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json

2. Idagdag ang mga MCP server entry ng Wink:

   ~/.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"
       }
     }
   }

3. Ganap na i-restart ang Windsurf (File → Quit, pagkatapos buksan muli).

4. Pumunta sa Settings → MCP Servers at tiyaking parehong server ay nakakonekta. Binubuksan ng Windsurf ang browser tab sa https://iam.wink.travel sa unang paggamit.

5. Mag-sign in sa Wink at aprubahan ang mga permiso. Nagiging berde ang mga server sa settings panel kapag authenticated na.

Note

Ang suporta ng Windsurf MCP ay nangangailangan ng bersyon 1.4 o mas bago. Tingnan sa pamamagitan ng Help → About Windsurf at mag-update mula sa Windsurf website kung kinakailangan.

Cline (VS Code)

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.

1. 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

2. I-click ang Cline icon sa Activity Bar (kaliwang sidebar) para buksan ang Cline panel.

3. I-click ang MCP Servers icon (plug icon) sa Cline toolbar, pagkatapos piliin ang Edit MCP Settings.

4. Binubuksan ng VS Code ang cline_mcp_settings.json. Idagdag ang mga entry ng Wink:

   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"
       }
     }
   }

5. I-save ang file. Awtomatikong magre-reload ang Cline at bubuksan ang browser tab sa https://iam.wink.travel.

6. Mag-sign in sa Wink at aprubahan ang mga permiso. Parehong server ay lalabas na aktibo sa MCP Servers panel.

Alternatibo: magdagdag gamit ang URL

Sa MCP Servers panel, i-click ang Add Server at i-paste ang URL ng toolset tulad ng https://api.wink.travel/mcp/extranet/rates nang direkta. Awtomatikong pupunan ng Cline ang config at hahawakan ang authentication nang hindi na kailangang i-edit ang JSON nang mano-mano.

---

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.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 ang AI client ng scope na kailangan lang 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 nakalista, 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

Hindi bumubukas 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 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, kailangan ng 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, pagkatapos tingnan kung aling toolset ang naglilista nito.

404 Not Found sa isang 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 at 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 isulat ang sariling mga rate ng property nang mano-mano, iyon 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 sa gitna ng 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 mahabang idle, mag-type ng bagong mensahe — magre-re-authenticate ang client nang awtomatiko.

Ipinapakita ng Codex CLI ang “MCP server unreachable”

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

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 suporta sa MCP. I-update ang app at i-verify ang iyong plano sa Settings → Account.

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

Suriin na valid ang iyong ~/.cursor/mcp.json na JSON at may "type": "http". Pagkatapos 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 server sa settings

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

Hindi nakikita ang opsyon na “Add Server” 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