İçeriğe geç

MCP Sunucuları

Wink’in MCP araçları araç setleri olarak yayınlanır — her biri bir işi kapsayan odaklanmış uç noktalar. AI istemcinizi işinize uyan bir veya iki uç noktaya bağlarsınız, hepsine değil.

Her uç nokta etkileşimli OAuth2 oturumu açma (PKCE yetkilendirme kodu akışı) kullanır: AI ajanınız bir tarayıcı sekmesi açar, Wink hesabınızla oturum açarsınız ve işlem tamamdır. Yönetilecek istemci gizli anahtarı yoktur.

Bir kanal yöneticisi entegratörü bir uç noktaya bağlanır
claude mcp add wink-channel-manager https://integrations.wink.travel/mcp/channel-manager --transport http
Kendi fiyatlarını yöneten bir otelci başka bir uç noktaya bağlanır
claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http

Araçların uç noktalar arasında neden ayrıldığı

Bölüm başlığı “Araçların uç noktalar arasında neden ayrıldığı”

Wink yaklaşık 500 araç sunar. Bunların hepsini bir ajanla aynı anda kullanmak teknik olarak mümkün olsa da — kötü bir fikirdir.

Araç tanımları bağlam gerektirir. Bir MCP sunucusunun ilan ettiği her araç, modelin bağlam penceresine iş yapmadan önce açıklaması ve tam parametre şeması ile birlikte yüklenir. Beş yüz araç, gerçek görevinizin ihtiyaç duyduğu bütçenin büyük bir kısmını her istekte tüketir.

Seçim kalitesi liste büyüdükçe düşer. 500 benzer isimli araç arasından seçim yapan bir ajan, 40 araç arasından seçim yapan bir ajandan daha kötü seçimler yapar. Bir kanal yöneticisi entegre ediyorsanız, yaklaşık yirmi araç sizin için geçerlidir; diğer 480 araç ise doğru aracı bulmayı zorlaştıran gürültüdür.

İş gerçekten ayrılabilir. Bir PMS’den müsaitlik senkronize eden biri ile bağlı kuruluş açılış sayfalarını yöneten biri neredeyse hiç araç paylaşmaz. İşe göre ayrım, her bağlantının bir işin sözlüğünü taşıması anlamına gelir.


İki sunucu araç setleri sağlar. Araç sayıları yaklaşık olup zamanla artar.

Uç NoktaAraçlarKapsadığı Alan
/mcp/extranet/facilities~64Rezervasyon yapılabilir ve yerinde envanter: misafir odaları ve oda tipleri, spa, restoranlar, toplantı odaları, aktiviteler, cazibe merkezleri, yerler, diğer satılabilir öğeler
/mcp/extranet/property~62Mülk kaydı ve ticari koşulları: profil ve içerik, ek hizmetler, iptal politikaları, avantajlar, duyurular
/mcp/settings~60Hesap yönetimi: yönetim varlığı profili ve markalaşma, yöneticiler ve yetkileri, özelleştirme, web kancaları, bildirim tercihleri
/mcp/studio/embeds~48Küratörlü envanter yayınlama: widgetlar, ızgaralar ve sıralı ızgaralar, kartlar, haritalar, envanter ve tedarikçi sayfalarına derin bağlantılar
/mcp/extranet/rates~44Fiyatlar ve müsaitlik: envanter fiyat dönemleri ve kontenjanlar, fiyat planları, ana fiyatlar, özel ve promosyon fiyatları
/mcp/extranet/operations~39Canlı mülk yönetimi: rezervasyonlar ve yaşam döngüsü, misafir yorumları ve yanıtları, takvim beslemeleri, planlanmış görevler
/mcp/extranet/distribution~37Envanterin satıldığı yerler: satış kanalları ve fiyat değiştiriciler, bağlı kuruluş ve tedarikçi ilişki talepleri, kayıt, potansiyel müşteri yakalama
/mcp/studio/curation~35Satılabilir koleksiyonlar oluşturma: statik ve dinamik listeler, sıralı listeler, kaydedilmiş aramalar, mülk toplulukları
/mcp/link-manager~28Senkronize bağlantı koleksiyonları, tasarımları, kategoriler ve etiketler, ayrıca kısaltılmış URL’ler
/mcp/reference~24Salt okunur arama verileri: ülkeler, para birimleri ve döviz kurları, diller, zaman dilimleri, coğrafi aramalar, IP coğrafi konumu
/mcp/analytics~18Rezervasyon ve gelir analizleri: genel bakışlar, çizgi grafikler, lider tabloları, bağlı kuruluş performansı, paylaşım metrikleri
/mcp/payment~18Finansal işlemler: defter, çekimler ve ücret tahminleri, rezervasyon fonu toplamları
/mcp/booking-engine~17Seyahat edenlere yönelik alışveriş yolu: arama ve sorgulama, alışveriş sepeti ve ödeme, istek listeleri, kampanya özelleştirme
/mcp/social~17Bağlı sosyal hesaplar, gönderi yayınlama ve zamanlama, gönderi analizlerini okuma
/mcp/travel-agent~8Seyahat edenler adına ajan aracılığıyla rezervasyonlar ve ajan raporları

