Server MCP

Alat MCP Wink diterbitkan sebagai toolset — endpoint terfokus, masing-masing mencakup satu tugas. Anda menghubungkan klien AI Anda ke satu atau dua yang sesuai dengan pekerjaan Anda, bukan ke semuanya.

Setiap endpoint menggunakan login OAuth2 interaktif (alur kode otorisasi PKCE): agen AI Anda membuka tab browser, Anda masuk dengan akun Wink Anda, dan selesai. Tidak ada rahasia klien yang perlu dikelola.

Integrator manajer saluran menghubungkan ke satu endpoint

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

Seorang hotelier yang mengelola tarifnya sendiri menghubungkan ke endpoint lain

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

---

Mengapa alat dibagi ke beberapa endpoint

Wink menyediakan sekitar 500 alat. Memberikan semuanya sekaligus ke agen secara teknis mungkin — dan itu ide yang buruk.

Definisi alat memakan konteks. Setiap alat yang diiklankan oleh server MCP dimuat ke dalam jendela konteks model sebelum melakukan pekerjaan apa pun, bersama dengan deskripsi dan skema parameter lengkapnya. Lima ratus alat tersebut menghabiskan sebagian besar anggaran yang dibutuhkan tugas Anda, pada setiap permintaan.

Kualitas pilihan menurun seiring daftar bertambah. Agen yang memilih dari 500 alat dengan nama serupa membuat pilihan yang lebih buruk dibandingkan yang memilih dari 40. Jika Anda mengintegrasikan manajer saluran, sekitar dua puluh alat relevan untuk Anda; 480 lainnya adalah gangguan yang membuat alat yang tepat sulit ditemukan.

Pekerjaan benar-benar dapat dipisahkan. Seseorang yang menyinkronkan ketersediaan dari PMS dan seseorang yang mengkurasi halaman afiliasi hampir tidak berbagi alat. Memisahkan berdasarkan tugas berarti setiap koneksi membawa kosakata satu tugas.

Toolset bukanlah izin

Memilih toolset yang sempit tidak membatasi apa yang dapat dilakukan akun Anda, dan memilih yang luas tidak memberikan hak tambahan. Setiap alat menegakkan izin akun yang sama seperti portal web, di bawah identitas Anda yang masuk. Jika akun Anda tidak dapat membatalkan pemesanan di Wink Portal, agen juga tidak bisa — terlepas dari endpoint mana yang terhubung.

Pilih toolset untuk fokus, bukan untuk keamanan.

---

Direktori endpoint

Dua host melayani toolset. Jumlah alat adalah perkiraan dan bertambah seiring waktu.

https://api.wink.travel — platform

Endpoint	Alat	Cakupan
/mcp/extranet/facilities	~64	Inventaris yang dapat dipesan dan di lokasi: kamar tamu dan tipe kamar, spa, restoran, ruang rapat, aktivitas, atraksi, tempat, barang jual lainnya
/mcp/extranet/property	~62	Rekam properti dan ketentuan komersialnya: profil dan konten, tambahan, kebijakan pembatalan, keuntungan, pengumuman
/mcp/settings	~60	Administrasi akun: profil dan branding entitas pengelola, manajer dan haknya, kustomisasi, webhook, preferensi notifikasi
/mcp/studio/embeds	~48	Menerbitkan inventaris yang dikurasi: widget, grid dan grid berperingkat, kartu, peta, tautan dalam ke inventaris dan halaman pemasok
/mcp/extranet/rates	~44	Harga dan ketersediaan: periode tarif inventaris dan alokasi, rencana tarif, tarif utama, tarif khusus dan promosi
/mcp/extranet/operations	~39	Menjalankan properti secara langsung: reservasi dan siklus hidupnya, ulasan tamu dan tanggapan, feed kalender, tugas terjadwal
/mcp/extranet/distribution	~37	Tempat inventaris dijual: saluran penjualan dan pengubah tarif, permintaan hubungan afiliasi dan pemasok, pendaftaran, penangkapan prospek
/mcp/studio/curation	~35	Membangun koleksi yang dapat dipasarkan: daftar statis dan dinamis, daftar berperingkat, pencarian tersimpan, agregat properti
/mcp/link-manager	~28	Koleksi tautan sindikasi, desainnya, kategori dan tag, plus URL yang dipersingkat
/mcp/reference	~24	Data lookup hanya baca: negara, mata uang dan nilai tukar, bahasa, zona waktu, lookup geo, geolokasi IP
/mcp/analytics	~18	Analitik pemesanan dan pendapatan: gambaran umum, grafik garis, papan peringkat, kinerja afiliasi, metrik berbagi
/mcp/payment	~18	Operasi keuangan: buku besar, penarikan dan estimasi biaya, agregat dana pemesanan
/mcp/booking-engine	~17	Jalur belanja untuk pelancong: pencarian dan lookup, keranjang belanja dan checkout, daftar bucket, kustomisasi kampanye
/mcp/social	~17	Akun sosial terhubung, penerbitan dan penjadwalan posting, membaca wawasan posting
/mcp/travel-agent	~8	Pemesanan yang difasilitasi agen atas nama pelancong, dan laporan agen

