Clientes MCP e servidores remotos

O endereço

Todo cliente MCP se conecta a https://mcp.sallyport.cloud/mcp por Streamable HTTP. Funcionam clientes na revisão 2026-07-28 do MCP e em revisões anteriores.

A maioria dos clientes se conecta pelo login: você adiciona o endereço, entra no Sallyport no navegador e clica em “Permitir”. Sem token para copiar, sem nada para preparar no console antes. Scripts e clientes sem login enviam um token de agente no cabeçalho Authorization: Bearer.

Conecte pelo login

Claude, Claude Code, ChatGPT, Codex, Cursor, VS Code, Gemini CLI e MCP Inspector se conectam assim. A página de cada cliente em Integrações mostra onde o endereço entra.

• Adicione https://mcp.sallyport.cloud/mcp como servidor MCP no seu cliente.
• O cliente se registra sozinho no Sallyport e o abre no seu navegador.
• Entre ou crie uma conta. A conexão espera por você 30 minutos, tempo de sobra para confirmar o e-mail.
• Leia a tela de consentimento, “Permitir que … conecte um agente”, e clique em “Permitir”. O navegador volta para o cliente, e o cliente fica conectado.

A tela de consentimento

“Quem está pedindo” dá o nome do cliente. Um cliente conhecido pelo próprio site mostra “Domínio verificado” com esse domínio, e “Publicado por Anthropic” para claude.ai ou “Publicado por OpenAI” para chatgpt.com. Um cliente que se registrou sozinho mostra “Não verificado” e “Este cliente se registrou sozinho. O Sallyport não conseguiu verificar o nome dele.”

“Para onde você vai depois” diz aonde o navegador chega depois de “Permitir”: um site, um app ou “Depois de permitir, você volta para um app neste computador”. Esse último vem com um aviso: “Só permita se você acabou de iniciar esta conexão em um app deste computador.” Se o link veio de outra pessoa, clique em “Recusar”.

“O que o agente pode usar” lista cada serviço com “Roda direto” ou “Pergunta a você antes”. O agente novo de um membro mostra “Nada ainda. Um administrador dá serviços a este agente no console.”

“Detalhes” traz o client ID, o endereço de retorno e, com mais de um espaço de trabalho, o espaço em que o agente entra.

O que “Permitir” faz

O Sallyport cria um agente com o nome do cliente. O agente de um proprietário ou administrador recebe todos os serviços do espaço de trabalho. O de um membro começa sem nenhum, até um administrador adicioná-los em “Acesso”, na página do agente.

Na primeira vez que uma pessoa conecta um cliente, todo proprietário recebe uma notificação com um link que o desconecta. O registro guarda cada consentimento.

Um cliente entra de novo de uma sessão nova, de uma porta nova ou quando renova o acesso. Enquanto o agente estiver ativo, você vê uma tela curta “Reconectar Claude Code” com um só botão “Reconectar”. Nada vai para o cliente até você clicar nele. Os proprietários não são avisados de novo. Se o agente foi pausado, a tela de consentimento completa pergunta de novo. Se foi excluído, entrar de novo é uma conexão nova e todo proprietário é avisado.

Apps conectados

Configurações, Apps conectados lista todo cliente de IA que entrou. Membros veem e desconectam os seus. Proprietários e administradores veem e desconectam os de todos.

“Desconectar” encerra o acesso do cliente: “As chamadas dele param na hora, em todos os computadores de onde ele entrou. Para usá-lo de novo, entre pelo app e permita.”

Plataformas com um agente por máquina

Uma plataforma que roda agentes em máquinas próprias, como o detachbox, se conecta uma vez. A tela de consentimento dela é um cartão curto: quem pede, para onde você volta e três linhas. O detachbox poderá criar um agente para cada uma das suas máquinas, ver os seus agentes e colocá-los em chats. Ele só poderá renomear, pausar ou excluir os agentes que criou. Cada agente novo começa sem acesso, e você escolhe o que cada um pode usar. A conexão em si não é um agente e não usa nenhum serviço, por isso o cartão não lista nenhum.

Cada máquina ganha o próprio agente, para que a Atividade e as aprovações mostrem qual máquina chamou. O agente de uma máquina nova não usa nada. O detachbox leva você à página dele, você escolhe os serviços ou copia o acesso de outro agente, e “Pronto” traz você de volta. Apps conectados mostra quantos agentes o app gerencia, cada um com a sua máquina. Pausar um agente para uma máquina. “Desconectar” para todas, e elas voltam com o acesso quando você conecta de novo. Todas as máquinas de uma conexão contam como um agente em qualquer plano.

Pegue um token de agente

Um token serve para um script, um arquivo de projeto no git ou um cliente sem login. Abra o agente em Agentes. “Conectar este agente” copia uma configuração pronta para Claude Code, Cursor ou um arquivo .mcp.json de projeto. Ela leva o token que você acabou de criar com “Novo token”, ou um novo.

