Server MCP

Ikhtisar

Server MCP Wink yang dihosting tersedia di:

https://docs.mcp.wink.travel/mcp

Arahkan klien AI yang kompatibel (VS Code, Cursor, dan lainnya yang mengimplementasikan transport MCP HTTP) ke endpoint ini untuk memungkinkan mereka:

• Menjelajah dokumen produk & platform (wink://docs/...)
• Menjelajah spesifikasi OpenAPI langsung dan dokumen operasi (wink://api/...)
• Melakukan pencarian semantik / kata kunci ringan pada dokumen dan API langsung

Transportasi

Gunakan endpoint HTTP streaming utama:

https://docs.mcp.wink.travel/mcp

Jika klien Anda hanya mendukung SSE, gunakan:

https://docs.mcp.wink.travel/sse

Claude Code

Dokumentasi resmi: Hubungkan Claude Code ke alat melalui MCP

Anthropic merekomendasikan transport HTTP jarak jauh untuk server MCP yang dihosting di cloud:

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

Di dalam Claude Code, jalankan /mcp untuk memeriksa status server. Jika Anda ingin membagikan server dengan seluruh repositori, tambahkan --scope project agar Claude Code menulis konfigurasi ke .mcp.json.

Codex

Dokumentasi resmi: Docs MCP quickstart untuk Codex

OpenAI mendokumentasikan pengaturan MCP melalui CLI Codex, dan mencatat bahwa konfigurasi ini dibagikan dengan ekstensi IDE:

codex mcp add wink-docs --url https://docs.mcp.wink.travel/mcp
codex mcp list

Cursor

Dokumentasi MCP Cursor: https://cursor.com/docs/context/mcp Pengaturan: Tambahkan server jarak jauh melalui pengaturan MCP.

{
  "mcpServers": {
    "wink-docs": {
      "url": "https://docs.mcp.wink.travel/mcp",
    }
  }
}

VS Code

Dokumentasi resmi: https://code.visualstudio.com/docs/copilot/customization/mcp-servers Konfigurasi jarak jauh minimal (user atau workspace mcp.json):

{
  "servers": {
    "wink-docs": {
      "type": "http",
      "url": "https://docs.mcp.wink.travel/mcp"
    }
  }
}

Tips:

• Gunakan Command Palette: “MCP: List Servers” untuk mengonfirmasi koneksi & menjelajah alat.
• Pemilih alat memungkinkan Anda mengaktifkan/nonaktifkan api_search dan docs_search.
• Tambahkan konteks: Tampilan Chat → Tambah Konteks → Sumber Daya MCP untuk melampirkan halaman dokumen.

URI Sumber Daya Inti

URI	Deskripsi
wink://docs	Indeks dokumentasi (dikelompokkan berdasarkan kategori)
wink://docs/{path}	Artikel dokumentasi spesifik (Markdown / MDX)
wink://api	Katalog OpenAPI langsung yang ditemukan dari konfigurasi swagger Wink
wink://api/{apiName}	Ringkasan API ringkas dengan otentikasi, tag, header, dan operasi contoh
wink://api/{apiName}/operations	Daftar operasi lengkap yang dikelompokkan berdasarkan tag
wink://api/{apiName}/operation/{key}	Detail operasi individual (parameter, body permintaan, respons)
wink://api/{apiName}/schema/{schemaName}	Skema komponen yang telah dipecahkan dengan bidang bersarang, tipe, dan contoh
wink://api/{apiName}/operation/{key}/request	Tampilan fokus permintaan dengan input wajib dan payload contoh minimal
wink://api/{apiName}/operation/{key}/response/{status}	Tampilan fokus respons untuk kode status tertentu
wink://api/{apiName}/operation/{key}/recipe	Alur tugas untuk memanggil operasi tersebut dengan benar

Alat Pencarian (Referensi Cepat)

Alat	Tujuan	Contoh Kuery Umum
api_search	Temukan API langsung atau operasi untuk diintegrasikan	create affiliate, payment receipt, lookup inventory, invite manager
docs_search	Temukan dokumen konseptual / panduan	authentication, webhooks, wordPress

Biarkan query kosong untuk menerima saran. Setiap hasil menyertakan URI MCP yang dapat Anda buka. Untuk hasil operasi, api_search juga mengembalikan URI permintaan, respons, skema, dan resep yang terkait sehingga agen dapat langsung melompat ke subresource yang paling berguna.

Pola Penggunaan Umum

1. Jalankan api_search dengan niat Anda (misalnya “create affiliate” atau “payment receipt”).
2. Buka URI wink://api/... yang dikembalikan, atau ikuti bidang request_uri, response_uris, request_schema_uris, response_schema_uris, dan recipe_uri yang terkait.
3. Gunakan docs_search untuk konsep pendukung (otentikasi, webhooks, alur kerja).

Keterampilan AI

Keterampilan agen yang sudah dibangun menggunakan server MCP ini sebagai sumber kebenaran mereka. Keterampilan memberikan agen pengkodean Anda alur kerja terstruktur untuk membangun terhadap API Wink — alih-alih menebak endpoint, agen membaca kontrak langsung dari server MCP.

Lihat AI Skills untuk keterampilan yang tersedia dan instruksi pemasangan.

Catatan

• Setiap URI yang dikembalikan dapat dibuka oleh agen untuk konten lengkap.
• Pohon wink://api bersifat langsung dan mengikuti katalog OpenAPI hulu saat ini, bukan indeks repo yang dihasilkan.
• Saran muncul secara otomatis saat kueri kosong.

Wink di GitHub