Pelayan MCP
Alat MCP Wink diterbitkan sebagai set alat — titik akhir berfokus, setiap satu merangkumi satu tugasan. Anda menyambungkan klien AI anda ke satu atau dua yang sesuai dengan kerja anda, bukan ke semua.
Setiap titik akhir menggunakan log masuk OAuth2 interaktif (aliran kod kebenaran PKCE): ejen AI anda membuka tab pelayar, anda log masuk dengan akaun Wink anda, dan itu sahaja. Tiada rahsia klien untuk diuruskan.
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 httpKenapa alat dibahagikan merentasi titik akhir
Section titled “Kenapa alat dibahagikan merentasi titik akhir”Wink mendedahkan kira-kira 500 alat. Memberi semua alat itu kepada ejen sekaligus secara teknikal boleh dilakukan — dan ia adalah idea yang buruk.
Definisi alat memerlukan konteks. Setiap alat yang diiklankan oleh pelayan MCP dimuatkan ke dalam tetingkap konteks model sebelum ia melakukan sebarang kerja, bersama dengan penerangan dan skema parameter penuh. Lima ratus alat tersebut menggunakan sebahagian besar bajet yang diperlukan oleh tugasan sebenar anda, pada setiap permintaan.
Kualiti pilihan menurun apabila senarai bertambah. Ejen yang memilih dari 500 alat dengan nama yang serupa membuat pilihan yang lebih buruk berbanding yang memilih dari 40. Jika anda mengintegrasi pengurus saluran, kira-kira dua puluh alat relevan untuk anda; baki 480 adalah gangguan yang menyukarkan pencarian alat yang betul.
Kerja itu benar-benar boleh dipisahkan. Seseorang yang menyelaraskan ketersediaan dari PMS dan seseorang yang mengurus halaman pendaratan afiliasi hampir tidak berkongsi alat. Pembahagian mengikut tugasan bermakna setiap sambungan membawa kosa kata satu tugasan.
Direktori titik akhir
Section titled “Direktori titik akhir”Dua hos menyediakan set alat. Bilangan alat adalah anggaran dan bertambah dari masa ke masa.
https://api.wink.travel — platform
Section titled “https://api.wink.travel — platform”| Titik Akhir | Alat | Apa yang diliputi |
|---|---|---|
/mcp/extranet/facilities | ~64 | Inventori boleh ditempah dan di lokasi: bilik tetamu dan jenis bilik, spa, restoran, bilik mesyuarat, aktiviti, tarikan, tempat, barangan lain yang boleh dijual |
/mcp/extranet/property | ~62 | Rekod hartanah dan terma komersialnya: profil dan kandungan, tambahan, polisi pembatalan, keistimewaan, pengumuman |
/mcp/settings | ~60 | Pentadbiran akaun: profil dan penjenamaan entiti pengurusan, pengurus dan pemberian mereka, penyesuaian, webhook, keutamaan pemberitahuan |
/mcp/studio/embeds | ~48 | Menerbitkan inventori terpilih: widget, grid dan grid berperingkat, kad, peta, pautan mendalam ke inventori dan halaman pembekal |
/mcp/extranet/rates | ~44 | Harga dan ketersediaan: tempoh kadar inventori dan peruntukan, pelan kadar, kadar induk, kadar khas dan promosi |
/mcp/extranet/operations | ~39 | Mengendalikan hartanah secara langsung: tempahan dan kitar hayatnya, ulasan tetamu dan respons, suapan kalendar, tugasan berjadual |
/mcp/extranet/distribution | ~37 | Tempat inventori dijual: saluran jualan dan pengubah suai kadar, permintaan hubungan afiliasi dan pembekal, pendaftaran, tangkapan petunjuk |
/mcp/studio/curation | ~35 | Membina koleksi yang boleh dipasarkan: senarai statik dan dinamik, senarai berperingkat, carian tersimpan, agregat hartanah |
/mcp/link-manager | ~28 | Koleksi pautan sindiket, reka bentuknya, kategori dan tag, serta URL yang dipendekkan |
/mcp/reference | ~24 | Data rujukan baca sahaja: negara, mata wang dan kadar pertukaran, bahasa, zon waktu, rujukan geo, geolokasi IP |
/mcp/analytics | ~18 | Analitik tempahan dan hasil: gambaran keseluruhan, carta garis, papan pendahulu, prestasi afiliasi, metrik perkongsian |
/mcp/payment | ~18 | Operasi kewangan: lejar, pengeluaran dan anggaran yuran, agregat dana tempahan |
/mcp/booking-engine | ~17 | Laluan membeli-belah untuk pelancong: carian dan rujukan, troli beli-belah dan pembayaran, senarai bucket, penyesuaian kempen |
/mcp/social | ~17 | Akaun sosial yang disambungkan, penerbitan dan penjadualan pos, membaca wawasan pos |
/mcp/travel-agent | ~8 | Tempahan yang difasilitasi ejen bagi pihak pelancong, dan laporan ejen |
https://integrations.wink.travel — integrasi pengurus saluran
Section titled “https://integrations.wink.travel — integrasi pengurus saluran”Satu titik akhir, kerana hos ini wujud untuk satu tugasan.
| Titik Akhir | Alat | Apa yang diliputi |
|---|---|---|
/mcp/channel-manager | ~9 | Menyambung dan mengesahkan integrasi pengurus saluran, PMS atau CRS |
Setiap titik akhir juga membawa alat ping, supaya anda boleh mengesahkan sambungan hidup sebelum memintanya melakukan kerja sebenar.
Set alat mana yang saya perlukan?
Section titled “Set alat mana yang saya perlukan?”| Jika anda… | Sambungkan ke |
|---|---|
| Mengintegrasi pengurus saluran, PMS atau CRS | integrations.wink.travel/mcp/channel-manager — hanya ini sahaja |
| Mengurus kandungan hartanah | /mcp/extranet/property + /mcp/extranet/facilities |
| Mengurus bilik dan jenis bilik | /mcp/extranet/facilities |
| Mengurus harga dan ketersediaan | /mcp/extranet/rates |
| Mengendalikan tempahan harian | /mcp/extranet/operations |
| Mengembangkan pengedaran | /mcp/extranet/distribution + /mcp/analytics |
| Membina halaman afiliasi | /mcp/studio/curation + /mcp/studio/embeds |
| Mengendalikan halaman pautan dalam bio | /mcp/link-manager + /mcp/social |
| Menempah bagi pihak pelancong | /mcp/travel-agent |
| Menyelaraskan wang | /mcp/payment |
| Membina pengalaman tempahan | /mcp/booking-engine + /mcp/reference |
Mulakan dengan satu. Tambah satu lagi apabila anda mendapati sesuatu yang tidak boleh dilakukan — setiap sambungan adalah bebas, dan menambah satu tidak pernah menjejaskan yang lain.
Cara pengesahan berfungsi
Section titled “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:
- Klien AI anda menemui pelayan kebenaran dari metadata titik akhir MCP
/.well-known/oauth-protected-resource. - Klien mendaftar sendiri melalui Pendaftaran Klien Dinamik — tiada persediaan aplikasi manual diperlukan.
- Klien membuka tab pelayar ke
https://iam.wink.travel. Anda log masuk dengan akaun Wink anda dan meluluskan kebenaran yang diminta pada skrin persetujuan. - Wink mengeluarkan token akses yang dihadkan kepada akaun anda dan dipautkan kepada identiti anda.
- Klien AI melampirkan token ke setiap permintaan MCP. Semua hasil alat secara automatik dihadkan kepada entiti pengurusan anda.
- Token tamat tempoh selepas 3 jam. Klien AI anda menyegarkan secara senyap di latar belakang tanpa perlu meminta lagi.
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
Section titled “Sambungkan klien AI anda”-
Pastikan Claude Code dikemas kini:
Terminal window npm install -g @anthropic-ai/claude-code -
Pilih set alat dari direktori di atas dan tambahkannya. Contohnya, harga dan ketersediaan:
Terminal window claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http -
Claude Code menghubungi pelayan, menemui pelayan kebenaran, dan membuka pelayar lalai anda.
-
Log masuk ke Wink dan luluskan permintaan kebenaran pada skrin persetujuan.
-
Claude Code mengesahkan sambungan. Taip
/mcpuntuk mengesahkan pelayan muncul dan alatnya telah dimuatkan.
Tambah sebanyak mana set alat yang diperlukan oleh kerja anda — setiap satu adalah entri pelayan berasingan dengan nama sendiri:
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 httpAnda hanya log masuk sekali. Selepas kelulusan pelayar pertama, Claude Code menggunakan semula sesi Wink anda untuk titik akhir Wink tambahan.
-
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
- macOS:
-
Tambah entri pelayan MCP:
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"}}} -
Keluar sepenuhnya dan mulakan semula Claude Desktop (gunakan Quit dari bar menu — menutup tetingkap tidak mencukupi).
-
Claude Desktop membuka tab pelayar untuk setiap pelayan baru. Log masuk ke Wink dan luluskan kebenaran.
-
Ikon palam di bar alat bawah menunjukkan kedua-dua pelayan sebagai disambungkan.
-
Pastikan Codex CLI dipasang:
Terminal window npm install -g @openai/codex -
Buka (atau cipta) fail konfigurasi Codex:
- macOS / Linux:
~/.codex/config.json - Windows:
%USERPROFILE%\.codex\config.json
- macOS / Linux:
-
Tambah entri pelayan MCP 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"}}} -
Mulakan Codex. Pada penggunaan pertama, Codex membuka tab pelayar ke
https://iam.wink.travel. -
Log masuk ke Wink dan luluskan kebenaran yang diminta.
-
Codex mengesahkan sambungan. Jalankan
codexdan minta ia senaraikan alat yang tersedia untuk mengesahkan pelayan Wink aktif.
Sokongan pelayan MCP tersedia dalam aplikasi desktop ChatGPT untuk pelanggan Plus, Pro, Team, dan Enterprise.
-
Muat turun dan pasang aplikasi desktop ChatGPT jika belum ada.
-
Buka aplikasi dan klik ikon profil anda di penjuru kanan atas, kemudian pilih Settings.
-
Pergi ke Connectors (atau MCP Servers bergantung pada versi aplikasi anda) dan klik Add.
-
Masukkan URL set alat dari direktori di atas, contohnya:
https://api.wink.travel/mcp/extranet/ratesKemudian klik Connect.
-
ChatGPT membuka tab pelayar ke
https://iam.wink.travel. Log masuk ke Wink dan luluskan kebenaran. -
Ulang langkah 4–5 untuk mana-mana set alat lain yang diperlukan oleh kerja anda, contohnya:
https://api.wink.travel/mcp/extranet/operations -
Setiap set alat muncul dalam senarai Connectors anda. Mulakan sembang baru — alat Wink tersedia secara automatik.
-
Buka (atau cipta) fail konfigurasi MCP Cursor:
- macOS / Linux:
~/.cursor/mcp.json - Windows:
%USERPROFILE%\.cursor\mcp.json
- macOS / Linux:
-
Tambah entri pelayan MCP 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"}}} -
Buka Cursor. Pergi ke Settings → Cursor Settings → MCP dan sahkan kedua-dua pelayan muncul dengan penunjuk status hijau. Jika merah, klik Refresh.
-
Cursor membuka tab pelayar ke
https://iam.wink.travel. Log masuk ke Wink dan luluskan kebenaran. -
Buka sembang (
Ctrl+L/Cmd+L) dan minta Cursor senaraikan alat Wink yang tersedia untuk mengesahkan sambungan.
-
Buka (atau cipta) fail konfigurasi MCP Windsurf:
- macOS / Linux:
~/.codeium/windsurf/mcp_config.json - Windows:
%USERPROFILE%\.codeium\windsurf\mcp_config.json
- macOS / Linux:
-
Tambah entri pelayan MCP 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"}}} -
Mulakan semula Windsurf sepenuhnya (Fail → Quit, kemudian buka semula).
-
Pergi ke Settings → MCP Servers dan sahkan kedua-dua pelayan menunjukkan sebagai disambungkan. Windsurf membuka tab pelayar ke
https://iam.wink.travelpada penggunaan pertama. -
Log masuk ke Wink dan luluskan kebenaran. Pelayan bertukar hijau dalam panel tetapan selepas pengesahan.
Cline adalah sambungan VS Code dengan pengurus pelayan MCP terbina dalam. Tiada penyuntingan JSON manual diperlukan.
-
Pasang Cline dari Pasar Sambungan VS Code:
- Buka VS Code dan tekan
Ctrl+Shift+X/Cmd+Shift+X - Cari Cline dan klik Install
- Buka VS Code dan tekan
-
Klik ikon Cline di Bar Aktiviti (bar sisi kiri) untuk buka panel Cline.
-
Klik ikon MCP Servers (ikon palam) di bar alat Cline, kemudian pilih Edit MCP Settings.
-
VS Code membuka
cline_mcp_settings.json. Tambah entri 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"}}} -
Simpan fail. Cline memuat semula secara automatik dan membuka tab pelayar ke
https://iam.wink.travel. -
Log masuk ke Wink dan luluskan kebenaran. Kedua-dua pelayan muncul sebagai aktif dalam panel MCP Servers.
Apabila anda meluluskan skrin persetujuan, anda akan melihat pecahan apa yang ejen minta. Klien MCP menggunakan kosa kata kebenaran yang sama seperti platform lain — lihat rujukan penuh skop di halaman Pengesahan.
Dua perkara khusus untuk MCP:
- Skop
mcp.readmcp.writemcp.removejuga diperlukan untuk membuka pengangkutan MCP. Klien yang memegang skopmcp.*dibenarkan ke mana-mana titik akhir MCP Wink, tetapi setiap alat yang dipanggil masih menguatkuasakan skop bahagian titik akhir yang dibalutnya (contohbooking.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.
Set alat tidak mengubah apa-apa ini. Titik akhir yang anda sambungkan menentukan alat mana yang disenaraikan, bukan apa yang dibenarkan dilakukan. Menyambung ke /mcp/payment tidak memberikan kebenaran kewangan yang anda tidak ada, dan menyambung ke /mcp/reference tidak menghalang alat di situ menguatkuasakan skopnya sendiri. Kebenaran ditentukan setiap panggilan alat, dari token anda dan pemberian akaun anda.
Penyelesaian Masalah
Section titled “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 pengemas kini terbina dalam aplikasi
401 Unauthorized selepas log masuk
Token cache anda mungkin sudah lapuk. Buang dan tambah semula pelayan untuk mencetuskan log masuk baru:
# Claude Codeclaude mcp remove wink-ratesclaude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport httpUntuk Claude Desktop dan ChatGPT, buang 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, atau kebenaran yang akaun anda tidak miliki. Sambung semula pelayan — skrin persetujuan akan muncul semula dan anda boleh luluskan kebenaran yang hilang. Jika masih gagal, alat memerlukan kebenaran akaun yang anda tidak ada; menyambung ke set alat lain tidak membantu, kerana set alat tidak memberikan kebenaran.
Alat yang saya perlukan tiada dalam senarai
Anda mungkin disambungkan ke set alat yang tidak meliputi tugasan itu. Semak direktori titik akhir dan tambah set alat yang meliputi — sambungan adalah bebas, jadi menambah satu tidak mengubah yang lain. Jika tidak pasti yang mana ada alat itu, sambung sementara ke https://api.wink.travel/mcp, cari alat, kemudian lihat set alat mana yang menyenaraikannya.
404 Not Found pada titik akhir set alat
Periksa laluan dengan teliti — set alat bertingkat mempunyai dua segmen (/mcp/extranet/rates, bukan /mcp/extranet-rates), dan yang rata satu segmen (/mcp/link-manager). Perhatikan bahawa permintaan tidak diautentikasi ke mana-mana laluan di bawah /mcp mengembalikan 401, bukan 404, jadi 401 sahaja tidak memberitahu sama ada titik akhir wujud.
Saya sambung ke api.wink.travel/mcp/channel-manager dan tiada apa
Titik akhir itu tidak wujud. Integrasi pengurus saluran hanya disediakan dari https://integrations.wink.travel/mcp/channel-manager. Jika anda juga perlu baca atau tulis kadar hartanah sendiri secara manual, itu tugasan berasingan pada titik akhir berasingan — lihat /mcp/extranet/rates.
Pelayan muncul tetapi panggilan alat mengembalikan “akaun tidak ditemui”
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 lihat ralat pengesahan selepas tempoh tidak aktif lama, taip mesej baru — klien akan mengesahkan semula secara automatik.
Codex CLI menunjukkan “MCP server unreachable”
Periksa bahawa ~/.codex/config.json adalah JSON sah (tiada koma bertindih) dan "type": "http" ditetapkan. Codex memerlukan pengangkutan HTTP untuk pelayan jauh; pengangkutan stdio untuk binari tempatan sahaja.
Menu “Connectors” ChatGPT tiada
Sokongan MCP memerlukan versi aplikasi desktop ChatGPT 1.2024.352 atau lebih baru dan langganan Plus, Pro, Team, atau Enterprise 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 ada kemas kini. Selepas kemas kini, muat semula VS Code (Ctrl+Shift+P → “Developer: Reload Window”).
Buka Wink Portal Wink di GitHub
