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 tanesine 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ığı

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 maliyeti getirir. Bir MCP sunucusunun reklamını yaptığı 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ü 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 kelime dağarcığını taşıması anlamına gelir.

Araç setleri izin değildir

Dar bir araç seti seçmek, hesabınızın yapabileceklerini kısıtlamaz, geniş bir set seçmek ise ekstra bir şey vermez. Her araç, web portalındaki hesap izinlerini, oturum açmış kimliğiniz altında uygular. Hesabınız Wink Portal’da bir rezervasyonu iptal edemiyorsa, ajan da edemez — hangi uç noktaya bağlı olursa olsun.

Araç setlerini odaklanma için seçin, güvenlik için değil.

---

Uç nokta dizini

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

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ı

Tek bir 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

Kanal yöneticisi entegrasyonu ile kendi fiyatlarınızı yönetmek farklıdır

Bunlar farklı işlerdir ve farklı kişiler içindir, aynı uç noktayı paylaşmazlar.

Kanal yöneticisi, PMS veya CRS satıcısı bir kez integrations.wink.travel/mcp/channel-manager üzerinden entegre olur ve o entegrasyon üzerinden mülkler, fiyatlar, müsaitlik ve rezervasyonları değiş tokuş eder. O tek uç nokta tüm yüzeyi kapsar.

Kendi fiyatlarını elle değiştiren bir otelci ise api.wink.travel üzerindeki extranet araç setlerini kullanır — /mcp/extranet/rates ve benzerleri. Bunlar bir kanal yöneticisi entegrasyonunun parçası değildir ve bir entegratörün bunlara bağlanması gerekmez.

Hesap yönetimi de api.wink.travel üzerindedir, /mcp/settings altında. Entegrasyon sunucusunda /mcp/settings yoktur.

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.

Agentik ödemeler

Tam seyahat eden 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 yeri sorgulama, otel ve oda arama, agentic_booking_quote, agentic_booking_pay, agentic_booking_book, rezervasyon alma ve makbuzları içerir; agentik 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.

---

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 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 yeri sorgulama, otel müsaitliği ve oda fiyat detayları, alışveriş sepetleri, ödeme ve seyahat eden rezervasyon yönetimi sağlar. Agentik rezervasyon ve ödeme araçları da o ortam için etkinleştirildiğinde dahildir.

Şehir bazlı otel araması için, hedefi çözmek için destination_lookup_search_suggestions kullanın, ardından müsait otelleri ve fiyatları bulmak için inventory_search_city kullanın. 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 taneyle 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.

Hala her şeyi mi istiyorsunuz?

https://api.wink.travel/mcp ve https://integrations.wink.travel/mcp her iki sunucuda da tüm araçları sağlar. Mevcut olanları keşfetmek için faydalıdırlar, ancak günlük işler için önerilmezler: araç listesi görevinizi gölgede bırakacak kadar büyüktür ve ajanın araç seçimini kötüleştirir. Yukarıdaki araç setlerini tercih edin.

---

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 olanlar şunlardır:

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 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.

---

AI istemcinizi bağlayın

Claude Code

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

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

2. Yukarıdaki dizinden bir araç seti seçin ve ekleyin. Örneğin, fiyatlar ve müsaitlik:

   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 kontrol etmek için /mcp yazı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 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.

Ekibinizle paylaşın

claude mcp add komutuna --scope project ekleyin, Claude Code sunucu URL’sini depo kökünde .mcp.json dosyasına yazar. O dosyayı commit edin — her ekip üyesi aynı araç setlerini alır ve ilk bağlantıda kendi tarayıcı oturum açmasını tamamlar.

Claude Desktop

1. 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

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

3. Claude Desktop’u tamamen kapatıp yeniden başlatın (menüden Çıkış yapın — pencereyi kapatmak yeterli değildir).

4. Claude Desktop her yeni sunucu için bir tarayıcı sekmesi açar. Wink’te oturum açın ve izinleri onaylayın.

5. Alt araç çubuğundaki fiş simgesi her iki sunucunun bağlı olduğunu gösterir.

OpenAI Codex

1. Codex CLI’nin yüklü olduğundan emin olun:

   npm install -g @openai/codex

2. Codex yapılandırma dosyasını açın (veya oluşturun):

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

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

4. Codex’i başlatın. İlk kullanımda Codex https://iam.wink.travel adresine bir tarayıcı sekmesi açar.

5. Wink’te oturum açın ve istenen izinleri onaylayın.

6. Codex bağlantıyı doğrular. codex komutunu çalıştırın ve Wink sunucularının aktif olduğunu doğrulamak için mevcut araçları listelemesini isteyin.

Not

Codex CLI MCP desteği 1.0 veya daha yeni sürüm gerektirir. Sürümü kontrol etmek için codex --version komutunu çalıştırın ve güncellemek için npm install -g @openai/codex kullanın.

ChatGPT

MCP sunucu desteği, Plus, Pro, Team ve Enterprise aboneleri için ChatGPT masaüstü uygulamasında mevcuttur.

1. Henüz yapmadıysanız ChatGPT masaüstü uygulamasını indirin ve kurun.

2. Uygulamayı açın ve sağ üst köşedeki profil simgenize tıklayın, ardından Ayarlar’ı seçin.

