Docs · MCP

MCP

Conecte os dados do seu workspace Trakd à sua IA (como o Claude) e pergunte sobre suas métricas em linguagem natural. Acesso somente leitura.

read-onlyreports:read

01 O que é

MCP (Model Context Protocol) é o padrão aberto que liga uma IA a fontes de dados externas. O Trakd expõe um servidor MCP (trakd-reports) pra você plugar o seu workspace na sua IA favorita e perguntar coisas como "quanto reembolsou nos últimos 7 dias?" ou "me dá o resumo do dashboard de ontem", direto no chat, sem abrir o painel.

É somente leitura. A IA consulta os mesmos números que você já vê no Trakd; ela não cria, edita nem apaga nada no seu workspace nem nas suas campanhas.

02 O que a IA acessa

O servidor expõe um conjunto de ferramentas de leitura, todas filtráveis por período (hoje, ontem, esta semana, semana passada, este mês, mês passado, máximo ou intervalo custom):

  • Resumo do dashboard e quebras (por UTM, produto, pagamento, etc).
  • Reembolsos, chargebacks e carrinhos abandonados.
  • Eventos enviados à Meta (o que o Trakd disparou via CAPI).
  • Filtros disponíveis no workspace, pra a IA saber o que pode cruzar.

03 Como conectar

1

No painel Trakd, vá em Configurações → MCP e gere um token (apenas owner/admins do workspace).

2

Aponte sua IA pro servidor MCP do Trakd: https://api.trakd.pro/mcp.

3

No Claude Code, por exemplo, é um comando só:

terminal
claude mcp add --transport http trakd \
  https://api.trakd.pro/mcp \
  --header "Authorization: Bearer SEU_TOKEN"

Também dá pra conectar como conector OAuth (a IA abre a tela de consentimento do Trakd e você escolhe o workspace). De qualquer jeito, o acesso liberado é sempre o de leitura de relatórios (reports:read).

04 Segurança

  • Token por workspace, gerado e revogável só por owner/admins, em Configurações → MCP.
  • Escopo único reports:read: a IA só lê dados, nunca escreve.
  • Revogou o token? O acesso para na hora.
  • Você nunca compartilha login nem senha: a IA usa só o token.

Pergunte sobre seus dados no chat

Conecte o Trakd à sua IA e tire relatórios em linguagem natural, sem abrir o painel.

Testar por 7 dias