Pelayan MCP

Wink menyediakan dua pelayan MCP yang disahkan. Kedua-duanya menggunakan log masuk OAuth2 interaktif (aliran kod kebenaran PKCE) — ejen AI anda membuka tab pelayar supaya anda boleh log masuk dengan akaun Wink anda. Tiada rahsia klien untuk diuruskan.

Pelayan	URL	Fungsi
Inventory API	https://api.wink.travel/mcp	Inventori, tempahan, kadar, saluran jualan, analitik, dan semua operasi platform
Integrations	https://integrations.wink.travel/mcp	Integrasi pengurus saluran — segerakkan hartanah, kadar, dan ketersediaan dengan OTA

---

Cara pengesahan berfungsi

Pelayan MCP Wink menggunakan aliran OAuth2 Authorization Code + PKCE dan menyokong Pendaftaran Klien Dinamik (RFC 7591). Berikut adalah apa yang berlaku apabila anda menyambung buat kali pertama:

1. Klien AI anda menemui pelayan kebenaran dari metadata /.well-known/oauth-protected-resource titik akhir MCP.
2. Klien mendaftar sendiri melalui Pendaftaran Klien Dinamik — tiada persediaan aplikasi manual diperlukan.
3. Klien membuka tab pelayar ke https://iam.wink.travel. Anda log masuk dengan akaun Wink anda dan meluluskan kebenaran yang diminta pada skrin persetujuan.
4. Wink mengeluarkan token akses yang dihadkan kepada akaun anda dan dipautkan kepada identiti anda.
5. Klien AI melampirkan token pada setiap permintaan MCP. Semua hasil alat secara automatik dihadkan kepada entiti pengurusan anda.
6. Token tamat tempoh selepas 3 jam. Klien AI anda menyegarkan secara senyap di latar belakang tanpa perlu meminta semula.

Setiap panggilan alat dijalankan di bawah identiti anda — peraturan ACL yang sama yang melindungi portal web juga terpakai kepada ejen AI.

---

Sambungkan klien AI anda

Claude Code

1. Pastikan Claude Code dikemas kini:

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

2. Tambah pelayan MCP Inventori Wink:

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

3. Claude Code menghubungi pelayan, menemui pelayan kebenaran, dan membuka pelayar lalai anda.

4. Log masuk ke Wink dan luluskan permintaan kebenaran pada skrin persetujuan.

5. Claude Code mengesahkan sambungan. Taip /mcp untuk mengesahkan pelayan muncul dan alatnya telah dimuatkan.

Untuk menambah pelayan Integrasi juga:

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

Kongsi dengan pasukan anda

Tambah --scope project pada claude mcp add dan Claude Code akan menulis URL pelayan ke .mcp.json di akar repositori. Komit fail itu — setiap ahli pasukan melengkapkan log masuk pelayar mereka sendiri kali pertama mereka menyambung.

Claude Desktop

1. Edit fail konfigurasi Claude Desktop:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • Linux: ~/.config/Claude/claude_desktop_config.json

2. Tambah entri pelayan MCP:

   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. Keluar sepenuhnya dan mulakan semula Claude Desktop (gunakan Quit dari bar menu — menutup tetingkap tidak mencukupi).

4. Claude Desktop membuka tab pelayar untuk setiap pelayan baru. Log masuk ke Wink dan luluskan kebenaran.

5. Ikon palam di bar alat bawah menunjukkan kedua-dua pelayan sebagai disambungkan.

OpenAI Codex

1. Pastikan Codex CLI dipasang:

   npm install -g @openai/codex

2. Buka (atau cipta) fail konfigurasi Codex:

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

3. Tambah entri pelayan MCP Wink:

   ~/.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. Mulakan Codex. Pada penggunaan pertama, Codex membuka tab pelayar ke https://iam.wink.travel.

5. Log masuk ke Wink dan luluskan kebenaran yang diminta.

6. Codex mengesahkan sambungan. Jalankan codex dan minta ia senaraikan alat yang tersedia untuk mengesahkan pelayan Wink aktif.

Note

Sokongan MCP Codex CLI memerlukan versi 1.0 atau lebih baru. Jalankan codex --version untuk semak, dan npm install -g @openai/codex untuk naik taraf.

ChatGPT

