Radar 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.

É um servidor somente leitura para os seus dados: ele responde perguntas e faz cálculos, mas não altera as suas configurações nem publica preços. A única exceção é a conexão de uma nova conta Amazon, que apenas gera o link de consentimento para você autorizar.

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 Clerk e autoriza o acesso. O cliente recebe um token de acesso com o escopo (scope) radar:read, que concede leitura dos seus dados.
  • 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 passo a passo exato varia conforme o cliente (Claude Desktop, Cursor, etc.), mas o fluxo conceitual é sempre o mesmo:

  1. Adicione o servidor MCP — No seu cliente de IA, cadastre o Radar Scout como um servidor MCP remoto, informando a URL do servidor MCP do Radar Scout. O transporte é Streamable HTTP.
  2. Autorize via OAuth — Na primeira conexão, o cliente descobre o Authorization Server (Clerk) e abre a tela de login. Faça login com a sua conta Radar e autorize o acesso de leitura (radar:read).
  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 e dados financeiros, até resumos do Repricer e definições de conceitos do Radar. 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.
  • Leitura, não escrita — O assistente não muda configurações do Repricer nem do Analytics. Para isso, continue usando o painel do Radar.

Próximos passos