Para outro cliente, clique em “Novo token” em “Tokens” e copie: ele aparece uma única vez. O token identifica o agente e o acesso dele. Não carrega nenhuma chave de serviço.

O botão de lixeira ao lado de um token o revoga. “Endereços IP permitidos (opcional)”, em “Limites”, restringe de onde os tokens do agente funcionam.

Claude Code com token

Clique em “Copiar para o Claude Code” e execute o comando em um terminal. --scope user adiciona o Sallyport a todos os projetos. Confira com claude mcp list e reinicie o Claude Code.

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"

“Colar no Claude” dá uma mensagem no lugar do comando. Clique em “Copiar mensagem para o Claude”, cole-a em um chat do Claude Code, e o Claude executa o comando sozinho.

“Identificar cada sessão do Claude Code” é opcional. Clique em “Copiar hook de sessão para o Claude” e cole no Claude Code. Assim cada chamada mostra a sessão e a pasta de onde veio.

Cursor e o .mcp.json de um projeto

“Copiar para o Cursor” gera isto para ~/.cursor/mcp.json, já com o token:

{
  "mcpServers": {
    "sallyport": {
      "url": "https://mcp.sallyport.cloud/mcp",
      "headers": {
        "Authorization": "Bearer <agent-token>"
      }
    }
  }
}

“Copiar .mcp.json” gera o mesmo com "type": "http", para o .mcp.json de um projeto no Claude Code. Esse arquivo carrega o token, então deixe-o fora do git.

Codex CLI, Gemini CLI e VS Code com token

Esses clientes são configurados à mão com o mesmo endereço e o mesmo token.

[mcp_servers.sallyport]
url = "https://mcp.sallyport.cloud/mcp"
bearer_token_env_var = "SP_AGENT_TOKEN"
tool_timeout_sec = 300

O Codex lê o token de SP_AGENT_TOKEN no ambiente que o inicia. O Sallyport mantém aberta uma chamada que espera aprovação por no máximo 240 segundos. Com tool_timeout_sec = 300, o Codex espera esse tempo; o padrão dele é 60 segundos.

{
  "mcpServers": {
    "sallyport": {
      "httpUrl": "https://mcp.sallyport.cloud/mcp",
      "headers": {
        "Authorization": "Bearer <agent-token>"
      }
    }
  }
}

{
  "servers": {
    "sallyport": {
      "type": "http",
      "url": "https://mcp.sallyport.cloud/mcp",
      "headers": {
        "Authorization": "Bearer <agent-token>"
      }
    }
  }
}

O Gemini CLI recebe o endereço em httpUrl. O VS Code abre o arquivo com “MCP: Open User Configuration”. Troque <agent-token> e deixe esses arquivos fora dos repositórios.

O que o agente vê

Cada serviço chega como ferramentas com o nome dele. Um serviço HTTP tem duas: github_read aceita só leituras, e github_write aceita qualquer chamada. As duas recebem method e o caminho completo path da documentação da API do serviço:

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

Um banco de dados recebe as ferramentas _query e _execute, e um host SSH recebe _exec para comandos e _sftp_read e _sftp_write para os seus arquivos. Uma caixa de correio recebe _read, _send e _change. As ferramentas de um servidor MCP remoto mantêm o próprio nome depois do nome da conexão. Todo agente também tem as ferramentas embutidas:

Uma chamada que espera uma pessoa avisa o cliente na hora, se o cliente enviou um progressToken. Essa notificação de progresso, e cada uma das seguintes da chamada, traz _meta com sallyport.cloud/call_id e sallyport.cloud/approve_url. O link de aprovação também vai no texto da mensagem, então qualquer cliente pode mostrá-lo.

Conecte um servidor MCP remoto

Abra MCP remoto. Informe a “URL do servidor MCP”: o endereço HTTPS completo, com a porta quando não for a padrão e com o caminho, como https://mcp.example.com/mcp.

Escolha a “Autenticação”: “Sem autenticação”, “Token Bearer”, “Basic”, “Chave de API” em um cabeçalho ou parâmetro de consulta, ou “OAuth 2.1”. Clique em “Salvar chave e conectar”.

Todos os agentes do espaço de trabalho recebem as ferramentas do servidor. O Sallyport se conecta ao servidor, adiciona a chave dele e devolve os resultados. O agente continua conectado só a https://mcp.sallyport.cloud/mcp.

Entre em um servidor com OAuth 2.1

Com “OAuth 2.1”, salvar abre a página de login do servidor e depois traz você de volta à conexão. O Sallyport guarda os tokens e os renova.

O Sallyport se registra sozinho nos servidores que permitem. Para os outros, registre um aplicativo com a URI de redirecionamento https://mcp.sallyport.cloud/callback/upstream. Informe o ID em “Client ID do aplicativo (opcional)”, e o segredo, se houver.

Quando o acesso expirar, clique em “Reconectar com OAuth” na página da conexão.