Sokongan pelayan MCP tersedia dalam aplikasi desktop ChatGPT untuk pelanggan Plus, Pro, Team, dan Enterprise.

1. Muat turun dan pasang aplikasi desktop ChatGPT jika anda belum berbuat demikian.

2. Buka aplikasi dan klik ikon profil anda di penjuru kanan atas, kemudian pilih Settings.

3. Pergi ke Connectors (atau MCP Servers bergantung pada versi aplikasi anda) dan klik Add.

4. Masukkan URL pelayan Inventori Wink:

   https://api.wink.travel/mcp

   Kemudian klik Connect.

5. ChatGPT membuka tab pelayar ke https://iam.wink.travel. Log masuk ke Wink dan luluskan kebenaran.

6. Ulang langkah 4–5 untuk pelayan Integrasi:

   https://integrations.wink.travel/mcp

7. Kedua-dua pelayan muncul dalam senarai Connectors anda. Mulakan sembang baru — alat Wink tersedia secara automatik.

Had aplikasi web

Pelayan MCP hanya boleh dikonfigurasikan dalam aplikasi desktop. Antara muka web ChatGPT di chatgpt.com tidak menyokong pelayan MCP tersuai.

Cursor

1. Buka (atau cipta) fail konfigurasi MCP Cursor:

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

2. Tambah entri pelayan MCP Wink:

   ~/.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. Buka Cursor. Pergi ke Settings → Cursor Settings → MCP dan sahkan kedua-dua pelayan muncul dengan penunjuk status hijau. Jika ia berwarna merah, klik Refresh.

4. Cursor membuka tab pelayar ke https://iam.wink.travel. Log masuk ke Wink dan luluskan kebenaran.

5. Buka sembang (Ctrl+L / Cmd+L) dan minta Cursor senaraikan alat Wink yang tersedia untuk mengesahkan sambungan.

Konfigurasi berfokus projek

Anda juga boleh meletakkan fail mcp.json di akar projek anda sebagai ganti di ~/.cursor/. Konfigurasi peringkat projek diutamakan dan menjadikan pelayan tersedia kepada setiap ahli pasukan yang membuka projek dalam Cursor.

Windsurf

1. Buka (atau cipta) fail konfigurasi MCP Windsurf:

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

2. Tambah entri pelayan MCP Wink:

   ~/.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. Mulakan semula Windsurf sepenuhnya (Fail → Quit, kemudian buka semula).

4. Pergi ke Settings → MCP Servers dan sahkan kedua-dua pelayan menunjukkan status disambungkan. Windsurf membuka tab pelayar ke https://iam.wink.travel pada penggunaan pertama.

5. Log masuk ke Wink dan luluskan kebenaran. Pelayan bertukar hijau dalam panel tetapan setelah disahkan.

Note

Sokongan MCP Windsurf memerlukan versi 1.4 atau lebih baru. Semak melalui Help → About Windsurf dan kemas kini dari laman web Windsurf jika perlu.

Cline (VS Code)

Cline adalah sambungan VS Code dengan pengurus pelayan MCP terbina dalam. Tiada penyuntingan JSON manual diperlukan.

1. Pasang Cline dari Pasar Sambungan VS Code:

   • Buka VS Code dan tekan Ctrl+Shift+X / Cmd+Shift+X
   • Cari Cline dan klik Install

2. Klik ikon Cline di Bar Aktiviti (bar sisi kiri) untuk membuka panel Cline.

3. Klik ikon MCP Servers (ikon palam) di bar alat Cline, kemudian pilih Edit MCP Settings.

4. VS Code membuka cline_mcp_settings.json. Tambah entri Wink:

   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. Simpan fail. Cline memuat semula secara automatik dan membuka tab pelayar ke https://iam.wink.travel.

6. Log masuk ke Wink dan luluskan kebenaran. Kedua-dua pelayan muncul sebagai aktif dalam panel MCP Servers.

Alternatif: tambah melalui URL

Dalam panel MCP Servers, klik Add Server dan tampal https://api.wink.travel/mcp secara langsung. Cline mengisi konfigurasi secara automatik dan mengendalikan pengesahan tanpa perlu sunting JSON secara manual.

---

Skop

Apabila anda meluluskan skrin persetujuan, anda akan melihat pecahan apa yang diminta oleh ejen. Klien MCP menggunakan kosa kata kebenaran yang sama seperti platform lain — lihat rujukan penuh skop pada halaman Pengesahan.

