Connectez WinningHunter à des outils d'IA

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

Si vous gérez votre propre installation, utilisez votre propre domaine avec /mcp à la fin.

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

Avant de commencer#

1. URL MCP (https://app.winninghunter.com/mcp)
2. Une méthode d'authentification :
   • OAuth (recommended for Claude custom connector)
   • En-tête de clé API (Clé X-API : wh_...) for Cursor, n8n, Claude Code / Desktop JSON

OAuth discovery:

Claude (connecteur personnalisé)#

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. Ouvert : https://claude.ai/customize/connectors?modal=add-custom-connector
2. Cliquez sur « Ajouter un connecteur personnalisé ».
3. Entrez un nom (par exemple Chasseur gagnant).
4. Collez l'URL MCP : https://app.winninghunter.com/mcp
5. Click Add.
6. Claude va lancer la connexion via OAuth et vous demandera de vous connecter à WinningHunter.
7. Validez l'accès, puis retournez voir Claude.

Vérification effectuée : ouvrez une nouvelle conversation et demandez à Claude de vous énumérer les outils disponibles. Vous devriez voir les outils WinningHunter.

Curseur (3 étapes)#

1. Ouvrir les paramètres du curseur pour MCP (ou créer .cursor/mcp.json (dans votre projet).
2. Collez le même fichier JSON que ci-dessus.
3. Enregistrez, puis rechargez MCP (ou redémarrez Cursor).

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

Vérification effectuée : demandez à Cursor d'appeler ou d'afficher la liste des outils MCP de WinningHunter.

Cursor peut continuer à utiliser les en-têtes de clé API. L'OAuth est facultatif dans ce cas.

ChatGPT (OpenAI)#

Si la fonctionnalité « Apps + MCP » est activée dans votre espace de travail, procédez comme suit :

1. Ouvrez les paramètres de ChatGPT.
2. Allez dans Applications -> Paramètres avancés.
3. Activez le mode développeur.
4. Cliquez sur « Créer une application ».
5. Choisissez le nom de l'application (par exemple Chasseur gagnant).
6. Définissez l'URL du serveur MCP sur https://app.winninghunter.com/mcp.
7. Cliquez sur Créer (ou Connecter, selon l'interface utilisateur).

Si ChatGPT prend en charge OAuth pour le flux de votre connecteur, utilisez OAuth. Si votre écran prend plutôt en charge les en-têtes personnalisés, vous pouvez tout de même utiliser Clé X-API.

Documentation MCP d'OpenAI : MCP pour les applications ChatGPT

Gemini (Google)#

Si votre compte Gemini prend en charge les connecteurs MCP :

1. Ajouter un serveur MCP.
2. Utiliser l'URL https://app.winninghunter.com/mcp.
3. Privilégiez OAuth lorsque Gemini le demande. Si l'authentification par en-tête est disponible dans votre client, Clé X-API est également pris en charge.

Documentation Gemini MCP : serveurs MCP avec l'interface CLI Gemini

n8n#

Utilisez le nœud « MCP Client » (ou le nœud « MCP Client Tool ») :

1. Ajoutez un nœud MCP à votre flux de travail.
2. Définissez l'URL du serveur sur https://app.winninghunter.com/mcp.
3. Ajouter l'en-tête auth : Clé X-API = ton wh_... clé.

Documentation n8n : Client MCP

Ce que vous obtenez#

Vous pouvez effectuer une recherche :

• Produits, boutiques, créateurs, vidéos, catégories et trending de TikTok Shop
• Recherche dans la bibliothèque de publicités Meta
• Brand tracker list, analysis, and tracking new Meta pages
• Shopify store search and tracking new stores/domains
• Recherche et détails sur les sujets d'actualité
• Vérification du solde créditeur

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

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

Crédits et limites (version simplifiée)#

• outils/appel succès = 1 crédit API
• outils/liste et effectuer des contrôles de connexion pas frais
• Missing/invalid auth → MCP OAuth / JSON-RPC error (not always the REST { success: false, error: "Unauthorized" } envelope)
• No API access → 403 avec WinningHunter Basic plan or higher required for MCP access.
• MCP tool rate limit is 300/min (separate from HTTP 60/min)

Plus d'informations : Crédits et facturation, Limites de débit, Dépannage

Page suivante#

Vous avez besoin des noms exacts des outils et de leurs arguments ? Ouvrez :

Référence des outils MCP