Servidor MCP RedTrack

Conteúdo

Introdução

Faz uma pergunta ao teu rastreador → obtém uma resposta. Essa é toda a ideia por trás do Servidor MCP RedTrack. Conecta um assistente de IA como Claude ou ChatGPT à tua conta e executa a plataforma em linguagem simples. Gera um relatório, cria uma campanha, elimina os perdedores, tudo sem clicar em painéis ou escrever uma linha de código de API.

Não és técnico? Vais viver nas primeiras secções e nunca tocar em código.
És técnico? Os detalhes de conexão, configuração e limites estão todos aqui também — nenhum documento de desenvolvedor separado para procurar.

Como funciona

PASSO 1

Tu perguntas

Escreve um pedido em inglês simples — sem construtor de consultas, sem código.

PASSO 2

Ele escolhe as ferramentas

O teu assistente mapeia o pedido para as ações RedTrack corretas.

PASSO 3

RedTrack executa

As ações são executadas na tua conta, com as mesmas permissões que tens.

PASSO 4

Recebes uma resposta

Um resultado em linguagem simples que podes ler, partilhar ou usar imediatamente.

O que podes fazer com RedTrack e IA

Pensa nos relatórios que constróis todas as segundas-feiras e nas mudanças que fazes manualmente durante toda a semana. A maior parte disso torna-se uma frase. Algumas para experimentar no primeiro dia:

“Mostra as minhas principais campanhas por lucro esta semana — sinaliza qualquer uma que esteja a perder dinheiro.”
“Pausa todas as campanhas que gastaram mais de 500 $ sem conversões.”
“Que países têm o melhor ROI na minha oferta de nutra?”
“Compara Meta e TikTok nos últimos 30 dias.”
“Como foi o desempenho da minha fonte Shopify no mês passado?”

O servidor expõe mais de 40 ações em todas as principais partes do RedTrack. Aqui está a gama, com uma pergunta real para cada área:

Pergunta sobre…	Uma pergunta que podes escrever	Tipo
Relatórios	“Mostra as minhas principais campanhas por lucro esta semana.”	Leitura
Campanhas	“Pausa todas as campanhas que gastaram mais de 500 $ sem conversões.”	Leitura + Escrita
Fontes de tráfego	“Cria uma fonte TikTok a partir da predefinição e clona a minha configuração Meta.”	Leitura + Escrita
Ofertas	“Que ofertas estão a ser executadas na minha campanha de maior tráfego?”	Leitura + Escrita
Redes de afiliados	“Adiciona uma rede ClickBank a partir da predefinição.”	Leitura + Escrita
Páginas de destino	“Lista todos os prelanders que não tiveram uma conversão em 30 dias.”	Leitura + Escrita
Domínios de rastreamento	“Regenera o SSL no meu domínio de rastreamento.”	Leitura + Escrita
Streams e otimização	“Mostra os vencedores do otimizador para o stream X e reinicia os perdedores.”	Leitura + Escrita
Cliques e conversões	“Extrai o registo bruto para este ID de clique para que eu possa depurar a atribuição.”	Leitura
Sincronização de custos	“Por que os meus custos Meta não estão a atualizar?”	Leitura

Cada ação é uma Leitura (apenas visualização) ou uma Escrita (criar, atualizar, eliminar). O teu assistente confirma contigo antes de qualquer coisa destrutiva — mais sobre isso abaixo.

O que é MCP e como é diferente da API?

MCP (Model Context Protocol) é um padrão aberto que conecta assistentes de IA a ferramentas e dados externos. A Anthropic introduziu-o, e agora funciona em Claude, ChatGPT, Cursor, Codex e mais. Pensa nele como um adaptador universal entre o teu assistente e RedTrack. És novo nisso? O próprio guia de introdução do protocolo é o ponto de partida mais claro.

RedTrack sempre teve uma API REST para programadores. O Servidor MCP não a substitui, ele funciona em cima da mesma API e serve um trabalho diferente.

Aspeto	API REST Direta	Servidor MCP
Para quem é	Programadores	Qualquer pessoa com um assistente de IA — sem código
Como o usas	Escreve e mantém código que chama endpoints	Pergunta em linguagem simples; o assistente chama as ferramentas certas
Tarefas de vários passos	Tu orquestras cada chamada	O assistente encadeia passos (encontra perdedores, depois pausa-os)
Configuração	Chave API mais código de integração personalizado	Chave API mais um URL no teu cliente de IA
Melhor para	Aplicações personalizadas, painéis, pipelines	Análise, mudanças rápidas, exploração

