Saltar para o conteúdo principal
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 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: 
{
  "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: 
{
  "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

ChatGPT

Conectar ChatGPT aos analytics do Topsort

Claude Desktop

Configurar Claude Desktop com autenticação

Postman

Testar o servidor MCP com Postman

​
ChatGPT

ChatGPT suporta servidores MCP remotos para assinantes Plus e Team.
1

Abra as Configurações do ChatGPT

Navegue até chat.openai.com e clique no ícone do seu perfil, depois selecione Settings.
2

Acesse Conexões

Clique em Connections ou Integrations na barra lateral de configurações.
3

Adicione Servidor MCP

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

1

Abra as Configurações do Claude Desktop

  • macOS: Clique em Claude na barra de menu → Settings
  • Windows: Clique em File → Settings
2

Navegue até a Aba Developer

Clique na aba Developer na barra lateral esquerda.
3

Edite a Configuração do MCP

Clique em Edit Config e adicione:
{
  "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:
{
  "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

Reinicie o Claude Desktop

Salve a configuração e reinicie o Claude Desktop.

​
Postman

Você pode testar o servidor MCP de Analytics usando o suporte MCP do Postman.
1

Abra o Postman

Inicie o Postman e navegue até Settings → MCP Servers.
2

Adicione Novo Servidor

Clique em Add Server e configure:
  • Nome: Topsort Analytics
  • URL: https://mcp-server.api.topsort.ai/mcp
3

Configure os Headers

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
4

Teste a Conexão

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 para quaisquer interrupções de serviço

​
Saiba Mais