🚀 Primeiros Passos

Conectar ao ChatGPT, Claude e Cursor (MCP)

URL do servidor MCP, autenticação com API Key e configuração em cada assistente de IA

O Track Combo tem um servidor MCP (Model Context Protocol) que conecta sua conta a assistentes de IA externos. Com ele, o assistente consegue auditar o traqueamento de um site, ler a Central de Ajuda e, com uma API Key, consultar e configurar seus projetos, domínios, integrações, pixels e eventos.

Dados de conexão

Campo Valor
URL do servidor MCP https://mcp.trackcombo.com/mcp
Transporte Streamable HTTP (remoto)
Autenticação Header Authorization: Bearer SUA_API_KEY

A API Key começa com tc_live_. Para criar uma, abra MCP no menu lateral do painel (ou Minha conta → API Keys), clique em Gerar chave e copie. A chave aparece uma única vez.

O que funciona com e sem API Key

Sem API Key Com API Key
Auditar o traqueamento de qualquer URL Tudo da coluna ao lado
Explicar achados e como corrigir Listar e editar projetos
Ler os artigos da Central de Ajuda Conectar e verificar domínios
Criar integrações e pixels
Pegar o código da tag web
Consultar eventos recentes

Qual cliente suporta API Key

Nem todo assistente permite enviar um header de autenticação para servidores MCP. Hoje:

Cliente Conecta? Aceita a API Key?
Claude Code Sim Sim
Cursor Sim Sim
Claude Desktop (via arquivo de configuração) Sim Sim
ChatGPT Sim Não: só as ferramentas gratuitas
Claude.ai (web, conectores personalizados) Sim Não: só as ferramentas gratuitas

O ChatGPT e o Claude.ai web só aceitam OAuth ou conexão sem autenticação em conectores personalizados. Por isso, nesses dois clientes a API Key não é usada e apenas as ferramentas gratuitas ficam disponíveis. O suporte a login via OAuth está no nosso roadmap.

Se você quer acessar os dados da sua conta, use Claude Code, Cursor ou Claude Desktop.

Claude Code

Rode no terminal:

claude mcp add --transport http trackcombo https://mcp.trackcombo.com/mcp \
  --header "Authorization: Bearer tc_live_SUA_CHAVE"

Confira com claude mcp list. Sem o --header, só as ferramentas gratuitas ficam ativas.

Cursor

Adicione em ~/.cursor/mcp.json (ou no .cursor/mcp.json do projeto):

{
  "mcpServers": {
    "trackcombo": {
      "url": "https://mcp.trackcombo.com/mcp",
      "headers": { "Authorization": "Bearer tc_live_SUA_CHAVE" }
    }
  }
}

Reinicie o Cursor e confira em Settings → MCP se o servidor aparece ativo.

Claude Desktop (com API Key)

A tela de conectores do Claude Desktop não aceita header de autenticação. Para usar a API Key, configure pelo arquivo claude_desktop_config.json (em Settings → Developer → Edit Config). É preciso ter o Node.js instalado:

{
  "mcpServers": {
    "trackcombo": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.trackcombo.com/mcp", "--header", "Authorization:${TC_AUTH}"],
      "env": { "TC_AUTH": "Bearer tc_live_SUA_CHAVE" }
    }
  }
}

Salve e reinicie o Claude Desktop.

ChatGPT (ferramentas gratuitas)

Disponível nos planos Plus, Pro, Business, Enterprise e Education, na versão web.

  1. Ative o modo desenvolvedor em Configurações → Segurança e login (em alguns planos, Configurações → Apps e conectores → Avançado).
  2. Crie um novo app/conector MCP.
  3. Em URL do servidor MCP, cole https://mcp.trackcombo.com/mcp.
  4. Em Autenticação, escolha Sem autenticação.
  5. Salve e ative o conector no campo de mensagem (ferramenta Modo desenvolvedor).

Claude.ai web (ferramentas gratuitas)

  1. Vá em Configurações → Conectores → Adicionar conector personalizado.
  2. Cole a URL https://mcp.trackcombo.com/mcp.
  3. Deixe as configurações avançadas (OAuth) em branco e salve.

Problemas comuns

  • "Authentication required" ao pedir dados da conta: o cliente está conectado sem API Key. Use um cliente que aceite header (tabela acima) e confira se a chave foi colada com o prefixo Bearer .
  • Chave recusada: a chave pode ter sido revogada. Gere uma nova no painel.
  • Perdi a chave: ela não pode ser exibida de novo. Revogue a antiga e gere outra.
  • Segurança: nunca coloque a API Key na URL nem em arquivos que vão para um repositório público.
mcpchatgptclaudeclaude codeclaude desktopcursorapi keychave de apiiaassistenteconectorintegração com iamodel context protocolservidor mcpurlautenticaçãobearer