Mesmo motor, volante diferente.
A API é para construir software. MCP é para fazer as coisas com um assistente. Ambos funcionam com os mesmos dados e respeitam as mesmas permissões de conta.

Requisitos

Três coisas, e estás pronto para conectar:

Precisas de	Detalhes
Uma conta RedTrack com acesso à API	O acesso API/MCP deve estar ativado no plano. Verifica isto nas definições de Perfil → Subscrição.
Um cliente de IA compatível com MCP	Claude Desktop ou Claude Code, ChatGPT, Cursor, Codex, Antigravity — qualquer coisa que fale MCP sobre HTTP ou SSE.
A tua chave API RedTrack	Gerada em RedTrack → Definições → API. Trata-a como uma senha.

Conecta o teu assistente

Há duas formas de configurar:

A forma fácil cola um URL no teu assistente, sem ficheiros.
A forma técnica usa um ficheiro de configuração com a tua chave mantida numa variável de ambiente. Ambas levam cerca de cinco minutos.

OPÇÃO 1 · MAIS FÁCIL — SEM CÓDIGO

Cola um URL no teu assistente

Melhor se só queres que funcione. Usa a chave API dos Requisitos acima.

Coloca a tua chave no final do URL do servidor: https://mcp.redtrack.io/mcp?api_key=<your-api-key>
No teu cliente de IA (Claude Desktop, ChatGPT, Cursor e outros), abre o conector ou as definições MCP e adiciona uma conexão personalizada.
Cola o URL → guarda → inicia uma nova conversa.

! Mantém privado: cola a chave nas próprias definições do teu cliente, nunca numa conversa partilhada ou num ficheiro que faças commit.
! Testa: pergunta “Mostra as minhas 5 principais campanhas por receita esta semana.” Uma lista classificada de volta significa que estás dentro.

OPÇÃO 2 · CLAUDE CODE — FICHEIRO DE CONFIGURAÇÃO

Adiciona com um ficheiro de configuração, chave numa variável de ambiente

Melhor se manténs ferramentas em ficheiros de configuração. A tua chave fica numa variável de ambiente, então nunca entra no ficheiro ou no controlo de versão.

1. Coloca a tua chave numa variável de ambiente para que persista. Adiciona isto ao perfil da tua shell (~/.zshrc ou ~/.bashrc), depois reinicia a tua shell:

export REDTRACK_API_KEY="your-api-key"

2. Adiciona o servidor ao .mcp.json do teu projeto. Claude Code expande ${REDTRACK_API_KEY} em tempo de execução, então a chave real nunca entra no ficheiro:

{
  "mcpServers": {
    "redtrack": {
      "type": "http",
      "url": "https://mcp.redtrack.io/mcp?api_key=${REDTRACK_API_KEY}"
    }
  }
}

3. Guarda, depois executa /mcp no Claude Code para confirmar a conexão e listar as ferramentas.

Preferes a linha de comandos? claude mcp add --transport http redtrack "https://mcp.redtrack.io/mcp?api_key=$REDTRACK_API_KEY" adiciona-o a partir da tua shell. Outros clientes de ficheiro de configuração (Cursor, Codex e similares) suportam a mesma ideia de variável de ambiente; verifica os documentos MCP deles para o ficheiro exato.

O que pode e não pode tocar

O assistente só alcança a conta associada à tua chave API, e respeita as permissões dessa conta. Operações de leitura executam livremente. Operações de criar, atualizar e eliminar alteram a tua conta — então o teu assistente confirma antes de qualquer coisa destrutiva.

Eliminações são permanentes.
Ações de eliminar para fontes, landings, redes, domínios e streams removem dados definitivamente. Lê a confirmação antes de a aprovares.

Alguns limites que vale a pena conhecer. O relatório de análise tem limite de taxa de 20 pedidos por minuto, o que é bom para uso interativo, mas controla a automação pesada. Mantém as consultas de relatório em aproximadamente 90 dias por chamada para velocidade. E o servidor gere apenas o lado RedTrack, não controla os próprios gestores de anúncios das plataformas de publicidade.

Conecta uma vez, depois substitui a extração de relatório desta segunda-feira por uma única pergunta. Essa é a forma mais rápida de ver o que faz.

Estaremos contigo num segundo