Aprovações e permissões

Por padrão, toda chamada passa direto. Você escolhe onde uma chamada espera por uma pessoa: um agente, uma conexão e uma classe de cada vez.

Escolha quais chamadas esperam por você

Abra Agentes e escolha o agente. A lista Acesso dele tem uma linha por conexão.

• Ative Perguntar sempre para aprovar cada chamada daquela conexão.
• Ou ajuste as colunas Leitura, Escrita e Destrutiva uma a uma. Automático executa a chamada, Exige aprovação espera por uma pessoa, Recusado recusa.
• Marque Código para exigir um código de seis dígitos do autenticador nas chamadas destrutivas. A coluna aparece quando você configura App autenticador em Configurações.

O Sallyport classifica uma chamada pelo método HTTP. GET, HEAD e OPTIONS leem. POST, PUT e PATCH escrevem. DELETE e qualquer outro método são destrutivos. Uma leitura vira escrita quando um trecho do caminho começa com uma palavra como send, run, exec, build, trigger, invoke ou webhook. A receita de um serviço pode ajustar isso para as chamadas que conhece.

Uma chamada acima de um orçamento que você definiu espera, veja Limites.

Onde o cartão chega até você

O cartão vai para a pessoa em nome de quem o agente age e para todo proprietário e administrador. A primeira resposta decide. Configure os canais em Notificações.

Cada canal conectado tem Enviar um teste. A tabela O que chega onde escolhe quais eventos usam Navegador, Telegram e E-mail. Para uma chamada destrutiva, o Telegram oferece só Deny e um link para o cartão.

Responda ao cartão

O cartão mostra o que será enviado, qual agente pede e de qual espaço de trabalho. Detalhes guarda a regra, a chave, o ID da chamada, o prazo e as palavras do próprio agente, marcadas como não verificadas. O cartão mostra cada parte da solicitação até 2 KiB. Se uma parte é mais longa, ele avisa acima dos botões, e Mostrar a solicitação inteira carrega tudo. Detalhes também mostra um cabeçalho que o agente enviou no lugar da chave, com o valor enviado; esse cabeçalho não sai.

Aprovar uma chamada destrutiva também exige um motivo. Se a linha tem Código marcado, o cartão pede ainda o código de seis dígitos do seu autenticador.

Uma permissão criada pelo cartão dura o que diz Permissão mais longa (segundos) em Configurações, Organização: 24 horas por padrão. Ela cobre 200 leituras, 20 escritas ou 1 chamada destrutiva. Approve for 1 hour no Telegram dá 20 chamadas por uma hora. Revise e revogue permissões em Permissões, que abre a partir de Aprovações; a página de um agente lista as permissões ativas dele.

O botão daqui em diante só aparece enquanto a classe está em Exige aprovação. A mudança vai para Alterações de regras, onde Desfazer a reverte. Colocar uma classe em Recusado revoga as permissões que ela cobria.

O que o agente vê enquanto espera

Toda resposta de espera traz um call_id e um approve_url. Repetir com o mesmo call_id continua a mesma chamada e nunca inicia uma segunda.

• Um cliente MCP que envia um token de progresso mantém a chamada aberta. O Sallyport informa o progresso a cada 10 segundos, por até 240 segundos.
• Um cliente sem token de progresso espera até 45 segundos.
• Quando essa espera termina, o agente recebe APPROVAL_PENDING com call_id, approve_url, expires_at e poll_after_ms. Aí get_call responde na hora, e repetir com call_id espera de novo.
• Um cliente com suporte a MCP Tasks recebe uma tarefa para consultar. Um cliente com suporte a URL elicitation mostra o approve_url para você e repete a chamada sozinho.
• Em /p/ a resposta é 202 com X-Sallyport-Call-Id. Consulte GET https://mcp.sallyport.cloud/p/calls/{call_id}: 202 enquanto espera, a resposta do serviço após a aprovação, 403 após uma recusa, 410 após expirar.

Uma resposta chega na hora à chamada que espera. O Claude Code leva para segundo plano uma chamada que espera mais de 2 minutos e entrega o resultado quando ele chega.

Quanto tempo um cartão espera

• Por padrão, um cartão fica aberto por 60 minutos. Prazo de aprovação (segundos) em Configurações, Organização, muda isso.
• Abrir o cartão completo soma 5 minutos, no máximo duas vezes. O cartão do canto não soma nada.
• Os lembretes saem 2, 15 e 45 minutos depois que o cartão abriu. Um lembrete que cairia depois do prazo não é enviado.
• Depois de uma recusa, o agente recebe APPROVAL_DENIED com o seu motivo. Nada foi executado.
• Depois de expirar, o agente recebe APPROVAL_EXPIRED. Nada foi executado; se a ação ainda for necessária, o agente a repete sem call_id.

Rajadas de chamadas

• Chamadas idênticas do mesmo agente entram no cartão que já está aberto, não importa o intervalo entre elas. A chamada roda uma vez, e cada cópia recebe o resultado dela.
• Um agente com 20 cartões abertos, ou uma organização com 100, não cria mais nenhum. O agente é pausado, um cartão explica o motivo, e Retomar agente na página dele o põe para rodar de novo.

Quando falta uma chave ao agente

Um cartão responde a uma chamada que já tem chave. Uma chamada a um serviço sem chave abre uma solicitação em Precisa de chave e dá ao agente o link dela.

O mesmo acontece com uma conexão pausada, uma chave aposentada ou um login OAuth expirado. Adicione a chave com Liberar acesso, e o agente repete a chamada. Veja Chaves e agentes.