Claude Code

O Claude Code entra no Sallyport sozinho: sem token para copiar e sem nada para preparar no console antes. Um token do console também funciona, para um arquivo de projeto compartilhado pelo git.

Conecte

• Execute o comando abaixo em um terminal. --scope user adiciona o Sallyport a todos os projetos.
• Execute claude mcp login sallyport, ou digite /mcp dentro do Claude Code e escolha sallyport. O navegador abre o Sallyport.
• Entre ou crie uma conta e clique em «Permitir» na tela de consentimento. Ela diz «Depois de permitir, você volta para um app neste computador»: esse app é o Claude Code.

claude mcp add --transport http --scope user sallyport https://mcp.sallyport.cloud/mcp

Clicar em «Permitir» cria um agente com o nome do cliente. O agente de um proprietário ou administrador começa com todas as conexões do espaço de trabalho. O de um membro começa sem nenhuma, e um administrador as adiciona em «Acesso». Entrar de novo depois custa um clique em «Reconectar».

Conecte com um token

O Claude Code também aceita um token de agente enviado como cabeçalho. O console escreve o comando inteiro para você, com o token incluído.

• No console, abra Agentes, clique em «Novo agente», digite um nome e clique em «Criar agente».
• Na página do agente, em «Conectar este agente», deixe «Claude Code» selecionado e clique em «Copiar para o Claude Code». A cópia leva o token que você acabou de criar nesta página, ou um novo.
• Execute o comando copiado em um terminal e reinicie o Claude Code. claude mcp list mostra sallyport como conectado.

claude mcp add --transport http --scope user sallyport https://mcp.sallyport.cloud/mcp \
  --header "Authorization: Bearer YOUR_AGENT_TOKEN"

--scope user deixa o Sallyport disponível em todos os projetos e guarda o token em ~/.claude.json, fora dos seus repositórios.

Para dispensar o terminal, escolha «Colar no Claude» e clique em «Copiar mensagem para o Claude». Cole a mensagem em um chat do Claude Code, e o próprio Claude executa o comando.

Só proprietários e administradores criam agentes. Um agente novo começa com todas as conexões do seu espaço de trabalho, e a lista «Acesso» na página do agente muda isso.

Compartilhe por um arquivo do projeto

Um .mcp.json do projeto vai para o git com o código. O Claude Code expande ${VAR} nos cabeçalhos, então o arquivo nomeia uma variável e cada desenvolvedor guarda o token no próprio ambiente.

{
  "mcpServers": {
    "sallyport": {
      "type": "http",
      "url": "https://mcp.sallyport.cloud/mcp",
      "headers": { "Authorization": "Bearer ${SP_AGENT_TOKEN}" }
    }
  }
}

Defina SP_AGENT_TOKEN no shell que inicia o Claude Code. A opção «.mcp.json» do console copia o mesmo arquivo com o token escrito, e essa versão fica fora do git.

Diferencie as sessões

Muitas sessões do Claude Code podem dividir um token. Em «Identificar cada sessão do Claude Code», clique em «Copiar hook de sessão para o Claude» e cole no Claude Code. Cada chamada passa a mostrar a sessão e a pasta de onde veio.

O que o agente vê

stripe_read     Stripe API (api.stripe.com/v1), reading only. Key: stripe-live.
stripe_write    Stripe API (api.stripe.com/v1). Key: stripe-live. For reads use stripe_read.
http_request    For a host in your list use its own tool.
list_access     Every service you can reach, one short entry each.
get_call        The state of a call by call_id, at once.

Uma conexão a uma API web dá duas ferramentas: _read para leituras e _write para todo o resto. Um servidor onde o agente executa comandos dá uma ferramenta _exec. Um banco de dados dá _query e _execute, e um servidor MCP remoto traz as próprias ferramentas. Cada descrição nomeia a chave e diz o que passa direto, então o agente conhece seu acesso antes da primeira chamada.

Quando uma chamada espera por uma pessoa

Por padrão, as chamadas passam direto. Uma chamada espera onde você ativou «Perguntar sempre» ou colocou uma classe em «Exige aprovação», em «Acesso» do agente. Ela também espera quando passa de um orçamento que você definiu em Limites.

Enquanto o cartão está aberto, o Sallyport mantém a chamada viva por até 4 minutos e informa o progresso a cada 10 segundos. Em uma sessão interativa, o Claude Code move a chamada para segundo plano após 2 minutos e entrega a resposta quando ela chega.

Ninguém respondeu em 4 minutos? O agente recebe approve_url e call_id, mostra o link para você e repete a chamada com esse call_id depois da sua resposta. O serviço é chamado uma vez. Por padrão, o cartão fica aberto por uma hora. Veja em Aprovações aonde os cartões chegam.

Deixe MCP_TOOL_TIMEOUT e o timeout de um servidor sem valor, ou coloque-os acima de 240000. Um valor menor encerra a espera dentro do Claude Code, e o agente perde o link e o call_id.