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.
claude mcp add wink-channel-manager https://integrations.wink.travel/mcp/channel-manager --transport httpclaude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport httpAraç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.
Uç nokta dizini
Bölüm başlığı “Uç nokta dizini”İki sunucu araç setleri sağlar. Araç sayıları yaklaşık olup zamanla artar.
https://api.wink.travel — platform
Bölüm başlığı “https://api.wink.travel — platform”| Uç Nokta | Araçlar | Kapsadığı Alan |
|---|---|---|
/mcp/extranet/facilities | ~64 | Rezervasyon 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 | ~62 | Mülk kaydı ve ticari koşulları: profil ve içerik, ek hizmetler, iptal politikaları, avantajlar, duyurular |
/mcp/settings | ~60 | Hesap yönetimi: yönetim varlığı profili ve markalaşma, yöneticiler ve yetkileri, özelleştirme, web kancaları, bildirim tercihleri |
/mcp/studio/embeds | ~48 | Kü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 | ~44 | Fiyatlar ve müsaitlik: envanter fiyat dönemleri ve kontenjanlar, fiyat planları, ana fiyatlar, özel ve promosyon fiyatları |
/mcp/extranet/operations | ~39 | Canlı mülk yönetimi: rezervasyonlar ve yaşam döngüsü, misafir yorumları ve yanıtları, takvim beslemeleri, planlanmış görevler |
/mcp/extranet/distribution | ~37 | Envanterin 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 | ~35 | Satılabilir koleksiyonlar oluşturma: statik ve dinamik listeler, sıralı listeler, kaydedilmiş aramalar, mülk toplulukları |
/mcp/link-manager | ~28 | Senkronize bağlantı koleksiyonları, tasarımları, kategoriler ve etiketler, ayrıca kısaltılmış URL’ler |
/mcp/reference | ~24 | Salt okunur arama verileri: ülkeler, para birimleri ve döviz kurları, diller, zaman dilimleri, coğrafi aramalar, IP coğrafi konumu |
/mcp/analytics | ~18 | Rezervasyon ve gelir analizleri: genel bakışlar, çizgi grafikler, lider tabloları, bağlı kuruluş performansı, paylaşım metrikleri |
/mcp/payment | ~18 | Finansal işlemler: defter, çekimler ve ücret tahminleri, rezervasyon fonu toplamları |
/mcp/booking-engine | ~17 | Seyahat edenlere yönelik alışveriş yolu: arama ve sorgulama, alışveriş sepeti ve ödeme, istek listeleri, kampanya özelleştirme |
/mcp/social | ~17 | Bağlı sosyal hesaplar, gönderi yayınlama ve zamanlama, gönderi analizlerini okuma |
/mcp/travel-agent | ~8 | Seyahat 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ç Nokta | Araçlar | Kapsadığı Alan |
|---|---|---|
/mcp/channel-manager | ~9 | Bir 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.
Hangi araç setlerine ihtiyacım var?
Bölüm başlığı “Hangi araç setlerine ihtiyacım var?”| Eğer siz… | Bağlanın |
|---|---|
| Bir kanal yöneticisi, PMS veya CRS entegre ediyorsanız | integrations.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.
Kimlik doğrulama nasıl çalışır
Bölüm başlığı “Kimlik doğrulama nasıl çalışır”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:
- AI istemciniz MCP uç noktasının
/.well-known/oauth-protected-resourcemeta verisinden yetkilendirme sunucusunu keşfeder. - İstemci Dinamik İstemci Kaydı ile kendini kaydeder — manuel uygulama kurulumu gerekmez.
- İstemci
https://iam.wink.traveladresine bir tarayıcı sekmesi açar. Wink hesabınızla oturum açar ve izin ekranında istenen izinleri onaylarsınız. - Wink, hesabınıza ve kimliğinize bağlı bir erişim belirteci verir.
- 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.
- 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.
AI istemcinizi bağlayın
Bölüm başlığı “AI istemcinizi bağlayın”-
Claude Code’un güncel olduğundan emin olun:
Terminal window npm install -g @anthropic-ai/claude-code -
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 -
Claude Code sunucuya bağlanır, yetkilendirme sunucusunu keşfeder ve varsayılan tarayıcınızı açar.
-
Wink’te oturum açın ve izin ekranında izin isteğini onaylayın.
-
Claude Code bağlantıyı doğrular. Sunucunun göründüğünü ve araçların yüklendiğini doğrulamak için
/mcpyazın.
İşinizin ihtiyaç duyduğu kadar araç seti ekleyin — her biri kendi adıyla ayrı bir sunucu girişi:
claude mcp add wink-operations https://api.wink.travel/mcp/extranet/operations --transport httpclaude mcp add wink-analytics https://api.wink.travel/mcp/analytics --transport httpSadece 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.
-
Claude Desktop yapılandırma dosyasını düzenleyin:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
- macOS:
-
MCP sunucu girişlerini ekleyin:
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"}}} -
Claude Desktop’u tamamen kapatıp yeniden başlatın (menüden Çıkış kullanın — pencereyi kapatmak yeterli değildir).
-
Claude Desktop her yeni sunucu için bir tarayıcı sekmesi açar. Wink’te oturum açın ve izinleri onaylayın.
-
Alt araç çubuğundaki fiş simgesi her iki sunucunun bağlı olduğunu gösterir.
-
Codex CLI’nin yüklü olduğundan emin olun:
Terminal window npm install -g @openai/codex -
Codex yapılandırma dosyasını açın (veya oluşturun):
- macOS / Linux:
~/.codex/config.json - Windows:
%USERPROFILE%\.codex\config.json
- macOS / Linux:
-
Wink MCP sunucu girişlerini ekleyin:
~/.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"}}} -
Codex’i başlatın. İlk kullanımda Codex
https://iam.wink.traveladresine bir tarayıcı sekmesi açar. -
Wink’te oturum açın ve istenen izinleri onaylayın.
-
Codex bağlantıyı doğrular.
codexkomutunu çalıştırın ve Wink sunucularının aktif olduğunu doğrulamak için mevcut araçları listelemesini isteyin.
MCP sunucu desteği, Plus, Pro, Team ve Enterprise aboneleri için ChatGPT masaüstü uygulamasında mevcuttur.
-
Henüz yapmadıysanız ChatGPT masaüstü uygulamasını indirin ve kurun.
-
Uygulamayı açın ve sağ üst köşedeki profil simgenize tıklayın, ardından Ayarlar’ı seçin.
-
Bağlayıcılar (veya uygulama sürümünüze bağlı olarak MCP Sunucuları) bölümüne gidin ve Ekle’ye tıklayın.
-
Yukarıdaki dizinden bir araç seti URL’si girin, örneğin:
https://api.wink.travel/mcp/extranet/ratesArdından Bağlan’a tıklayın.
-
ChatGPT
https://iam.wink.traveladresine bir tarayıcı sekmesi açar. Wink’te oturum açın ve izinleri onaylayın. -
İşinizin ihtiyaç duyduğu diğer araç setleri için 4–5. adımları tekrarlayın, örneğin:
https://api.wink.travel/mcp/extranet/operations -
Her araç seti Bağlayıcılar listenizde görünür. Yeni bir sohbet başlatın — Wink araçları otomatik olarak kullanılabilir.
-
Cursor MCP yapılandırma dosyasını açın (veya oluşturun):
- macOS / Linux:
~/.cursor/mcp.json - Windows:
%USERPROFILE%\.cursor\mcp.json
- macOS / Linux:
-
Wink MCP sunucu girişlerini ekleyin:
~/.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"}}} -
Cursor’u açın. Ayarlar → Cursor Ayarları → MCP bölümüne gidin ve her iki sunucunun yeşil durum göstergesiyle göründüğünü doğrulayın. Kırmızı görünüyorsa Yenile’ye tıklayın.
-
Cursor
https://iam.wink.traveladresine bir tarayıcı sekmesi açar. Wink’te oturum açın ve izinleri onaylayın. -
Bir sohbet açın (
Ctrl+L/Cmd+L) ve bağlantıyı doğrulamak için Cursor’dan mevcut Wink araçlarını listelemesini isteyin.
-
Windsurf MCP yapılandırma dosyasını açın (veya oluşturun):
- macOS / Linux:
~/.codeium/windsurf/mcp_config.json - Windows:
%USERPROFILE%\.codeium\windsurf\mcp_config.json
- macOS / Linux:
-
Wink MCP sunucu girişlerini ekleyin:
~/.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"}}} -
Windsurf’u tamamen yeniden başlatın (Dosya → Çıkış, sonra yeniden açın).
-
Ayarlar → MCP Sunucuları bölümüne gidin ve her iki sunucunun bağlı olduğunu doğrulayın. Windsurf ilk kullanımda
https://iam.wink.traveladresine bir tarayıcı sekmesi açar. -
Wink’te oturum açın ve izinleri onaylayın. Kimlik doğrulandıktan sonra sunucular ayarlar panelinde yeşile döner.
Cline, yerleşik MCP sunucu yöneticisi olan bir VS Code uzantısıdır. Manuel JSON düzenlemesi gerekmez.
-
VS Code Marketplace’ten Cline’ı yükleyin:
- VS Code’u açın ve
Ctrl+Shift+X/Cmd+Shift+Xtuşlarına basın - Cline arayın ve Yükle’ye tıklayın
- VS Code’u açın ve
-
Aktivite Çubuğundaki (sol kenar çubuğu) Cline simgesine tıklayarak Cline panelini açın.
-
Cline araç çubuğundaki MCP Sunucuları simgesine (fiş simgesi) tıklayın, ardından MCP Ayarlarını Düzenle’yi seçin.
-
VS Code
cline_mcp_settings.jsondosyasını açar. Wink girişlerini ekleyin: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"}}} -
Dosyayı kaydedin. Cline otomatik olarak yeniden yüklenir ve
https://iam.wink.traveladresine bir tarayıcı sekmesi açar. -
Wink’te oturum açın ve izinleri onaylayın. MCP Sunucuları panelinde her iki sunucu da aktif görünür.
İzinler (Scopes)
Bölüm başlığı “İzinler (Scopes)”İ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.removeizinleri 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ğinbooking.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.
Sorun Giderme
Bölüm başlığı “Sorun Giderme”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:
# Claude Codeclaude mcp remove wink-ratesclaude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport httpClaude 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
