docs

Radar Scout (MCP)

Converse com os seus dados do Radar a partir do seu cliente de IA preferido — Claude, Cursor e outros — via Model Context Protocol.

O Radar Scout (MCP) é um servidor remoto que expõe os seus dados do Radar para clientes de IA que falam o Model Context Protocol (MCP). Em vez de abrir o painel, você pergunta em linguagem natural — "qual foi meu repasse no último ciclo?", "liste meus produtos mais vendidos" — e o cliente de IA consulta o Radar por você, chamando as ferramentas certas.

Para a maioria das operações, o servidor apenas lê os seus dados: responde perguntas, faz cálculos e não altera configurações nem publica preços. As ferramentas de Anúncios (Ads) incluem também ações de escrita — pausar/reativar campanhas, ajustar orçamentos e lances, e adicionar negativações — mas essas ações sempre operam em modo de simulação até você confirmar explicitamente (execute:true).

Como funciona

O Radar Scout segue o papel de resource server no OAuth 2.1: ele aceita tokens de acesso, mas nunca os emite. Quem emite e autentica é o Clerk (o mesmo login que você já usa no Radar), atuando como Authorization Server.

  • Autenticação por OAuth — Ao conectar o cliente de IA, você é levado ao login do Radar e autoriza o acesso. O cliente recebe um token de acesso vinculado à sua conta, e o que ele pode ler ou alterar depende do seu plano e das contas Amazon que você conectou.
  • Isolamento por tenant (seller scoping) — O token resolve para o seu User (conta Clerk). A partir dele, você só enxerga as SellerAccounts (contas Amazon) que você conectou ou nas quais colabora. Não há como uma ferramenta ler dados de uma conta que não é sua — a regra de acesso é aplicada antes de qualquer consulta.
  • Identificação do vendedor (seller_account_id) — Cada ferramenta de dados opera sobre um vendedor específico, identificado pelo seller_account_id. Você descobre esse identificador com a ferramenta radarscout_whoami, que lista as suas contas conectadas. Não existe modo "todos os vendedores" — cada consulta é atribuída a um vendedor.

O User (sua conta de login no Clerk) é diferente da SellerAccount (a conta de vendedor Amazon conectada via SP-API). Um mesmo User pode ter várias SellerAccounts.

Como conectar um cliente de IA

O endereço do servidor é:

https://mcp.radarscout.com.br/mcp

No Claude (web, desktop ou celular): abra Configurações → Conectores, clique em Adicionar conector personalizado, cole o endereço acima e clique em Conectar. Faça login com a sua conta Radar na janela que abrir e autorize o acesso.

Em outros clientes (Cursor, Claude Code etc.): o passo a passo varia, mas o fluxo é sempre o mesmo:

  1. Adicione o servidor MCP — Cadastre o Radar Scout como servidor MCP remoto usando o endereço acima. O transporte é Streamable HTTP.
  2. Autorize via OAuth — Na primeira conexão, o cliente descobre o servidor de autorização e abre a tela de login. Faça login com a sua conta Radar e autorize o acesso.
  3. Descubra suas contas — Peça ao assistente para rodar radarscout_whoami. Ele retorna o seu usuário e as SellerAccounts conectadas, com os respectivos seller_account_id.
  4. Comece a perguntar — Com o seller_account_id em mãos, peça relatórios, detalhes de produto, simulações de tarifas e explicações de conceitos. O assistente escolhe a ferramenta adequada.

O que você pode perguntar

As perguntas vão de identidade e conexão de contas, passando por descoberta de produtos, dados financeiros e desempenho de anúncios, até resumos do Repricer e definições de conceitos do Radar. Você também pode pedir ações diretamente — pausar campanhas, ajustar orçamentos e lances, ou adicionar negativações. A lista completa das capacidades disponíveis está em Ferramentas Disponíveis.

Boas práticas

  • Datas explícitas — Ferramentas que aceitam período usam datas ISO (YYYY-MM-DD), com início inclusivo e fim exclusivo, interpretadas no fuso America/Sao_Paulo. Não há atalhos como "últimos 7 dias"; informe as datas.
  • Um vendedor por consulta — Se você tem mais de uma SellerAccount, deixe claro qual seller_account_id quer consultar.
  • Repricer e Analytics são somente leitura — O assistente não muda configurações do Repricer nem do Analytics. Para isso, continue usando o painel do Radar.
  • Confirme ações de Ads — As ferramentas de ação de Ads (pausar campanha, ajustar budget, etc.) só aplicam a mudança quando você confirma. O assistente mostrará primeiro o que será feito; revise e diga "execute" para confirmar.

Próximos passos