https://integrations.wink.travel — kanal yöneticisi entegrasyonları

Bölüm başlığı “https://integrations.wink.travel — kanal yöneticisi entegrasyonları”

Tek uç nokta, çünkü bu sunucu tek bir iş için vardır.

Uç NoktaAraçlarKapsadığı Alan
/mcp/channel-manager~9Bir kanal yöneticisi, PMS veya CRS entegrasyonunu bağlama ve doğrulama

Her uç nokta ayrıca bir ping aracı taşır, böylece gerçek iş yapmadan önce bağlantının canlı olduğunu doğrulayabilirsiniz.


Eğer siz…Bağlanın
Bir kanal yöneticisi, PMS veya CRS entegre ediyorsanızintegrations.wink.travel/mcp/channel-manager — sadece bu
Bir mülkün içeriğini yönetiyorsanız/mcp/extranet/property + /mcp/extranet/facilities
Odaları ve oda tiplerini yönetiyorsanız/mcp/extranet/facilities
Fiyatları ve müsaitliği yönetiyorsanız/mcp/extranet/rates
Günlük rezervasyonları yürütüyorsanız/mcp/extranet/operations
Dağıtımı büyütüyorsanız/mcp/extranet/distribution + /mcp/analytics
Bağlı kuruluş sayfaları oluşturuyorsanız/mcp/studio/curation + /mcp/studio/embeds
Link-in-bio sayfaları yönetiyorsanız/mcp/link-manager + /mcp/social
Seyahat edenler adına rezervasyon yapıyorsanız/mcp/travel-agent
Parayı mutabakat yapıyorsanız/mcp/payment
Bir rezervasyon deneyimi oluşturuyorsanız/mcp/booking-engine + /mcp/reference

Bir tanesiyle başlayın. Bir aracın yapamadığı bir şey istediğinizde başka bir tane ekleyin — her bağlantı bağımsızdır ve birini eklemek diğerlerini etkilemez.


Wink MCP sunucuları OAuth2 Yetkilendirme Kodu + PKCE akışını kullanır ve Dinamik İstemci Kaydı (RFC 7591) destekler. İlk bağlandığınızda şu adımlar gerçekleşir:

  1. AI istemciniz MCP uç noktasının /.well-known/oauth-protected-resource meta verisinden yetkilendirme sunucusunu keşfeder.
  2. İstemci Dinamik İstemci Kaydı ile kendini kaydeder — manuel uygulama kurulumu gerekmez.
  3. İstemci https://iam.wink.travel adresine bir tarayıcı sekmesi açar. Wink hesabınızla oturum açar ve izin ekranında istenen izinleri onaylarsınız.
  4. Wink, hesabınıza ve kimliğinize bağlı bir erişim belirteci verir.
  5. AI istemcisi belirteci her MCP isteğine ekler. Tüm araç sonuçları otomatik olarak yönetim varlığınıza göre sınırlandırılır.
  6. Belirteçler 3 saat sonra sona erer. AI istemciniz arka planda sessizce yeniler, tekrar istemez.