3. 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.

4. Yukarıdaki dizinden bir araç seti URL’si girin, örneğin:

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

   Ardından Bağlan’a tıklayın.

5. ChatGPT, https://iam.wink.travel adresine bir tarayıcı sekmesi açar. Wink’te oturum açın ve izinleri onaylayın.

6. İş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

7. 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.

Web uygulaması sınırlaması

MCP sunucuları yalnızca masaüstü uygulamasında yapılandırılabilir. chatgpt.com üzerindeki ChatGPT web arayüzü özel MCP sunucularını desteklemez.

Cursor

1. Cursor MCP yapılandırma dosyasını açın (veya oluşturun):

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

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

3. 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.

4. Cursor, https://iam.wink.travel adresine bir tarayıcı sekmesi açar. Wink’te oturum açın ve izinleri onaylayın.

5. 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.

Proje kapsamlı yapılandırma

~/.cursor/ yerine projenizin köküne bir mcp.json dosyası da koyabilirsiniz. Proje düzeyindeki yapılandırma önceliklidir ve projeyi Cursor’da açan her ekip üyesi için sunucuları kullanılabilir yapar.

Windsurf

1. 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

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

3. Windsurf’u tamamen yeniden başlatın (Dosya → Çıkış, sonra tekrar açın).

4. 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.travel adresine bir tarayıcı sekmesi açar.

5. Wink’te oturum açın ve izinleri onaylayın. Kimlik doğrulandıktan sonra sunucular ayarlar panelinde yeşile döner.

Not

Windsurf MCP desteği 1.4 veya daha yeni sürüm gerektirir. Yardım → Windsurf Hakkında üzerinden kontrol edin ve gerekirse Windsurf web sitesinden güncelleyin.

Cline (VS Code)

Cline, yerleşik MCP sunucu yöneticisi olan bir VS Code uzantısıdır. Manuel JSON düzenlemesi gerekmez.

1. VS Code Marketplace’ten Cline’ı yükleyin:

   • VS Code’u açın ve Ctrl+Shift+X / Cmd+Shift+X tuşlarına basın
   • Cline arayın ve Yükle’ye tıklayın

2. Aktivite Çubuğundaki (sol kenar çubuğu) Cline simgesine tıklayarak Cline panelini açın.

3. Cline araç çubuğundaki MCP Sunucuları simgesine (fiş simgesi) tıklayın, ardından MCP Ayarlarını Düzenle’yi seçin.

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

5. Dosyayı kaydedin. Cline otomatik olarak yeniden yüklenir ve https://iam.wink.travel adresine bir tarayıcı sekmesi açar.

6. Wink’te oturum açın ve izinleri onaylayın. MCP Sunucuları panelinde her iki sunucu da aktif görünür.

Alternatif: URL ile ekleme

MCP Sunucuları panelinde Sunucu Ekle’ye tıklayın ve https://api.wink.travel/mcp/extranet/rates gibi bir araç seti URL’sini doğrudan yapıştırın. Cline yapılandırmayı otomatik doldurur ve JSON düzenlemeden kimlik doğrulamayı yönetir.

---

İ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.remove izinleri MCP taşımasını açmak için ayrıca gereklidir. mcp.* iznine sahip bir istemci herhangi bir Wink MCP uç noktasına kabul edilir, 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 olmayan finansal izin vermez, /mcp/reference’e bağlanmak da oradaki aracın kendi iznini uygulamasını engellemez. Yetkilendirme, belirteciniz ve hesabınızın izinleriyle her araç çağrısında belirlenir.

---

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 belirteciniz eski olabilir. Sunucuyu kaldırıp yeniden ekleyerek yeni oturum açmayı tetikleyin:

# 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 etkilemez. Hangi araç setinde olduğunu bilmiyorsanız, geçici olarak https://api.wink.travel/mcp’ye bağlanın, aracı bulun ve hangi araç setinde listelendiğine bakın.

Araç seti uç noktasında 404 Not Found

Yolu dikkatlice kontrol edin — iç içe araç setleri iki segmentlidir (/mcp/extranet/rates, /mcp/extranet/operations gibi), düz olanlar ise bir segmentlidir (/mcp/link-manager). Kimlik doğrulaması olmayan /mcp altındaki istekler 401 döner, 404 değil; bu yüzden sadece 401 almak uç noktanın var olup olmadığını göstermez.

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

O uç nokta yoktur. Kanal yöneticisi entegrasyonu yalnızca https://integrations.wink.travel/mcp/channel-manager üzerinden sağlanır. Kendi fiyatlarını elle okumak veya yazmak istiyorsanız, bu ayrı bir iştir ve ayrı bir uç noktadadı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ı alırsanız yeni bir mesaj yazın — istemci otomatik olarak yeniden kimlik doğrulaması yapar.

Codex CLI “MCP server unreachable” hatası veriyor

~/.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ı / “Bağlantı başarısız” gösteriyor

~/.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 algılanmaz.

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

Windsurf, mcp_config.json değişikliklerini algılamak 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ğundan emin olun (Yardım → Windsurf Hakkında).

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üncellemeden sonra VS Code’u yeniden yükleyin (Ctrl+Shift+P → “Developer: Reload Window”).

---

Wink Portalı Aç GitHub’da Wink