> ## 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
> Conecte seus agentes de IA à plataforma de publicidade do Topsort para análises em tempo real e operações de catálogo
O **Model Context Protocol (MCP)** é um padrão aberto para conectar aplicações de IA a sistemas externos—pense nele como uma porta USB-C para IA. Nosso servidor MCP de Analytics dá aos seus assistentes de IA acesso direto às APIs de análise de publicidade e catálogo do Topsort.
Procurando acesso à documentação? Confira nosso [Servidor MCP de Documentação](/api/mcp) para orientação de integração de API assistida por IA.
## O que Você Pode Fazer
Ao se conectar ao servidor MCP de Analytics do Topsort, os assistentes de IA podem:
* **Analisar o desempenho publicitário** - Consultar métricas em tempo real como CTR, CVR, ROAS, CPC e gastos com publicidade em campanhas ou marketplaces
* **Monitorar a saúde das campanhas** - Verificar a utilização do orçamento, comportamento de lances, pontuações de qualidade e ritmo em tempo real
* **Comparar o desempenho ao longo do tempo** - Executar comparações semana a semana, mês a mês ou de períodos personalizados para identificar tendências e anomalias
* **Comparar com a indústria** - Comparar métricas de campanha com benchmarks de categoria (varejo, farmácia, viagens, etc.)
* **Visualizar insights** - Gerar gráficos de linhas, barras e pizza a partir de qualquer dado analítico para fácil interpretação
* **Obter orientação do Topsort** - Responder perguntas sobre integração de API, solução de problemas e melhores práticas da plataforma
Todas as consultas podem ser limitadas a um vendedor específico, garantindo que os anunciantes acessem apenas seus próprios dados enquanto os operadores de marketplace podem ver insights agregados.
## Início Rápido
Nosso servidor MCP de Analytics está disponível em:
```
https://mcp-server.api.topsort.ai/mcp
```
Este servidor MCP requer autenticação. Entre em contato com seu representante de vendas do Topsort para solicitar uma chave de API com acesso ao servidor MCP.
## Autenticação
### Autenticação do Marketplace
Todas as solicitações devem incluir uma chave de API válida. Para clientes MCP que usam `mcp-remote` (como Claude Desktop), passe a chave através do 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"
]
}
}
}
```
### Filtragem por ID do Vendedor
Os resultados das ferramentas podem ser filtrados para vendedores específicos incluindo o ID do Vendedor no cabeçalho da solicitação. Isso restringe o escopo de todas as ferramentas, prevenindo vazamento de dados 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"
]
}
}
}
```
## Filtragem de Ferramentas
Tags permitem controle de acesso granular sobre quais ferramentas estão disponíveis para diferentes clientes. Cada ferramenta pode ser anotada com uma ou mais tags, e os clientes recebem seus próprios conjuntos de tags.
Ao recuperar ferramentas, o sistema filtra a lista verificando qualquer sobreposição entre as tags do cliente e as tags requeridas de cada ferramenta—um cliente só precisa de uma tag correspondente para obter acesso.
## Guias de Integração
Conectar ChatGPT aos analytics do Topsort
Configurar Claude Desktop com autenticação
Testar o servidor MCP com Postman
## ChatGPT
ChatGPT suporta servidores MCP remotos para assinantes Plus e Team.
Navegue até [chat.openai.com](https://chat.openai.com) e clique no ícone do seu perfil, depois selecione **Settings**.
Clique em **Connections** ou **Integrations** na barra lateral de configurações.
Clique em **Add Connection** e digite:
* **Nome**: `Topsort Analytics`
* **URL do Servidor**: `https://mcp-server.api.topsort.ai/mcp`
* **Tipo de Transporte**: `http`
* **Headers**: Adicione `X-API-Key` com sua chave de API
## Claude Desktop
Claude Desktop fornece suporte MCP local abrangente.
### Pré-requisitos
* **Node.js** instalado no seu sistema (necessário para `mcp-remote`)
### Configuração
* **macOS**: Clique em **Claude** na barra de menu → **Settings**
* **Windows**: Clique em **File** → **Settings**
Clique na aba **Developer** na barra lateral esquerda.
Clique em **Edit Config** e adicione:
```json theme={null}
{
"mcpServers": {
"topsort-analytics": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp-server.api.topsort.ai/mcp",
"--header",
"X-API-Key: MPS_xxxx"
]
}
}
}
```
Substitua `MPS_xxxx` pela sua chave de API real.
Para acesso com escopo de vendedor, adicione um 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"
]
}
}
}
```
Salve a configuração e reinicie o Claude Desktop.
## Postman
Você pode testar o servidor MCP de Analytics usando o suporte MCP do Postman.
Inicie o Postman e navegue até **Settings** → **MCP Servers**.
Clique em **Add Server** e configure:
* **Nome**: `Topsort Analytics`
* **URL**: `https://mcp-server.api.topsort.ai/mcp`
Adicione os headers necessários:
* `X-API-Key`: Sua chave de API do Topsort
* `X-Vendor-Id`: (Opcional) ID do Vendedor para acesso com escopo
Clique em **Test Connection** para verificar se o servidor está respondendo corretamente.
## Solução de Problemas
### Problemas de Conexão
* Verifique se a URL está correta: `https://mcp-server.api.topsort.ai/mcp`
* Certifique-se de que sua chave de API é válida e tem acesso ao servidor MCP
* Verifique sua conexão com a internet
* Reinicie sua aplicação cliente MCP
### Erros de Autenticação
* Confirme que sua chave de API começa com `MPS_`
* Verifique se o header `X-API-Key` está formatado corretamente
* Entre em contato com seu representante de vendas do Topsort se sua chave for rejeitada
### Servidor Não Respondendo
* Verifique se o tipo de transporte está definido como `http`
* Verifique se seu firewall ou VPN está bloqueando a conexão
* Verifique [nossa página de status](https://status.topsort.com) para quaisquer interrupções de serviço
## Saiba Mais
* [Documentação do Model Context Protocol](https://modelcontextprotocol.io)
* [Lista de Clientes MCP](https://modelcontextprotocol.io/clients)
* [Documentação da API Topsort](/api-reference)
* [Servidor MCP de Documentação](/api/mcp) - Para integração de API assistida por IA