İçeriğe geç

MCP Sunucuları

Wink’in MCP araçları araç setleri olarak yayınlanır — her biri tek 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 bölünmesinin nedeni

Bölüm başlığı “Araçların uç noktalar arasında bölünmesinin nedeni”

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

Araç tanımları bağlam maliyeti getirir. Bir MCP sunucusunun ilan ettiği her araç, modelin bağlam penceresine iş yapmadan önce açıklaması ve tam parametre şemasıyla birlikte yüklenir. Beş yüz tane, 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ü karar verir. 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üsaitliği senkronize eden biri ile bağlı kuruluş açılış sayfalarını düzenleyen biri neredeyse hiç araç paylaşmaz. İşe göre bölmek, her bağlantının bir işin sözlüğünü taşıması anlamına gelir.


İki ana bilgisayar araç setleri sunar. 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 fonları 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 ana bilgisayar 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.

Tam seyahat rezervasyon akışı için, Wink Booking Engine’i https://api.wink.travel/mcp/booking-engine adresinde ve uyumlu bir ödeme cüzdanı ile bağlayın. Wink MCP eklemek, tarayıcıda oturum açma ve izin seçimini başlatır; istemciniz ardından kimlik doğrulamayı yönetir.

Booking Engine, hedef araması, otel ve oda araması, agentic_booking_quote, agentic_booking_pay, agentic_booking_book, rezervasyon alma ve makbuzları içerir; agentic rezervasyon ve ödeme o ortam için etkinleştirildiğinde. Bağlantı kurulumu, seçilecek izinler ve aramadan onaya kadar adımlar için Agentic Payments sayfasına bakın.


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 AI ajanıyla oda rezervasyonu yapıyorsanız/mcp/booking-engine + uyumlu bir ödeme cüzdanı — bkz. Agentic Payments
Bir rezervasyon deneyimi oluşturuyorsanız/mcp/booking-engine; isteğe bağlı olarak ek aramalar için /mcp/reference

Booking Engine temel rezervasyon iş akışını içerir. Hesap ve özelleştirme keşfi, hedef araması, otel müsaitliği ve oda fiyat detayları, alışveriş sepetleri, ödeme ve seyahat eden rezervasyon yönetimi sağlar. Agentic rezervasyon ve ödeme araçları da o ortam için etkinleştirildiğinde dahildir.

Şehir bazlı otel araması için önce destination_lookup_search_suggestions ile hedefi çözümleyin, sonra inventory_search_city ile müsait otelleri ve fiyatları bulun. Her iki araç da /mcp/booking-engine içindedir, bu nedenle bu akış için Referans bağlantısı gerekmez.

Ülkeler, para birimleri ve döviz kurları, desteklenen diller, zaman dilimleri, daha geniş coğrafi aramalar, OTA sınıflandırmaları veya genel mülk bilgisi gibi destekleyici aramalar gerektiğinde /mcp/reference ekleyin. Bunlar rezervasyon akışına isteğe bağlı eklemelerdir.

Bir tane ile başlayın. Bir aracın yapamadığını sorduğunuzda 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 kez bağlandığınızda şu olur:

  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 adresinde 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 bağlı ve kimliğinize bağlanmış 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 süresi dolar. 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 için de geçerlidir.


