> ## Documentation Index
> Fetch the complete documentation index at: https://docs.topsort.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Servidor MCP de Analytics
> Conecta tus agentes de IA a la plataforma publicitaria de Topsort para análisis en tiempo real y operaciones de catálogo
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](/api/mcp) 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`:
```json theme={null}
{
"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:
```json theme={null}
{
"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
Conecta ChatGPT a los analytics de Topsort
Configura Claude Desktop con autenticación
Prueba el servidor MCP con Postman
## ChatGPT
ChatGPT soporta servidores MCP remotos para suscriptores Plus y Team.
Navega a [chat.openai.com](https://chat.openai.com) y haz clic en el ícono de tu perfil, luego selecciona **Settings**.
Haz clic en **Connections** o **Integrations** en la barra lateral de configuración.
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
* **macOS**: Haz clic en **Claude** en la barra de menú → **Settings**
* **Windows**: Haz clic en **File** → **Settings**
Haz clic en la pestaña **Developer** en la barra lateral izquierda.
Haz clic en **Edit Config** y agrega:
```json theme={null}
{
"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:
```json theme={null}
{
"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"
]
}
}
}
```
Guarda la configuración y reinicia Claude Desktop.
## Postman
Puedes probar el servidor MCP de Analytics usando el soporte MCP de Postman.
Inicia Postman y navega a **Settings** → **MCP Servers**.
Haz clic en **Add Server** y configura:
* **Name**: `Topsort Analytics`
* **URL**: `https://mcp-server.api.topsort.ai/mcp`
Agrega los headers requeridos:
* `X-API-Key`: Tu clave de API de Topsort
* `X-Vendor-Id`: (Opcional) ID de Vendedor para acceso con alcance
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](https://status.topsort.com) para ver si hay interrupciones del servicio
## Más Información
* [Documentación del Model Context Protocol](https://modelcontextprotocol.io)
* [Lista de Clientes MCP](https://modelcontextprotocol.io/clients)
* [Documentación de la API de Topsort](/api-reference)
* [Servidor MCP de Documentación](/api/mcp) - Para integración de API asistida por IA