Skip to content

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.

Integrator pengurus saluran menyambung ke satu titik akhir
claude mcp add wink-channel-manager https://integrations.wink.travel/mcp/channel-manager --transport http
Seorang pengurus hotel yang mengurus kadar mereka sendiri menyambung ke titik akhir lain
claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http

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


Dua hos menyediakan set alat. Bilangan alat adalah anggaran dan bertambah dari masa ke masa.

Titik AkhirAlatApa yang diliputi
/mcp/extranet/facilities~64Inventori 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~62Rekod hartanah dan terma komersialnya: profil dan kandungan, tambahan, polisi pembatalan, keistimewaan, pengumuman
/mcp/settings~60Pentadbiran akaun: profil dan penjenamaan entiti pengurusan, pengurus dan pemberian mereka, penyesuaian, webhook, keutamaan pemberitahuan
/mcp/studio/embeds~48Menerbitkan inventori terpilih: widget, grid dan grid berperingkat, kad, peta, pautan mendalam ke inventori dan halaman pembekal
/mcp/extranet/rates~44Harga dan ketersediaan: tempoh kadar inventori dan peruntukan, pelan kadar, kadar induk, kadar khas dan promosi
/mcp/extranet/operations~39Mengendalikan hartanah secara langsung: tempahan dan kitar hayatnya, ulasan tetamu dan respons, suapan kalendar, tugasan berjadual
/mcp/extranet/distribution~37Tempat inventori dijual: saluran jualan dan pengubah suai kadar, permintaan hubungan afiliasi dan pembekal, pendaftaran, tangkapan petunjuk
/mcp/studio/curation~35Membina koleksi yang boleh dipasarkan: senarai statik dan dinamik, senarai berperingkat, carian tersimpan, agregat hartanah
/mcp/link-manager~28Koleksi pautan sindiket, reka bentuknya, kategori dan tag, serta URL yang dipendekkan
/mcp/reference~24Data rujukan baca sahaja: negara, mata wang dan kadar pertukaran, bahasa, zon waktu, rujukan geo, geolokasi IP
/mcp/analytics~18Analitik tempahan dan hasil: gambaran keseluruhan, carta garis, papan pendahulu, prestasi afiliasi, metrik perkongsian
/mcp/payment~18Operasi kewangan: lejar, pengeluaran dan anggaran yuran, agregat dana tempahan
/mcp/booking-engine~17Laluan membeli-belah untuk pelancong: carian dan rujukan, troli beli-belah dan pembayaran, senarai bucket, penyesuaian kempen
/mcp/social~17Akaun sosial yang disambungkan, penerbitan dan penjadualan pos, membaca wawasan pos
/mcp/travel-agent~8Tempahan 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 AkhirAlatApa yang diliputi
/mcp/channel-manager~9Menyambung 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.


Jika anda…Sambungkan ke
Mengintegrasi pengurus saluran, PMS atau CRSintegrations.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.


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 titik akhir MCP /.well-known/oauth-protected-resource.
  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 ke 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 lagi.

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


  1. Pastikan Claude Code dikemas kini:

    Terminal window
    npm install -g @anthropic-ai/claude-code
  2. 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
  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.

Tambah sebanyak mana set alat yang diperlukan oleh kerja anda — setiap satu adalah entri pelayan berasingan dengan nama sendiri:

Terminal window
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

Anda hanya log masuk sekali. Selepas kelulusan pelayar pertama, Claude Code menggunakan semula sesi Wink anda untuk titik akhir Wink tambahan.


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.read mcp.write mcp.remove juga diperlukan untuk membuka pengangkutan MCP. Klien yang memegang skop mcp.* dibenarkan ke mana-mana titik akhir MCP Wink, tetapi setiap alat yang dipanggil masih menguatkuasakan skop bahagian titik akhir yang dibalutnya (contoh 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.

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.


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:

Terminal window
# Claude Code
claude mcp remove wink-rates
claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http

Untuk 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