Conecte seu primeiro agente

1. Crie sua conta

Abra my.sallyport.cloud. Clique em “Continuar com o Google”, ou cadastre-se por e-mail: clique em “Continuar com e-mail”, informe seu e-mail e clique em “Continuar”. Para um e-mail novo, preencha “Nome”, “Sobrenome” e “Senha” e clique em “Criar conta”. Depois digite o código de 6 dígitos da mensagem e clique em “Confirmar e-mail”.

Quem se cadastra é o proprietário da organização e do primeiro espaço de trabalho dela. Adicionar chaves e agentes exige o papel de proprietário ou de administrador.

2. Salve uma chave de serviço

Abra Adicionar chave. Este guia usa o GitHub: digite o nome em “Serviço do catálogo” e escolha GitHub API. Deixe “Produção” em “Ambiente”.

Em “Como conectar GitHub API”, escolha “Token de acesso”. Clique em “Criar a chave em GitHub API”, crie um token no GitHub e cole aqui. Clique em “Salvar a chave”.

O Sallyport verifica o token no GitHub ao salvar. A partir daí, todos os agentes do espaço de trabalho podem usar a chave. O outro caminho, “Entrar com GitHub”, leva você ao GitHub para aprovar; o formulário diz do que ele precisa.

3. Crie um agente

Abra Agentes e clique em “Novo agente”. Digite um “Nome”, como laptop-claude, e clique em “Criar agente”. A página do agente se abre.

A lista “Acesso” dele já traz a chave do GitHub. Linhas novas executam cada chamada sem perguntar.

4. Conecte o Claude Code

Na página do agente, “Conectar este agente” já vem com o Claude Code selecionado. Clique em “Copiar para o Claude Code”. O Sallyport cria um token e copia o comando inteiro com ele.

export SP_AGENT_TOKEN='<agent-token>'
claude mcp add --transport http --scope user sallyport https://mcp.sallyport.cloud/mcp --header "Authorization: Bearer $SP_AGENT_TOKEN"

Execute-o em um terminal e reinicie o Claude Code. O comando copiado traz o próprio token; o exemplo acima o lê de SP_AGENT_TOKEN. Depois de adicionado, claude mcp list mostra sallyport.

O token aparece uma única vez e fica listado em “Tokens” na página do agente. Para Cursor, Codex, Claude, ChatGPT e outros clientes, veja Clientes MCP e servidores remotos.

5. Faça a primeira chamada

Peça ao agente: “Leia meu perfil do GitHub pelo Sallyport”. Ele encontra o GitHub entre as ferramentas dele e chama github_read com estes argumentos:

{
  "method": "GET",
  "path": "/user"
}

O Sallyport adiciona o token, chama api.github.com e devolve a resposta do GitHub. O agente nunca vê o token. A chamada e o resultado aparecem em Atividade.

6. Responda à sua primeira aprovação

As chamadas rodam sem perguntar até você decidir outra coisa. Na página do agente, na lista “Acesso”, ative “Perguntar sempre” na linha do GitHub.

Peça ao agente para ler o perfil de novo. A chamada espera, e o cartão dela aparece em Aprovações e em qualquer página aberta do console. Se a espera demorar, o agente mostra o link do cartão.

Clique em “Aprovar”: a chamada roda e o agente recebe a resposta. “Recusar” interrompe a chamada, e o agente lê o motivo que você escrever. Os cartões também podem chegar a este navegador, ao Telegram ou ao e-mail: ative isso em Notificações. Mais em Aprovações.

Sem chave, o agente pede

Um agente pode chegar a um serviço público que você ainda não conectou. Ele chama http_request com a URL completa, ou request_access com o nome do serviço e um purpose: uma frase sobre por que precisa dele. O Sallyport responde com um link para você.

{
  "method": "GET",
  "url": "https://api.stripe.com/v1/balance"
}

O link abre o pedido em Precisa de chave. Adicione a chave ou entre no provedor e clique em “Liberar acesso”. Todos os agentes do espaço de trabalho recebem a chave, e o agente repete a chamada.