Como é autorizado
1
O Claude pede permissão
Ao tocar em Conectar, o Claude se registra no SalesPilot e abre a
tela de permissão da CrossUp, em
app.crossup.ai/oauth/authorize.2
Você entra com a sua conta da CrossUp
Se a sua sessão não estiver aberta, pede para entrar e traz você de volta
à mesma tela. Ali você vê qual loja vai ficar conectada e o que o Claude
vai poder fazer. O pedido vence em 10 minutos.
3
Você toca em Permitir
A CrossUp emite uma chave de agente para a sua loja e a entrega ao
Claude por um canal selado. A chave nunca aparece na tela.
4
O Claude volta com as ferramentas
A partir daí, cada pergunta viaja com essa chave. A cada hora o Claude
renova a sessão e o SalesPilot confere que a chave continua ativa.
O que a conexão pode fazer
O mesmo que diz a tela de permissão, e nada mais:
Não cria nem edita sugestões, combos nem a configuração da CrossUp. Se você
pedir, o Claude recebe
TOOL_NOT_AVAILABLE e diz que isso se faz pelo admin.
Desligar o SalesPilot ou pausar uma sugestão pedem a sua confirmação antes de
executar: o Claude mostra o que muda e espera o sim.
A chave de agente
A conexão é uma chave de agente (sak_…) com uma única permissão,
agent:operate. Ela não se parece com a chave de storefront:
Com o Claude você nunca a vê. Para o Cursor e outros clientes sem OAuth, você
mesmo a gera e ela aparece uma única vez.
Revogar
Em API & Agentes → Conexões ativas, Revogar na conexão do Claude. O Claude não consegue mais renovar a sessão e pede para reconectar; uma pergunta que estava em andamento pode terminar de responder. Para voltar, Conectar de novo no Claude: nasce uma chave nova. A conexão dura 90 dias sem uso. Enquanto você usa, ela se renova sozinha.Para desenvolvedores
O SalesPilot é um servidor MCP remoto com transporte Streamable HTTP e é o seu próprio servidor de autorização (OAuth 2.1, PKCES256, registro
dinâmico de clientes, clientes públicos).
Um pedido sem credencial responde
401 com o ponteiro para o documento do
recurso, que é o que inicia o fluxo no cliente:
https://claude.ai/api/mcp/auth_callback) e as de loopback do Claude Code
(http://localhost e http://127.0.0.1, em qualquer porta). O token de
acesso dura uma hora; o de renovação gira a cada uso e, se a chave foi
revogada, o token endpoint responde invalid_grant.
Com uma chave de agente colada à mão, o header é
Authorization: Bearer sak_… e não há fluxo: a sessão começa no primeiro
pedido.
Se você não vê isso
Conectar o Claude
A URL e os três passos.
O MCP
O que a conexão pode consultar e mudar.