https://integrations.wink.travel — integrasi manajer saluran

Satu endpoint, karena host ini ada untuk satu tugas.

Endpoint	Alat	Cakupan
/mcp/channel-manager	~9	Menghubungkan dan memverifikasi integrasi manajer saluran, PMS, atau CRS

Mengintegrasikan manajer saluran vs. mengelola tarif sendiri

Ini adalah tugas berbeda untuk orang yang berbeda, dan mereka tidak berbagi endpoint.

Vendor manajer saluran, PMS, atau CRS mengintegrasikan sekali melalui integrations.wink.travel/mcp/channel-manager, dan sejak itu bertukar properti, tarif, ketersediaan, dan reservasi melalui integrasi itu. Endpoint tunggal itu adalah seluruh permukaan.

Hotelier yang mengubah tarif sendiri secara manual menggunakan toolset extranet di api.wink.travel — /mcp/extranet/rates dan kawan-kawannya. Itu bukan bagian dari integrasi manajer saluran dan integrator tidak perlu menghubungkannya.

Administrasi akun juga ada di api.wink.travel, di /mcp/settings. Tidak ada /mcp/settings di host integrasi.

Setiap endpoint juga membawa alat ping, sehingga Anda dapat memastikan koneksi aktif sebelum memintanya melakukan pekerjaan nyata.

---

Toolset mana yang saya butuhkan?

Jika Anda…	Hubungkan ke
Mengintegrasikan manajer saluran, PMS, atau CRS	integrations.wink.travel/mcp/channel-manager — hanya ini saja
Mengelola konten properti	/mcp/extranet/property + /mcp/extranet/facilities
Mengelola kamar dan tipe kamar	/mcp/extranet/facilities
Mengelola harga dan ketersediaan	/mcp/extranet/rates
Menjalankan reservasi sehari-hari	/mcp/extranet/operations
Mengembangkan distribusi	/mcp/extranet/distribution + /mcp/analytics
Membangun halaman afiliasi	/mcp/studio/curation + /mcp/studio/embeds
Menjalankan halaman link-in-bio	/mcp/link-manager + /mcp/social
Memesan atas nama pelancong	/mcp/travel-agent
Menyelesaikan keuangan	/mcp/payment
Membangun pengalaman pemesanan	/mcp/booking-engine + /mcp/reference

Mulailah dengan satu. Tambahkan yang lain saat Anda menemukan sesuatu yang tidak bisa dilakukan — setiap koneksi independen, dan menambah satu tidak memengaruhi yang lain.

Masih ingin semuanya?

https://api.wink.travel/mcp dan https://integrations.wink.travel/mcp tetap tersedia dan melayani semua alat di host mereka. Mereka berguna untuk menjelajahi apa yang ada, tapi kami tidak menyarankan untuk pekerjaan sehari-hari: daftar alat terlalu besar sehingga mengganggu tugas Anda dan menurunkan kualitas pemilihan alat agen. Lebih baik gunakan toolset di atas.

---

Cara kerja autentikasi

Server MCP Wink menggunakan alur OAuth2 Authorization Code + PKCE dan mendukung Dynamic Client Registration (RFC 7591). Berikut yang terjadi saat Anda menghubungkan untuk pertama kali:

