MCP Sunucusu

Genel Bakış

Barındırılan Wink MCP sunucusu şu adreste mevcuttur:

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

Uyumlu AI istemcilerini (VS Code, Cursor, MCP HTTP taşımasını uygulayan diğerleri) bu uç noktaya yönlendirerek şunları yapmalarını sağlayın:

Ürün ve platform dokümanlarını gezinmek (wink://docs/...)
Canlı OpenAPI spesifikasyonları ve işlem dokümanlarını gezinmek (wink://api/...)
Dokümanlar ve canlı API’ler üzerinde hafif semantik / anahtar kelime araması yapmak

Taşıma

Birincil akış destekli HTTP uç noktasını kullanın:

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

İstemciniz yalnızca SSE destekliyorsa, şu adresi kullanın:

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

Claude Code

Resmi dokümanlar: Claude Code’u MCP aracılığıyla araçlara bağlama

Anthropic, bulut barındırılan MCP sunucuları için uzak HTTP taşımasını önerir:

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

Claude Code içinde, sunucu durumunu incelemek için /mcp komutunu çalıştırın. Sunucuyu tüm depo ile paylaşmak isterseniz, yapılandırmayı .mcp.json dosyasına yazması için --scope project ekleyin.

Codex

Resmi dokümanlar: Codex için Docs MCP hızlı başlangıç

OpenAI, MCP kurulumunu Codex CLI üzerinden belgeler ve yapılandırmanın IDE uzantısıyla paylaşıldığını belirtir:

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

Cursor

Cursor MCP dokümanları: https://cursor.com/docs/context/mcp Kurulum: MCP ayarları üzerinden uzak sunucu ekleyin.

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

VS Code

Resmi dokümanlar: https://code.visualstudio.com/docs/copilot/customization/mcp-servers Minimal uzak yapılandırma (kullanıcı veya çalışma alanı mcp.json):

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

İpuçları:

Bağlantıyı doğrulamak ve araçları gezmek için Komut Paletini kullanın: “MCP: List Servers”.
Araç seçici ile api_search ve docs_search özelliklerini etkinleştirebilir/devre dışı bırakabilirsiniz.
Bağlam ekleyin: Sohbet görünümü → Bağlam Ekle → MCP Kaynakları ile doküman sayfalarını iliştirin.

Temel Kaynak URI’leri

URI	Açıklama
`wink://docs`	Dokümantasyon dizini (kategoriye göre gruplanmış)
`wink://docs/{path}`	Belirli dokümantasyon makalesi (Markdown / MDX)
`wink://api`	Wink’in swagger yapılandırmasından keşfedilen canlı OpenAPI kataloğu
`wink://api/{apiName}`	Kimlik doğrulama, etiketler, başlıklar ve örnek işlemlerle kompakt API özeti
`wink://api/{apiName}/operations`	Etikete göre gruplanmış tam işlem listesi
`wink://api/{apiName}/operation/{key}`	Bireysel işlem detayı (parametreler, istek gövdesi, yanıtlar)
`wink://api/{apiName}/schema/{schemaName}`	İç içe alanlar, türler ve örneklerle çözülmüş bileşen şeması
`wink://api/{apiName}/operation/{key}/request`	Gerekli girdiler ve minimal örnek yük ile istek odaklı görünüm
`wink://api/{apiName}/operation/{key}/response/{status}`	Belirli bir durum kodu için yanıt odaklı görünüm
`wink://api/{apiName}/operation/{key}/recipe`	O işlemin doğru şekilde çağrılması için görev odaklı akış

Arama Araçları (Hızlı Referans)

Araç	Amaç	Tipik Sorgu Örnekleri
`api_search`	Entegre edilecek canlı API veya işlemi bulmak	`create affiliate`, `payment receipt`, `lookup inventory`, `invite manager`
`docs_search`	Kavramsal dokümanlar / rehberler bulmak	`authentication`, `webhooks`, `wordPress`

Öneri almak için query alanını boş bırakın. Her sonuç, açabileceğiniz MCP URI’sini içerir. İşlem sonuçlarında, api_search ayrıca bağlı istek, yanıt, şema ve tarif URI’lerini döndürür; böylece ajanlar en faydalı alt kaynağa doğrudan atlayabilir.

Tipik Kullanım Deseni

Niyetinizle api_search çalıştırın (örneğin “create affiliate” veya “payment receipt”).
Dönen wink://api/... URI’sini açın veya bağlı request_uri, response_uris, request_schema_uris, response_schema_uris ve recipe_uri alanlarını takip edin.
Destekleyici kavramlar için docs_search kullanın (kimlik doğrulama, webhooks, iş akışları).

AI Yetenekleri

Önceden hazırlanmış ajan yetenekleri, bu MCP sunucusunu gerçek bilgi kaynağı olarak kullanır. Yetenekler, kodlama ajanınıza Wink API’lerine karşı yapılandırılmış bir iş akışı sunar — uç noktaları tahmin etmek yerine, ajan MCP sunucusundan canlı sözleşmeleri doğrudan okur.

Mevcut yetenekler ve kurulum talimatları için AI Skills sayfasına bakın.

Notlar

Dönen her URI, ajan tarafından tam içerik için açılabilir.
wink://api ağacı canlıdır ve oluşturulmuş depo dizini yerine mevcut üst akış OpenAPI kataloğunu takip eder.
Sorgular boş bırakıldığında öneriler otomatik olarak görünür.

GitHub’da Wink