WinningHunter'ı yapay zeka araçlarına bağlayın

WinningHunter has one MCP endpoint. Paste it into Claude, Cursor, ChatGPT, Gemini, or n8n.

Kendi kurulumunuzu yapıyorsanız, kendi alan adınızı şu şekilde kullanın: /mcp sonunda.

Recommended: start with Claude. Its custom connector flow uses OAuth, so setup is usually the quickest.

Başlamadan önce#

1. MCP URL'si (https://app.winninghunter.com/mcp)
2. Tek bir kimlik doğrulama yöntemi:
   • OAuth (recommended for Claude custom connector)
   • API anahtarı başlığı (X-API-Key: wh_...) for Cursor, n8n, Claude Code / Desktop JSON

OAuth discovery:

Claude (özel konektör)#

Claude Code / Desktop (API key)#

claude mcp add --transport http winninghunter \
  https://app.winninghunter.com/mcp \
  --header "X-API-Key: ${WH_API_KEY}"

Or JSON:

{
  "mcpServers": {
    "winninghunter": {
      "url": "https://app.winninghunter.com/mcp",
      "headers": {
        "X-API-Key": "wh_paste_your_api_key_here"
      }
    }
  }
}

Claude.ai web (OAuth)#

1. Açık: https://claude.ai/customize/connectors?modal=add-custom-connector
2. " Özel bağlayıcı ekle" seçeneğine tıklayın.
3. Herhangi bir isim girin (örneğin WinningHunter).
4. MCP URL'sini yapıştır: https://app.winninghunter.com/mcp
5. Click Add.
6. Claude, OAuth oturum açma işlemini başlatacak ve sizden WinningHunter'da oturum açmanızı isteyecektir.
7. Erişimi onaylayın, ardından Claude'a dönün.

Kontrol tamamlandı: Yeni bir sohbet penceresi açın ve Claude'dan mevcut araçları listelemesini isteyin. WinningHunter araçlarını görmelisiniz.

İmleç (3 adım)#

1. MCP için İmleç ayarlarını aç (veya oluştur) .cursor/mcp.json (projenizde).
2. Yukarıdaki JSON'u yapıştırın.
3. Kaydedin, ardından MCP'yi yeniden yükleyin (veya Cursor'u yeniden başlatın).

{
  "mcpServers": {
    "winninghunter": {
      "url": "https://app.winninghunter.com/mcp",
      "headers": {
        "X-API-Key": "wh_paste_your_api_key_here"
      }
    }
  }
}

Kontrol tamamlandı: Cursor'dan WinningHunter MCP araçlarını çağırmasını veya listelemesini isteyin.

Cursor, API anahtarı başlıklarını kullanmaya devam edebilir. Bu durumda OAuth isteğe bağlıdır.

ChatGPT (OpenAI)#

Çalışma alanınızda Apps + MCP etkinse, şu adımları izleyin:

1. ChatGPT Ayarlarını açın.
2. Uygulamalar -> Gelişmiş ayarlar'a gidin.
3. Geliştirici modunu etkinleştirin.
4. " Uygulama oluştur" seçeneğine tıklayın.
5. İstediğiniz herhangi bir uygulama adını girin (örneğin WinningHunter).
6. MCP sunucu URL'sini şu şekilde ayarlayın: https://app.winninghunter.com/mcp.
7. Oluştur'a tıklayın (kullanıcı arayüzüne bağlı olarak Bağlan'a da tıklayabilirsiniz).

ChatGPT, konektör akışınız için OAuth'u destekliyorsa OAuth'u kullanın. Ekranınız bunun yerine özel başlıkları destekliyorsa, yine de X-API-Anahtarı.

OpenAI MCP belgeleri: ChatGPT Uygulamaları için MCP

İkizler (Google)#

Gemini hesabınız MCP bağlayıcılarını destekliyorsa:

1. Bir MCP sunucusu ekleyin.
2. URL'yi kullan https://app.winninghunter.com/mcp.
3. Gemini bunu talep ettiğinde OAuth'u tercih edin. İstemcinizde başlık kimlik doğrulaması mevcutsa, X-API-Anahtarı bu da desteklenmektedir.

Gemini MCP belgeleri: Gemini CLI ile MCP sunucuları

n8n#

MCP İstemcisi düğümünü (veya MCP İstemcisi Aracı düğümünü) kullanın:

1. İş akışınıza bir MCP düğümü ekleyin.
2. Sunucu URL'sini şu şekilde ayarlayın: https://app.winninghunter.com/mcp.
3. Başlık yetkilendirmesini ekle: X-API-Anahtarı = senin wh_... anahtar.

n8n belgeleri: MCP İstemcisi

Elinize ne geçiyor?#

Şu sorguyu çalıştırabilirsiniz:

• TikTok Shop ürünleri, mağazalar, içerik üreticiler, videolar, kategoriler, trending
• Meta reklam kütüphanesi araması
• Brand tracker list, analysis, and tracking new Meta pages
• Shopify store search and tracking new stores/domains
• Popüler Konular arama + ayrıntılar
• Kredi bakiyesi kontrolü

Most MCP tools are read-only. Write / generate tools: track_brand, track_store, save_adve get_ad_transcript.

TikTok favorites / filter presets still use the REST API (/api/v1/tiktok-shop/*).

Krediler ve limitler (basit versiyon)#

• araçlar/çağrı başarı = 1 API kredisi
• araçlar/liste ve bağlantı kontrolleri değil ücret
• Missing/invalid auth → MCP OAuth / JSON-RPC error (not always the REST { success: false, error: "Unauthorized" } envelope)
• No API access → 403 ile WinningHunter Basic plan or higher required for MCP access.
• MCP tool rate limit is 300/min (separate from HTTP 60/min)

Tüm ayrıntılar: Ödeme ve faturalandırma, İstek sınırları, Sorun giderme

Sonraki sayfa#

Araçların tam adlarını ve parametrelerini mi arıyorsunuz? Açın:

MCP araçları kılavuzu