1. Klien AI Anda menemukan server otorisasi dari metadata /.well-known/oauth-protected-resource endpoint MCP.
2. Klien mendaftar sendiri melalui Dynamic Client Registration — tidak perlu pengaturan aplikasi manual.
3. Klien membuka tab browser ke https://iam.wink.travel. Anda masuk dengan akun Wink dan menyetujui izin yang diminta di layar persetujuan.
4. Wink mengeluarkan token akses yang dibatasi ke akun Anda dan terhubung ke identitas Anda.
5. Klien AI melampirkan token ke setiap permintaan MCP. Semua hasil alat otomatis dibatasi ke entitas pengelola Anda.
6. Token kedaluwarsa setelah 3 jam. Klien AI Anda menyegarkan secara diam-diam di latar belakang tanpa meminta lagi.

Setiap panggilan alat berjalan di bawah identitas Anda — aturan ACL yang sama yang melindungi portal web berlaku untuk agen AI.

---

Hubungkan klien AI Anda

Claude Code

1. Pastikan Claude Code sudah terbaru:

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

2. Pilih toolset dari direktori di atas dan tambahkan. Contoh, harga dan ketersediaan:

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

3. Claude Code menghubungi server, menemukan server otorisasi, dan membuka browser default Anda.

4. Masuk ke Wink dan setujui permintaan izin di layar persetujuan.

5. Claude Code mengonfirmasi koneksi. Ketik /mcp untuk memverifikasi server muncul dan alatnya telah dimuat.

Tambahkan sebanyak toolset yang dibutuhkan pekerjaan Anda — masing-masing adalah entri server terpisah dengan nama sendiri:

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 perlu masuk sekali. Setelah persetujuan browser pertama, Claude Code menggunakan kembali sesi Wink Anda untuk endpoint Wink tambahan.

Bagikan dengan tim Anda

Tambahkan --scope project ke claude mcp add dan Claude Code menulis URL server ke .mcp.json di root repo. Commit file itu — setiap anggota tim mendapatkan toolset yang sama, dan masing-masing menyelesaikan masuk browser sendiri saat pertama kali terhubung.

Claude Desktop

1. Edit file 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. Tambahkan entri server 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"
       }
     }
   }

3. Keluar sepenuhnya dan mulai ulang Claude Desktop (gunakan Quit dari menu bar — menutup jendela tidak cukup).

4. Claude Desktop membuka tab browser untuk setiap server baru. Masuk ke Wink dan setujui izin.

5. Ikon colokan di toolbar bawah menunjukkan kedua server terhubung.

OpenAI Codex

1. Pastikan Codex CLI sudah terpasang:

   npm install -g @openai/codex

2. Buka (atau buat) file konfigurasi Codex:

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

3. Tambahkan entri server 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"
       }
     }
   }

4. Mulai Codex. Pada penggunaan pertama, Codex membuka tab browser ke https://iam.wink.travel.

5. Masuk ke Wink dan setujui izin yang diminta.

6. Codex mengonfirmasi koneksi. Jalankan codex dan minta daftar alat yang tersedia untuk memverifikasi server Wink aktif.

Catatan

Dukungan MCP Codex CLI memerlukan versi 1.0 atau lebih baru. Jalankan codex --version untuk memeriksa, dan npm install -g @openai/codex untuk memperbarui.

ChatGPT

Dukungan server MCP tersedia di aplikasi desktop ChatGPT untuk pelanggan Plus, Pro, Team, dan Enterprise.

1. Unduh dan pasang aplikasi desktop ChatGPT jika belum.

2. Buka aplikasi dan klik ikon profil Anda di kanan atas, lalu pilih Settings.

3. Pergi ke Connectors (atau MCP Servers tergantung versi aplikasi Anda) dan klik Add.

4. Masukkan URL toolset dari direktori di atas, misalnya:

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

   Lalu klik Connect.

5. ChatGPT membuka tab browser ke https://iam.wink.travel. Masuk ke Wink dan setujui izin.

6. Ulangi langkah 4–5 untuk toolset lain yang dibutuhkan pekerjaan Anda, misalnya:

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

7. Setiap toolset muncul di daftar Connectors Anda. Mulai chat baru — alat Wink tersedia otomatis.

Batasan aplikasi web

Server MCP hanya dapat dikonfigurasi di aplikasi desktop. Antarmuka web ChatGPT di chatgpt.com tidak mendukung server MCP kustom.

