Codex CLI

O Codex CLI entra no Sallyport sozinho e guarda seus servidores MCP em ~/.codex/config.toml.

Conecte

• Execute codex mcp add sallyport --url https://mcp.sallyport.cloud/mcp.
• Execute codex mcp login sallyport. O navegador abre o Sallyport.
• Entre ou crie uma conta e clique em «Permitir» na tela de consentimento.
• Adicione tool_timeout_sec = 300 à entrada, como abaixo.

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

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

Numa máquina onde ninguém entra, o Codex pega um token bearer de uma variável de ambiente, então o arquivo não guarda segredo.

• No console, abra Agentes, clique em «Novo agente», digite um nome e clique em «Criar agente».
• Na página do agente, em «Tokens», clique em «Novo token» e copie. Ele aparece uma única vez.
• Coloque o token em SP_AGENT_TOKEN no ambiente que inicia o Codex e adicione a entrada abaixo a ~/.codex/config.toml.

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

bearer_token_env_var guarda o nome da variável, nunca o token. codex mcp add sallyport --url https://mcp.sallyport.cloud/mcp --bearer-token-env-var SP_AGENT_TOKEN escreve as três primeiras linhas para você.

Por que tool_timeout_sec é 300

Por padrão, o Codex para de esperar uma ferramenta após 60 segundos. O Sallyport segura por no máximo 4 minutos uma chamada que espera por uma pessoa. Com 300, o Codex espera mais do que o Sallyport segura a chamada.

Quando uma chamada espera por uma pessoa

Por padrão, um push, um release ou um deploy passam direto. Eles esperam se você ativou «Perguntar sempre», colocou uma classe em «Exige aprovação» ou definiu um orçamento para essa conexão. Uma chamada em espera volta com approve_url e call_id.

Responda o cartão e peça ao Codex para continuar. Ele repete a chamada com o mesmo call_id, então o serviço é chamado uma vez. Para uma sessão longa, o cartão pode aprovar esse tipo de chamada por um tempo e um número de chamadas.