Her araç setini Claude’a özel bir bağlayıcı olarak ekleyin. Düzenlenecek bir yapılandırma dosyası veya oluşturulacak bir uygulama ya da gizli anahtar yoktur.

  1. Claude’da Customize › Connectors’ı açın, Add’e tıklayın, sonra Add custom connector’ı seçin.

  2. Bir Ad girin (örneğin Wink Link manager) ve MCP server URL olarak yukarıdaki dizinden bir araç seti girin, örneğin:

    https://api.wink.travel/mcp/link-manager

    Continue’a tıklayın.

  3. Claude Wink oturum açmayı algılar. Authentication: Sign in now ve OAuth client: Register automatically seçeneklerini koruyun, sonra Add’a tıklayın.

  4. Connect’e tıklayın. https://iam.wink.travel adresinde bir Wink oturum açma sayfası açılır. Wink’te oturum açın ve izin ekranındaki izinleri onaylayın.

  5. Bağlayıcının araçları artık sohbetlerinizde kullanılabilir. İşinizin ihtiyaç duyduğu her araç seti için tekrarlayın; her biri kendi bağlayıcısıdı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 kapsamı referansını Kimlik Doğrulama sayfasında görebilirsiniz.

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

  • mcp.read mcp.write mcp.remove kapsamları MCP taşımasını açmak için ayrıca gereklidir. mcp.* kapsamına 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 kapsamını uygular (örneğin booking.read).
  • MCP her zaman oturum açmış kullanıcı olarak hareket eder. AI istemcisi mcp.* kapsamlarını oturum açmanız yoluyla alır, sizin oluşturduğunuz bir Uygulama üzerinden değil. Makine-makine (istemci kimlik bilgileri) belirteçleri MCP taşımasını açamaz; sunucu-sunucu işleri için REST API kullanın.
  • AI istemcisi yalnızca ihtiyaç duyduğu kapsamları ister. İzin ekranında bireysel izinleri reddedebilirsiniz — reddedilen kapsam gerektiren 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 aracın kendi kapsamını uygulamasını engellemez. Yetkilendirme, belirteciniz ve hesabınızın izinleriyle her araç çağrısında 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 belirteciniz eski 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ısında 403 Forbidden

Araç, izin ekranında onaylamadığınız bir kapsam veya hesabınızın sahip olmadığı bir izin gerektiriyor. Sunucuyu yeniden bağlayın — izin ekranı tekrar görünür ve eksik izni onaylayabilirsiniz. Hala başarısız olursa, araç hesabınızda olmayan bir izin ister; 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 etkilemez. Hangi araç setinde olduğunu bilmiyorsanız, geçici olarak https://api.wink.travel/mcp’ye bağlanın, aracı bulun, sonra hangi araç setinde listelendiğine bakın.

Araç seti uç noktasında 404 Not Found

Yolu dikkatlice kontrol edin — iç içe araç setlerinde iki segment vardır (/mcp/extranet/rates, /mcp/extranet- değil), düz olanlarda bir segment (/mcp/link-manager). Ayrıca /mcp altındaki herhangi bir yola kimlik doğrulamasız istek 401 döner, 404 değil; bu yüzden sadece 401 var diye uç noktanın var olup olmadığını anlayamazsınız.

api.wink.travel/mcp/channel-manager’a bağlandım ama hiçbir şey yok

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

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

Wink’te yönetim varlığı olmayan bir hesaba oturum açtınız. Wink Portal’a gidin ve hesabınızın kurulu olduğundan emin olun.

Belirteç oturum ortasında süresi doluyor

Belirteçler 3 saat geçerlidir. Claude Code ve Claude Desktop belirteçleri sessizce yeniler, oturumunuz kesilmez. Uzun süre boş kaldıktan sonra kimlik doğrulama hatası görürseniz yeni bir mesaj yazın — istemci otomatik yeniden kimlik doğrulama 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şımasını gerektirir; stdio taşıması yalnızca yerel ikili dosyalar içindir.

ChatGPT “Connectors” menüsü yok

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

Cursor sunucusu kırmızı / “Failed to connect”

~/.cursor/mcp.json dosyanızın geçerli JSON ve "type": "http" içerdiğini doğrulayın. Sonra Settings → Cursor Settings → MCP bölümüne gidip Refresh’e 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. File → Quit yapıp tekrar açın. Sunucular hala görünmüyorsa Windsurf sürümünüzün 1.4+ olduğunu Help → About Windsurf ile kontrol edin.

Cline “Add Server” 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 Update’e tıklayın. Güncellemeden sonra VS Code’u yeniden yükleyin (Ctrl+Shift+P → “Developer: Reload Window”).


Wink Portalı Aç GitHub’da Wink