Her araç çağrısı kimliğiniz altında çalışır — web portalını koruyan aynı ACL kuralları AI ajanına da uygulanır.


  1. Claude Code’un güncel olduğundan emin olun:

    Terminal window
    npm install -g @anthropic-ai/claude-code
  2. Yukarıdaki dizinden bir araç seti seçin ve ekleyin. Örneğin, fiyatlar ve müsaitlik:

    Terminal window
    claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http
  3. Claude Code sunucuya bağlanır, yetkilendirme sunucusunu keşfeder ve varsayılan tarayıcınızı açar.

  4. Wink’te oturum açın ve izin ekranında izin isteğini onaylayın.

  5. Claude Code bağlantıyı doğrular. Sunucunun göründüğünü ve araçların yüklendiğini doğrulamak için /mcp yazın.

İşinizin ihtiyaç duyduğu kadar araç seti ekleyin — her biri kendi adıyla ayrı bir sunucu girişi:

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

Sadece bir kez oturum açarsınız. İlk tarayıcı onayından sonra Claude Code, ek Wink uç noktaları için Wink oturumunuzu yeniden kullanır.


İzin ekranını onayladığınızda, ajanın istediği izinlerin dökümünü görürsünüz. MCP istemcileri platformun geri kalanıyla aynı izin sözlüğünü kullanır — tam izin referansını Kimlik Doğrulama sayfasında görebilirsiniz.

MCP’ye özgü iki şey vardır:

  • mcp.read, mcp.write, mcp.remove izinleri MCP taşıma açmak için ayrıca gereklidir. mcp.* iznine sahip bir istemci herhangi bir Wink MCP uç noktasına erişebilir, ancak çağırdığı her araç yine de sarmaladığı uç noktanın bölüm iznini uygular (örneğin booking.read).
  • AI istemcisi yalnızca ihtiyaç duyduğu izinleri ister. İzin ekranında bireysel izinleri reddedebilirsiniz — reddedilen izne ihtiyaç duyan araçlar çağrıldığında hata döner.

Araç setleri bunu değiştirmez. Bağlandığınız uç nokta hangi araçların listeleneceğine karar verir, ne yapabileceklerine değil. /mcp/payment’e bağlanmak size önceden sahip olmadığınız finansal izin vermez, /mcp/reference’e bağlanmak da oradaki bir aracın kendi iznini uygulamasını engellemez. Yetkilendirme, her araç çağrısında tokenınız ve hesabınızın izinleriyle belirlenir.


Tarayıcı sekmesi açılmıyor

AI istemciniz henüz etkileşimli PKCE akışını desteklemiyor olabilir. Güncel sürüm kullandığınızdan emin olun:

  • Claude Code: npm install -g @anthropic-ai/claude-code
  • Codex CLI: npm install -g @openai/codex
  • Claude Desktop / ChatGPT masaüstü: uygulamanın yerleşik güncelleyicisinden güncelleyin

Oturum açtıktan sonra 401 Unauthorized

Önbelleğe alınan token süresi dolmuş olabilir. Sunucuyu kaldırıp yeniden ekleyerek yeni oturum açmayı tetikleyin:

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

Claude Desktop ve ChatGPT için ayarlardan sunucu girişini kaldırın, uygulamayı yeniden başlatın ve tekrar ekleyin.

Belirli bir araç çağrılırken 403 Forbidden

Araç, izin ekranında onaylamadığınız bir izne veya hesabınızda olmayan bir izne ihtiyaç duyuyor. Sunucuyu yeniden bağlayın — izin ekranı tekrar açılır ve eksik izni onaylayabilirsiniz. Hala başarısız olursa, araç hesabınızda olmayan bir izne ihtiyaç duyuyor; farklı bir araç setine bağlanmak yardımcı olmaz çünkü araç setleri izin vermez.