Dua perkara khusus untuk MCP:

• Skop mcp.read mcp.write mcp.remove juga diperlukan untuk membuka pengangkutan MCP. Klien yang memegang skop mcp.* dibenarkan ke /mcp, tetapi setiap alat yang dipanggilnya masih menguatkuasakan skop seksyen titik akhir yang dibalutnya (contohnya booking.read).
• Klien AI hanya meminta skop yang diperlukan. Anda boleh menolak kebenaran individu pada skrin persetujuan — alat yang memerlukan skop yang ditolak akan mengembalikan ralat apabila dipanggil.

---

Penyelesaian Masalah

Tab pelayar tidak terbuka

Klien AI anda mungkin belum menyokong aliran PKCE interaktif. Sahkan anda menjalankan versi terkini:

• Claude Code: npm install -g @anthropic-ai/claude-code
• Codex CLI: npm install -g @openai/codex
• Claude Desktop / ChatGPT desktop: kemas kini dari pemuat naik terbina dalam aplikasi

401 Unauthorized selepas log masuk

Token cache anda mungkin sudah lapuk. Alih keluar dan tambah semula pelayan untuk mencetuskan log masuk baru:

# Claude Code
claude mcp remove wink-inventory
claude mcp add wink-inventory https://api.wink.travel/mcp --transport http

Untuk Claude Desktop dan ChatGPT, alih keluar entri pelayan dari tetapan, mulakan semula aplikasi, dan tambah semula.

403 Forbidden apabila memanggil alat tertentu

Alat memerlukan skop yang anda tidak luluskan pada skrin persetujuan. Sambung semula pelayan — skrin persetujuan akan muncul semula dan anda boleh luluskan kebenaran yang hilang.

Pelayan muncul tetapi panggilan alat mengembalikan “akaun tidak dijumpai”

Anda log masuk ke akaun Wink yang tiada entiti pengurusan. Pergi ke Wink Portal dan pastikan akaun anda disediakan sebelum menggunakan pelayan MCP.

Token tamat tempoh semasa sesi

Token sah selama 3 jam. Claude Code dan Claude Desktop menyegarkan token secara senyap tanpa mengganggu sesi anda. Jika anda melihat ralat pengesahan selepas tempoh tidak aktif yang lama, taip mesej baru — klien akan mengesahkan semula secara automatik.

Codex CLI menunjukkan “Pelayan MCP tidak dapat dicapai”

Periksa bahawa ~/.codex/config.json adalah JSON sah (tiada koma bertindih) dan "type": "http" ditetapkan. Codex memerlukan pengangkutan HTTP untuk pelayan jauh; pengangkutan stdio hanya untuk binari tempatan.

Menu “Connectors” ChatGPT hilang

Sokongan MCP memerlukan versi aplikasi desktop ChatGPT 1.2024.352 atau lebih baru dan langganan Plus, Pro, Team, atau Enterprise yang aktif. Kemas kini aplikasi dan sahkan pelan anda di Settings → Account.

Pelayan Cursor menunjukkan merah / “Gagal sambung”

Sahkan ~/.cursor/mcp.json adalah JSON sah dan mengandungi "type": "http". Kemudian pergi ke Settings → Cursor Settings → MCP dan klik Refresh. Jika ralat berterusan, mulakan semula Cursor sepenuhnya — perubahan konfigurasi tidak selalu diambil tanpa mulakan semula.

Pelayan MCP Windsurf tidak disenaraikan dalam tetapan

Windsurf memerlukan mulakan semula penuh (bukan hanya muat semula tetingkap) untuk mengambil perubahan pada mcp_config.json. Gunakan File → Quit dan buka semula. Jika pelayan masih tidak muncul, sahkan anda menggunakan Windsurf 1.4+ melalui Help → About Windsurf.

Pilihan “Add Server” Cline tidak kelihatan

Pengurus pelayan MCP memerlukan Cline 2.0 atau lebih baru. Buka panel Sambungan VS Code, cari Cline, dan klik Update jika kemas kini tersedia. Selepas kemas kini, muat semula VS Code (Ctrl+Shift+P → “Developer: Reload Window”).

---

Buka Portal Wink Wink di GitHub