Saltar al contenido principal
El Model Context Protocol (MCP) es un estándar abierto para conectar aplicaciones de IA a sistemas externos—piensa en él como un puerto USB-C para IA. Nuestro servidor MCP de Analytics da a tus asistentes de IA acceso directo a las APIs de análisis publicitario y catálogo de Topsort.
¿Buscas acceso a la documentación? Consulta nuestro Servidor MCP de Documentación para orientación de integración de API asistida por IA.

​
Qué Puedes Hacer

Al conectarte al servidor MCP de Analytics de Topsort, los asistentes de IA pueden:
  • Analizar el rendimiento publicitario - Consultar métricas en tiempo real como CTR, CVR, ROAS, CPC y gasto publicitario en campañas o marketplaces
  • Monitorear la salud de las campañas - Verificar la utilización del presupuesto, el comportamiento de las pujas, los puntajes de calidad y el ritmo en tiempo real
  • Comparar el rendimiento a lo largo del tiempo - Ejecutar comparaciones semana a semana, mes a mes o de períodos personalizados para identificar tendencias y anomalías
  • Comparar con la industria - Comparar métricas de campaña con benchmarks de categoría (retail, farmacia, viajes, etc.)
  • Visualizar insights - Generar gráficos de líneas, barras y circulares a partir de cualquier dato analítico para facilitar la interpretación
  • Obtener orientación de Topsort - Responder preguntas sobre integración de API, solución de problemas y mejores prácticas de la plataforma
Todas las consultas pueden limitarse a un vendedor específico, asegurando que los anunciantes solo accedan a sus propios datos mientras los operadores del marketplace pueden ver insights agregados.

​
Inicio Rápido

Nuestro servidor MCP de Analytics está disponible en: 
https://mcp-server.api.topsort.ai/mcp
Este servidor MCP requiere autenticación. Contacta a tu representante de ventas de Topsort para solicitar una clave de API con acceso al servidor MCP.

​
Autenticación

​
Autenticación del Marketplace

Todas las solicitudes deben incluir una clave de API válida. Para clientes MCP que usan mcp-remote (como Claude Desktop), pasa la clave a través del argumento --header: 
{
  "mcpServers": {
    "topsort-analytics": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp-server.api.topsort.ai/mcp",
        "--header",
        "X-API-Key: MPS_xxxx"
      ]
    }
  }
}

​
Filtrado por ID de Vendedor

Los resultados de las herramientas pueden filtrarse para vendedores específicos incluyendo el ID de Vendedor en el encabezado de la solicitud. Esto restringe el alcance de todas las herramientas, previniendo la filtración de datos entre vendedores: 
{
  "mcpServers": {
    "topsort-analytics": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp-server.api.topsort.ai/mcp",
        "--header",
        "X-API-Key: MPS_xxxx",
        "--header",
        "X-Vendor-Id: 1111-2222-3333-4444-55555"
      ]
    }
  }
}

​
Filtrado de Herramientas

Las etiquetas permiten un control de acceso detallado sobre qué herramientas están disponibles para diferentes clientes. Cada herramienta puede ser anotada con una o más etiquetas, y a los clientes se les asigna su propio conjunto de etiquetas. Al recuperar herramientas, el sistema filtra la lista verificando cualquier superposición entre las etiquetas del cliente y las etiquetas requeridas de cada herramienta—un cliente solo necesita una etiqueta coincidente para obtener acceso.

​
Guías de Integración

ChatGPT

Conecta ChatGPT a los analytics de Topsort

Claude Desktop

Configura Claude Desktop con autenticación

Postman

Prueba el servidor MCP con Postman

​
ChatGPT

ChatGPT soporta servidores MCP remotos para suscriptores Plus y Team.
1

Abre la Configuración de ChatGPT

Navega a chat.openai.com y haz clic en el ícono de tu perfil, luego selecciona Settings.
2

Accede a Conexiones

Haz clic en Connections o Integrations en la barra lateral de configuración.
3

Agrega el Servidor MCP

Haz clic en Add Connection e ingresa:
  • Name: Topsort Analytics
  • Server URL: https://mcp-server.api.topsort.ai/mcp
  • Transport Type: http
  • Headers: Agrega X-API-Key con tu clave de API

​
Claude Desktop

Claude Desktop proporciona soporte completo de MCP local.

​
Requisitos Previos

  • Node.js instalado en tu sistema (requerido para mcp-remote)

​
Configuración

1

Abre la Configuración de Claude Desktop

  • macOS: Haz clic en Claude en la barra de menú → Settings
  • Windows: Haz clic en File → Settings
2

Navega a la Pestaña de Desarrollador

Haz clic en la pestaña Developer en la barra lateral izquierda.
3

Edita la Configuración MCP

Haz clic en Edit Config y agrega:
{
  "mcpServers": {
    "topsort-analytics": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp-server.api.topsort.ai/mcp",
        "--header",
        "X-API-Key: MPS_xxxx"
      ]
    }
  }
}
Reemplaza MPS_xxxx con tu clave de API real.Para acceso con alcance de vendedor, agrega un argumento --header adicional:
{
  "mcpServers": {
    "topsort-analytics": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp-server.api.topsort.ai/mcp",
        "--header",
        "X-API-Key: MPS_xxxx",
        "--header",
        "X-Vendor-Id: 1111-2222-3333-4444-55555"
      ]
    }
  }
}
4

Reinicia Claude Desktop

Guarda la configuración y reinicia Claude Desktop.

​
Postman

Puedes probar el servidor MCP de Analytics usando el soporte MCP de Postman.
1

Abre Postman

Inicia Postman y navega a Settings → MCP Servers.
2

Agrega Nuevo Servidor

Haz clic en Add Server y configura:
  • Name: Topsort Analytics
  • URL: https://mcp-server.api.topsort.ai/mcp
3

Configura los Headers

Agrega los headers requeridos:
  • X-API-Key: Tu clave de API de Topsort
  • X-Vendor-Id: (Opcional) ID de Vendedor para acceso con alcance
4

Prueba la Conexión

Haz clic en Test Connection para verificar que el servidor responde correctamente.

​
Solución de Problemas

​
Problemas de Conexión

  • Verifica que la URL sea correcta: https://mcp-server.api.topsort.ai/mcp
  • Asegúrate de que tu clave de API sea válida y tenga acceso al servidor MCP
  • Verifica tu conexión a internet
  • Reinicia tu aplicación cliente MCP

​
Errores de Autenticación

  • Confirma que tu clave de API comience con MPS_
  • Verifica que el header X-API-Key esté formateado correctamente
  • Contacta a tu representante de ventas de Topsort si tu clave es rechazada

​
El Servidor No Responde

  • Verifica que el tipo de transporte esté configurado en http
  • Verifica si tu firewall o VPN está bloqueando la conexión
  • Consulta nuestra página de estado para ver si hay interrupciones del servicio

​
Más Información