Cursor

O Cursor entra no Sallyport sozinho. Ele lê servidores MCP de ~/.cursor/mcp.json para todos os projetos e de .cursor/mcp.json dentro de um projeto.

Conecte

• Adicione a entrada abaixo a ~/.cursor/mcp.json. Se o arquivo já tiver servidores, adicione sallyport ao mcpServers dele.
• Abra Cursor Settings, encontre sallyport na seção MCP e clique em Connect. O navegador abre o Sallyport.
• Entre ou crie uma conta e clique em «Permitir» na tela de consentimento.

{
  "mcpServers": {
    "sallyport": {
      "url": "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

Um token serve para uma máquina onde ninguém entra pelo navegador. O Cursor o envia como cabeçalho, e o console escreve a entrada para você.

• 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», escolha «Cursor» e clique em «Copiar para o Cursor». A cópia leva o token que você acabou de criar nesta página, ou um novo.
• Cole em ~/.cursor/mcp.json. Se o arquivo já tiver servidores, adicione a entrada sallyport ao mcpServers dele.

{
  "mcpServers": {
    "sallyport": {
      "url": "https://mcp.sallyport.cloud/mcp",
      "headers": { "Authorization": "Bearer YOUR_AGENT_TOKEN" }
    }
  }
}

Um projeto, token fora do git

Para um único projeto, use .cursor/mcp.json. O Cursor resolve ${env:NAME} nos cabeçalhos, então o arquivo versionado nomeia uma variável em vez do token.

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

Defina SP_AGENT_TOKEN no ambiente com que o Cursor inicia. Dê a cada repositório o próprio agente, e o registro mostra quem fez cada chamada.

Quando uma chamada espera por uma pessoa

As chamadas passam direto, a menos que você tenha ativado «Perguntar sempre» para uma conexão, colocado uma classe em «Exige aprovação» ou definido um orçamento. O Sallyport segura uma chamada em espera por no máximo 4 minutos, e por no máximo 45 segundos se o cliente não envia um token de progresso. Então responde com approve_url e call_id.

Abra o link e responda, depois peça ao agente para continuar. Ele repete a chamada com o mesmo call_id e recebe o resultado, então o serviço é chamado uma vez.