O conector expõe 24 ferramentas: todas leem, menos ligar ou desligar o SalesPilot e deixar feedback, que pedem confirmação quando desligam algo. Não é preciso nomeá-las: o Claude escolhe a que corresponde ao que você pergunta. Ele se conecta em https://salespilot.crossup.ai/mcp/merchants; como, em Conectar o Claude.

​
Como os períodos são pedidos

Quase todas recebem o mesmo período. Se você não disser nada, é o ciclo de faturamento atual, do dia 28 ao 27, o mesmo que o admin abre.
​
string
padrão:"current_cycle"
current_cycle, last_cycle, today, yesterday, last_7_days, quarter (últimos 3 meses), year (ano corrente) ou last_year.
​
string
Um intervalo pontual, yyyy-mm-dd, inclusivo nas duas pontas. Vai sem period.
​
string
padrão:"America/Argentina/Buenos_Aires"
O fuso da loja; o Claude o pega de get_store_context.
Cada resposta diz o período que usou («de 28/09 a 27/10 (ciclo atual)») e de onde saiu o número.

​
Início e conta

​
Métricas

Os indicadores são extraRevenue (faturamento extra), extraUnits (unidades), views, addedToCart, clickRate, conversionRate e globalConversionRate; cada ferramenta aceita os que fazem sentido para ela. Os momentos (handle) são add-to-cart, product-page, carousel, in-checkout, success-page e, onde se aplica, bundle.

​
O relatório de vendas

get_sales_report é o mesmo relatório que você baixa em Excel em Estatísticas: uma linha por produto vendido através de uma sugestão ou combo. Calcula os totais e os rankings sobre todo o período e devolve, além disso, as últimas linhas para citar casos.
​
string
padrão:"all"
all, salespilot (o que o SalesPilot disparou) ou manual.
​
string
Restringe a um momento de compra.
​
string
Texto sobre o produto vendido, o produto que disparou a sugestão ou o nome da sugestão.
​
number
padrão:"50"
Quantas linhas devolver, da mais recente para a mais antiga. 0: só totais e rankings. Máximo 500.
​
object
Linhas, unidades, pedidos e ganho extra líquido do período.
​
array
O mesmo, dividido por origem (SalesPilot ou manual) e por momento.
​
array
Os 10 produtos e as 10 sugestões que mais venderam.
​
array
Cada momento com os seus 5 produtos mais vendidos; o segundo, só com o que o SalesPilot disparou.
​
array
Data e hora local, momento, origem, sugestão, produto disparador, produto vendido, quantidade, preço unitário, ganho extra líquido e número do pedido.
O dinheiro está na moeda da loja, sem conversão. Aceita até 366 dias por pedido e até 20.000 linhas, o mesmo teto do Excel; se passar, a resposta diz.

​
Momentos e SalesPilot

Ligar é imediato. Desligar pede confirmação: a primeira chamada não muda nada e devolve um resumo do que vai acontecer; o Claude mostra para você e só com o seu sim chama de novo com o confirmToken. Os motivos são NO_RESULTS, IRRELEVANT_SUGGESTIONS, PREFER_MANUAL, LOOKS_WRONG, TEMPORARY_PAUSE e OTHER; os três que não se explicam sozinhos pedem um comentário.

​
Feedback

pause desliga a sugestão e pede a mesma confirmação que desligar o SalesPilot.

​
Leituras para montar um relatório

Para que o Claude possa nomear o que aparece nas métricas:

​
O que ainda não está

Criar ou editar sugestões e combos, mudar o design ou a configuração geral e as campanhas por volume se fazem pelo admin. Se você pedir ao Claude, a ferramenta responde:
e o Claude diz isso com essas palavras.

Conectar o Claude

A URL e os três passos.

Login e permissões

Como a conexão é autorizada e como se corta.