Mga MCP Server

Nagbibigay ang Wink ng dalawang authenticated na MCP server. Pareho silang gumagamit ng interactive OAuth2 login (PKCE authorization code flow) — nagbubukas ang iyong AI agent ng browser tab para makapag-sign in ka gamit ang iyong Wink account. Walang kailangang i-manage na client secrets.

Server	URL	Ano ang ginagawa nito
Inventory API	https://api.wink.travel/mcp	Imbentaryo, mga booking, mga rate, mga sales channel, analytics, at lahat ng operasyon sa platform
Integrations	https://integrations.wink.travel/mcp	Mga integrasyon ng channel manager — i-sync ang mga property, rate, at availability sa mga OTA

---

Paano gumagana ang authentication

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

1. Natutuklasan ng iyong AI client ang authorization server mula sa MCP endpoint na /.well-known/oauth-protected-resource metadata.
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. Nagbibigay 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 nagpi-prompt.

Lahat ng tawag sa tool ay tumatakbo sa ilalim ng iyong pagkakakilanlan — ang parehong mga ACL rules 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. Idagdag ang Wink Inventory MCP server:

   claude mcp add wink-inventory https://api.wink.travel/mcp --transport http

3. Kinokontak ng Claude Code ang server, natutuklasan ang authorization server, at binubuksan ang iyong default browser.

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

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

Para idagdag din ang Integrations server:

claude mcp add wink-integrations https://integrations.wink.travel/mcp --transport http

Ibahagi sa iyong team

Idagdag ang --scope project sa claude mcp add at isusulat ng Claude Code ang server URL sa .mcp.json sa root ng repo. I-commit ang file na iyon — bawat miyembro ng team ay magko-complete 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 entry ng MCP server:

   claude_desktop_config.json

   {
     "mcpServers": {
       "wink-inventory": {
         "type": "http",
         "url": "https://api.wink.travel/mcp"
       },
       "wink-integrations": {
         "type": "http",
         "url": "https://integrations.wink.travel/mcp"
       }
     }
   }

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. Nagbubukas ang Claude Desktop ng 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 konektado ang parehong server.

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 entry ng Wink MCP server:

   ~/.codex/config.json

   {
     "mcpServers": {
       "wink-inventory": {
         "type": "http",
         "url": "https://api.wink.travel/mcp"
       },
       "wink-integrations": {
         "type": "http",
         "url": "https://integrations.wink.travel/mcp"
       }
     }
   }

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

5. Mag-sign in sa Wink at aprubahan ang 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

Kinakailangan ng Codex CLI MCP support ang bersyon 1.0 o mas bago. Patakbuhin ang codex --version para tingnan, 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 app) at i-click ang Add.

4. Ipasok ang Wink Inventory server URL:

   https://api.wink.travel/mcp

   Pagkatapos i-click ang Connect.

5. Magbubukas ang ChatGPT ng 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 Integrations server:

   https://integrations.wink.travel/mcp

7. Parehong lalabas ang mga server sa iyong listahan ng Connectors. Magsimula ng bagong chat — awtomatikong available ang mga Wink tool.

Limitasyon sa web app

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

Cursor

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

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

2. Idagdag ang mga entry ng Wink MCP server:

   ~/.cursor/mcp.json

   {
     "mcpServers": {
       "wink-inventory": {
         "type": "http",
         "url": "https://api.wink.travel/mcp"
       },
       "wink-integrations": {
         "type": "http",
         "url": "https://integrations.wink.travel/mcp"
       }
     }
   }

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

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

5. Magbukas ng 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 entry ng Wink MCP server:

   ~/.codeium/windsurf/mcp_config.json

   {
     "mcpServers": {
       "wink-inventory": {
         "type": "http",
         "url": "https://api.wink.travel/mcp"
       },
       "wink-integrations": {
         "type": "http",
         "url": "https://integrations.wink.travel/mcp"
       }
     }
   }

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

4. Pumunta sa Settings → MCP Servers at tiyaking parehong nakalista bilang konektado ang mga server. Nagbubukas ang Windsurf ng 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

Kinakailangan ng Windsurf MCP support ang 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 Wink entry:

   cline_mcp_settings.json

   {
     "mcpServers": {
       "wink-inventory": {
         "type": "http",
         "url": "https://api.wink.travel/mcp"
       },
       "wink-integrations": {
         "type": "http",
         "url": "https://integrations.wink.travel/mcp"
       }
     }
   }

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

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

Alternatibo: idagdag gamit ang URL

Sa MCP Servers panel, i-click ang Add Server at i-paste nang direkta ang https://api.wink.travel/mcp. 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 detalyadong listahan ng hinihingi ng agent. Gumagamit ang mga MCP client ng parehong bokabularyo ng permiso tulad ng sa buong platform — tingnan ang buong scope reference sa Authentication page.

Dalawang bagay ang partikular sa MCP:

• Kinakailangan din ang mga mcp.read mcp.write mcp.remove na scope para mabuksan ang MCP transport. Ang client na may hawak na mcp.* scope ay pinapayagang pumasok sa /mcp, pero 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.

---

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 Code
claude mcp remove wink-inventory
claude mcp add wink-inventory https://api.wink.travel/mcp --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

Kinakailangan ng tool ang scope na hindi mo inaprubahan sa consent screen. Ikonekta muli ang server — lalabas muli ang consent screen at maaari mong aprubahan ang nawawalang permiso.

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

Nakalog-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 na JSON (walang trailing commas) at naka-set ang "type": "http". Kinakailangan ng Codex ang HTTP transport para sa remote servers; ang stdio transport ay para lang sa local binaries.

Walang “Connectors” menu sa ChatGPT

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

Pulang status / “Failed to connect” ang server sa Cursor

Suriin na valid ang iyong ~/.cursor/mcp.json na 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

Kinakailangan 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, tiyaking nasa Windsurf 1.4+ ka sa pamamagitan ng Help → About Windsurf.

Hindi lumalabas ang “Add Server” option sa Cline

Kinakailangan 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