Conectar o SalesPilot é entrar na CrossUp pelo Claude: você diz que sim em uma tela da CrossUp e a conexão nasce sozinha. Você não copia nenhuma chave, e revogá-la no admin corta o acesso.

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.
Cancelar não cria nada: o Claude recebe a recusa e nenhuma conexão fica.

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, PKCE S256, 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:
As URLs de retorno aceitas são a do Claude (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.