Conecta WinningHunter con herramientas de IA

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

Si tienes tu propia instalación, utiliza tu propio dominio con /mcp al final.

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

Antes de empezar#

1. URL de MCP (https://app.winninghunter.com/mcp)
2. Un método de autenticación:
   • OAuth (recommended for Claude custom connector)
   • Encabezado de la clave API (X-API-Key: wh_...) for Cursor, n8n, Claude Code / Desktop JSON

OAuth discovery:

Claude (conector personalizado)#

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. Abierto: https://claude.ai/customize/connectors?modal=add-custom-connector
2. Haz clic en «Añadir conector personalizado».
3. Escribe cualquier nombre (por ejemplo WinningHunter).
4. Pega la URL de MCP: https://app.winninghunter.com/mcp
5. Click Add.
6. Claude iniciará el inicio de sesión mediante OAuth y te pedirá que inicies sesión en WinningHunter.
7. Autoriza el acceso y luego vuelve con Claude.

Comprobación realizada: abre un nuevo chat y pide a Claude que te enumere las herramientas disponibles. Deberías ver las herramientas de WinningHunter.

Cursor (3 pasos)#

1. Abrir la configuración del cursor para MCP (o crear .cursor/mcp.json en tu proyecto).
2. Pega el mismo JSON que el anterior.
3. Guarda y, a continuación, vuelve a cargar MCP (o reinicia Cursor).

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

Comprobación realizada: pide a Cursor que llame o muestre las herramientas MCP de WinningHunter.

Cursor puede seguir utilizando encabezados con claves API. El uso de OAuth es opcional en este caso.

ChatGPT (OpenAI)#

Si en tu espacio de trabajo tienes habilitadas las aplicaciones y MCP, haz lo siguiente:

1. Abre la configuración de ChatGPT.
2. Ve a Aplicaciones -> Ajustes avanzados.
3. Activa el modo de desarrollador.
4. Haz clic en «Crear una aplicación».
5. Introduce el nombre de cualquier aplicación (por ejemplo WinningHunter).
6. Establece la URL del servidor MCP en https://app.winninghunter.com/mcp.
7. Haz clic en «Crear» (o en «Conectar», según la interfaz de usuario).

Si ChatGPT admite OAuth para el flujo de tu conector, utiliza OAuth. Si, por el contrario, tu pantalla admite encabezados personalizados, puedes seguir utilizando Clave X-API.

Documentación de OpenAI MCP: MCP para aplicaciones de ChatGPT

Gemini (Google)#

Si tu cuenta de Gemini es compatible con los conectores MCP:

1. Añadir un servidor MCP.
2. Utilizar URL https://app.winninghunter.com/mcp.
3. Utiliza OAuth cuando Gemini lo solicite. Si tu cliente admite la autenticación por encabezado, Clave X-API también es compatible.

Documentación de Gemini MCP: Servidores MCP con la CLI de Gemini

n8n#

Utiliza el nodo «MCP Client» (o el nodo «MCP Client Tool»):

1. Añade un nodo MCP a tu flujo de trabajo.
2. Establece la URL del servidor en https://app.winninghunter.com/mcp.
3. Añadir encabezado de autenticación: Clave X-API = tu ¿Qué...? clave.

Documentación de n8n: Cliente MCP

Qué incluye#

Puedes consultar:

• Productos, tiendas, creadores, vídeos, categorías y trending de TikTok Shop
• Búsqueda en la biblioteca de anuncios de Meta
• Lista de seguimiento de marcas, análisis y seguimiento de las nuevas páginas de Meta
• Búsqueda en la tienda de Shopify y seguimiento de nuevas tiendas/dominios
• Búsqueda y detalles de «Exploding Topics»
• Comprobación del saldo acreedor

La mayoría de las herramientas de MCP son solo lectura. Write / generate tools: track_brand, track_store, save_ad, y get_ad_transcript.

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

Créditos y límites (versión simplificada)#

• herramientas/llamada éxito = 1 crédito API
• herramientas/lista y comprueban la conexión no cobrar
• Missing/invalid auth → MCP OAuth / JSON-RPC error (not always the REST { success: false, error: "Unauthorized" } envelope)
• No API access → 403 con WinningHunter Basic plan or higher required for MCP access.
• MCP tool rate limit is 300/min (separate from HTTP 60/min)

Más información: Créditos y facturación, Límites de velocidad, Solución de problemas

Página siguiente#

¿Necesitas los nombres exactos de las herramientas y sus argumentos? Abre:

Referencia de herramientas MCP