Verbinden Sie WinningHunter mit KI-Tools

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

Wenn Sie eine eigene Installation betreiben, verwenden Sie Ihre eigene Domain mit /mcp am Ende.

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

Bevor Sie beginnen#

1. MCP-URL (https://app.winninghunter.com/mcp)
2. Eine Authentifizierungsmethode:
   • OAuth (recommended for Claude custom connector)
   • API-Schlüssel-Header (X-API-Key: wh_...) for Cursor, n8n, Claude Code / Desktop JSON

OAuth discovery:

Claude (benutzerdefinierter Anschluss)#

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. Geöffnet: https://claude.ai/customize/connectors?modal=add-custom-connector
2. Klicken Sie auf „Benutzerdefinierten Konnektor hinzufügen“.
3. Geben Sie einen beliebigen Namen ein (zum Beispiel WinningHunter).
4. MCP-URL einfügen: https://app.winninghunter.com/mcp
5. Click Add.
6. Claude startet die OAuth-Anmeldung und fordert dich auf, dich bei WinningHunter anzumelden.
7. Genehmige den Zugang und kehre dann zu Claude zurück.

Überprüfung abgeschlossen: Öffne einen neuen Chat und bitte Claude, die verfügbaren Tools aufzulisten. Du solltest die WinningHunter-Tools sehen.

Cursor (3 Schritte)#

1. Cursor-Einstellungen für MCP öffnen (oder erstellen) .cursor/mcp.json (in Ihrem Projekt).
2. Füge denselben JSON-Code wie oben ein.
3. Speichern Sie die Datei und laden Sie MCP neu (oder starten Sie Cursor neu).

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

Überprüfung abgeschlossen: Fordere Cursor auf, die WinningHunter-MCP-Tools aufzurufen oder aufzulisten.

Cursor kann weiterhin API-Schlüssel-Header verwenden. OAuth ist dort optional.

ChatGPT (OpenAI)#

Wenn in Ihrem Arbeitsbereich „Apps + MCP“ aktiviert ist, gehen Sie wie folgt vor:

1. Öffnen Sie die ChatGPT -Einstellungen.
2. Gehe zu „Apps “ -> „Erweiterte Einstellungen“.
3. Aktivieren Sie den Entwicklermodus.
4. Klicken Sie auf „App erstellen“.
5. Geben Sie einen beliebigen App-Namen ein (zum Beispiel WinningHunter).
6. Stellen Sie die MCP-Server-URL auf https://app.winninghunter.com/mcp.
7. Klicken Sie auf „Erstellen“ (oder „Verbinden“, je nach Benutzeroberfläche).

Wenn ChatGPT OAuth für Ihren Konnektor-Ablauf unterstützt, verwenden Sie OAuth. Wenn Ihr Bildschirm stattdessen benutzerdefinierte Header unterstützt, können Sie weiterhin X-API-Schlüssel.

OpenAI MCP-Dokumentation: MCP für ChatGPT-Apps

Gemini (Google)#

Wenn Ihr Gemini-Konto MCP-Konnektoren unterstützt:

1. Einen MCP-Server hinzufügen.
2. URL verwenden https://app.winninghunter.com/mcp.
3. Verwende OAuth, wenn Gemini dies verlangt. Falls in deinem Client die Authentifizierung über den Header verfügbar ist, X-API-Schlüssel wird ebenfalls unterstützt.

Gemini MCP-Dokumentation: MCP-Server mit Gemini CLI

n8n#

Verwenden Sie den Knoten „MCP Client“ (oder den Knoten „MCP Client Tool“):

1. Fügen Sie den MCP-Knoten in Ihren Workflow ein.
2. Server-URL festlegen auf https://app.winninghunter.com/mcp.
3. Header „auth“ hinzufügen: X-API-Schlüssel = dein wh_... Schlüssel.

n8n-Dokumentation: MCP-Client

Was Sie erhalten#

Sie können folgende Abfrage durchführen:

• TikTok Shop: Produkte, Shops, Creator, Videos, Kategorien, trending
• Suche in der Meta-Anzeigenbibliothek
• Liste der Marken-Tracker, Analyse und Verfolgung neuer Meta-Seiten
• Shopify-Shop-Suche und Verfolgung neuer Shops/Domains
• Exploding Topics – Suche + Details
• Überprüfung des Guthabens

Die meisten MCP-Tools sind schreibgeschützt. Write / generate tools: Marke, track_store, save_adund get_ad_transcript.

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

Guthaben und Limits (einfache Version)#

• Tools/Anruf Erfolg = 1 API-Guthaben
• Werkzeuge/Liste und die Verbindungstests führen nicht Gebühr
• Missing/invalid auth → MCP OAuth / JSON-RPC error (not always the REST { success: false, error: "Unauthorized" } envelope)
• No API access → 403 mit WinningHunter Basic plan or higher required for MCP access.
• MCP tool rate limit is 300/min (separate from HTTP 60/min)

Alle Details: Gutschriften und Abrechnung, Ratenbegrenzungen, Fehlerbehebung

Nächste Seite#

Benötigen Sie die genauen Namen der Tools und deren Argumente? Öffnen Sie:

MCP-Tools – Referenz