Cursor

1. Buka (atau buat) file konfigurasi MCP Cursor:

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

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

3. Buka Cursor. Pergi ke Settings → Cursor Settings → MCP dan pastikan kedua server muncul dengan indikator status hijau. Jika merah, klik Refresh.

4. Cursor membuka tab browser ke https://iam.wink.travel. Masuk ke Wink dan setujui izin.

5. Buka chat (Ctrl+L / Cmd+L) dan minta Cursor daftar alat Wink yang tersedia untuk mengonfirmasi koneksi.

Konfigurasi berjangkauan proyek

Anda juga dapat meletakkan file mcp.json di root proyek Anda daripada di ~/.cursor/. Konfigurasi tingkat proyek diutamakan dan membuat server tersedia untuk setiap anggota tim yang membuka proyek di Cursor.

Windsurf

1. Buka (atau buat) file konfigurasi MCP Windsurf:

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

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

3. Mulai ulang Windsurf sepenuhnya (File → Quit, lalu buka kembali).

4. Pergi ke Settings → MCP Servers dan pastikan kedua server terhubung. Windsurf membuka tab browser ke https://iam.wink.travel saat pertama kali digunakan.

5. Masuk ke Wink dan setujui izin. Server berubah hijau di panel pengaturan setelah terautentikasi.

Catatan

Dukungan MCP Windsurf memerlukan versi 1.4 atau lebih baru. Periksa melalui Help → About Windsurf dan perbarui dari situs Windsurf jika perlu.

Cline (VS Code)

Cline adalah ekstensi VS Code dengan pengelola server MCP bawaan. Tidak perlu mengedit JSON secara manual.

1. Pasang Cline dari Marketplace VS Code:

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

2. Klik ikon Cline di Activity Bar (sidebar kiri) untuk membuka panel Cline.

3. Klik ikon MCP Servers (ikon colokan) di toolbar Cline, lalu pilih Edit MCP Settings.

4. VS Code membuka cline_mcp_settings.json. Tambahkan 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"
       }
     }
   }

5. Simpan file. Cline memuat ulang otomatis dan membuka tab browser ke https://iam.wink.travel.

6. Masuk ke Wink dan setujui izin. Kedua server muncul aktif di panel MCP Servers.

Alternatif: tambah lewat URL

Di panel MCP Servers, klik Add Server dan tempel URL toolset seperti https://api.wink.travel/mcp/extranet/rates langsung. Cline mengisi konfigurasi otomatis dan menangani autentikasi tanpa perlu edit JSON manual.

---

Scope

Saat Anda menyetujui layar persetujuan, Anda akan melihat rincian apa yang diminta agen. Klien MCP menggunakan kosakata izin yang sama dengan platform — lihat referensi lengkap scope di halaman Autentikasi.

Dua hal spesifik untuk MCP:

• Scope mcp.read mcp.write mcp.remove juga diperlukan untuk membuka transport MCP. Klien yang memegang scope mcp.* diizinkan ke endpoint MCP Wink mana pun, tapi setiap alat yang dipanggil tetap menegakkan scope bagian dari endpoint yang dibungkusnya (misal booking.read).
• Klien AI hanya meminta scope yang dibutuhkan. Anda dapat menolak izin individu di layar persetujuan — alat yang memerlukan scope yang ditolak akan mengembalikan error saat dipanggil.

Toolset tidak mengubah ini. Endpoint yang Anda hubungkan menentukan alat mana yang terdaftar, bukan apa yang diizinkan dilakukan. Menghubungkan ke /mcp/payment tidak memberikan izin keuangan yang belum Anda miliki, dan menghubungkan ke /mcp/reference tidak menghentikan alat di sana menegakkan scope-nya sendiri. Otorisasi diputuskan per panggilan alat, dari token dan hak akun Anda.

---

Pemecahan masalah

Tab browser tidak terbuka

Klien AI Anda mungkin belum mendukung alur PKCE interaktif. Pastikan Anda menjalankan versi terbaru:

• Claude Code: npm install -g @anthropic-ai/claude-code
• Codex CLI: npm install -g @openai/codex
• Claude Desktop / ChatGPT desktop: perbarui dari updater bawaan aplikasi

401 Unauthorized setelah masuk