İhtiyacım olan araç listede yok

Muhtemelen o işi kapsayan bir araç setine bağlı değilsiniz. Uç nokta dizinini kontrol edin ve işi kapsayan araç setini ekleyin — bağlantılar bağımsızdır, birini eklemek diğerlerini değiştirmez. Hangi setin olduğunu bilmiyorsanız, geçici olarak https://api.wink.travel/mcp’ye bağlanın, aracı bulun, sonra hangi araç setinde olduğunu kontrol edin.

Araç seti uç noktasında 404 Not Found

Yolu dikkatlice kontrol edin — iç içe araç setleri iki segmentlidir (/mcp/extranet/rates, /mcp/extranet-rates değil), düz olanlar ise bir segmentlidir (/mcp/link-manager). Ayrıca /mcp altındaki herhangi bir yola kimlik doğrulaması olmadan yapılan istek 401 döner, 404 değil; bu yüzden sadece 401 görmek uç noktanın var olup olmadığını göstermez.

api.wink.travel/mcp/channel-manager’a bağlandım ama sonuç yok

O uç nokta yoktur. Kanal yöneticisi entegrasyonu yalnızca https://integrations.wink.travel/mcp/channel-manager üzerinden sunulur. Kendi fiyatlarını elle okumak veya yazmak istiyorsanız, bu ayrı bir iştir ve ayrı bir uç noktadır — bkz. /mcp/extranet/rates.

Sunucu görünüyor ama araç çağrıları “hesap bulunamadı” diyor

Wink hesabınızda yönetim varlığı yok. Wink Portal’a gidin ve hesabınızın kurulu olduğundan emin olun.

Token oturum ortasında sona eriyor

Tokenler 3 saat geçerlidir. Claude Code ve Claude Desktop tokenleri sessizce yeniler, oturumunuz kesilmez. Uzun süre boş kaldıktan sonra kimlik doğrulama hatası alırsanız yeni bir mesaj yazın — istemci otomatik olarak yeniden kimlik doğrulaması yapar.

Codex CLI “MCP server unreachable” gösteriyor

~/.codex/config.json dosyanızın geçerli JSON olduğundan (sonunda virgül yok) ve "type": "http" olarak ayarlandığından emin olun. Codex uzak sunucular için HTTP taşıma gerektirir; stdio taşıma yalnızca yerel ikililer içindir.

ChatGPT “Connectors” menüsü yok

MCP desteği ChatGPT masaüstü uygulaması sürüm 1.2024.352 veya daha yenisini ve aktif Plus, Pro, Team veya Enterprise aboneliğini gerektirir. Uygulamayı güncelleyin ve Ayarlar → Hesap bölümünden planınızı doğrulayın.

Cursor sunucusu kırmızı / “Bağlantı başarısız”

~/.cursor/mcp.json dosyanızın geçerli JSON ve "type": "http" içerdiğini doğrulayın. Sonra Ayarlar → Cursor Ayarları → MCP bölümüne gidin ve Yenile’ye tıklayın. Hata devam ederse Cursor’u tamamen yeniden başlatın — yapılandırma değişiklikleri bazen yeniden başlatma olmadan alınmaz.

Windsurf MCP sunucuları ayarlarda görünmüyor

Windsurf, mcp_config.json değişikliklerini almak için tam yeniden başlatma (sadece pencere yenileme değil) gerektirir. Dosya → Çıkış yapın ve yeniden açın. Sunucular hala görünmüyorsa Windsurf sürümünüzün 1.4+ olduğunu Yardım → Windsurf Hakkında üzerinden kontrol edin.

Cline “Sunucu Ekle” seçeneği görünmüyor

MCP sunucu yöneticisi Cline 2.0 veya daha yeni sürüm gerektirir. VS Code Uzantılar panelini açın, Cline’ı bulun ve güncelleme varsa Güncelle’ye tıklayın. Güncelledikten sonra VS Code’u yeniden yükleyin (Ctrl+Shift+P → “Developer: Reload Window”).


Wink Portalı Aç GitHub’da Wink