Token cache Anda mungkin sudah kadaluwarsa. Hapus dan tambahkan kembali server untuk memicu masuk baru:

# 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, hapus entri server dari pengaturan, mulai ulang aplikasi, dan tambahkan lagi.

403 Forbidden saat memanggil alat tertentu

Alat memerlukan scope yang tidak Anda setujui di layar persetujuan, atau izin yang tidak dimiliki akun Anda. Sambungkan kembali server — layar persetujuan akan muncul lagi dan Anda dapat menyetujui izin yang kurang. Jika masih gagal, alat memerlukan izin akun yang tidak Anda miliki; menghubungkan ke toolset lain tidak akan membantu, karena toolset tidak memberikan izin.

Alat yang saya butuhkan tidak ada di daftar

Anda mungkin terhubung ke toolset yang tidak mencakup tugas itu. Periksa direktori endpoint dan tambahkan toolset yang mencakupnya — koneksi independen, jadi menambah satu tidak mengubah yang lain. Jika ragu, sambungkan sementara ke https://api.wink.travel/mcp, temukan alatnya, lalu cari toolset yang mencantumkannya.

404 Not Found pada endpoint toolset

Periksa jalur dengan teliti — toolset bertingkat memiliki dua segmen (/mcp/extranet/rates, bukan /mcp/extranet-rates), dan yang datar satu segmen (/mcp/link-manager). Perlu dicatat bahwa permintaan tanpa autentikasi ke jalur mana pun di bawah /mcp mengembalikan 401, bukan 404, jadi 401 saja tidak menunjukkan apakah endpoint ada.

Saya menghubungkan ke api.wink.travel/mcp/channel-manager dan tidak ada apa-apa

Endpoint itu tidak ada. Integrasi manajer saluran hanya dilayani dari https://integrations.wink.travel/mcp/channel-manager. Jika Anda juga perlu membaca atau menulis tarif properti sendiri secara manual, itu tugas terpisah di endpoint terpisah — lihat /mcp/extranet/rates.

Server muncul tapi panggilan alat mengembalikan “account not found”

Anda masuk ke akun Wink yang tidak memiliki entitas pengelola. Pergi ke Wink Portal dan pastikan akun Anda sudah disiapkan sebelum menggunakan server MCP.

Token kedaluwarsa di tengah sesi

Token berlaku selama 3 jam. Claude Code dan Claude Desktop menyegarkan token secara diam-diam tanpa mengganggu sesi Anda. Jika Anda melihat error autentikasi setelah lama tidak aktif, ketik pesan baru — klien akan mengautentikasi ulang otomatis.

Codex CLI menunjukkan “MCP server unreachable”

Periksa bahwa ~/.codex/config.json adalah JSON valid (tanpa koma di akhir) dan "type": "http" sudah disetel. Codex memerlukan transport HTTP untuk server jarak jauh; transport stdio hanya untuk binary lokal.

Menu “Connectors” ChatGPT hilang

Dukungan MCP memerlukan versi aplikasi desktop ChatGPT 1.2024.352 atau lebih baru dan langganan Plus, Pro, Team, atau Enterprise aktif. Perbarui aplikasi dan periksa paket Anda di Settings → Account.

Server Cursor menunjukkan merah / “Failed to connect”

Pastikan ~/.cursor/mcp.json adalah JSON valid dan berisi "type": "http". Lalu pergi ke Settings → Cursor Settings → MCP dan klik Refresh. Jika error berlanjut, mulai ulang Cursor sepenuhnya — perubahan konfigurasi tidak selalu terdeteksi tanpa restart.

Server MCP Windsurf tidak muncul di pengaturan

Windsurf memerlukan restart penuh (bukan hanya reload jendela) untuk memuat perubahan mcp_config.json. Gunakan File → Quit dan buka kembali. Jika server masih tidak muncul, pastikan Anda menggunakan Windsurf 1.4+ melalui Help → About Windsurf.

Opsi “Add Server” Cline tidak terlihat

Pengelola server MCP memerlukan Cline 2.0 atau lebih baru. Buka panel Extensions VS Code, cari Cline, dan klik Update jika tersedia. Setelah memperbarui, muat ulang VS Code (Ctrl+Shift+P → “Developer: Reload Window”).

---

Buka Wink Portal Wink di GitHub