OpenAI Responses

A Responses API aceita um servidor MCP remoto como ferramenta do tipo mcp. Passe o token do agente em authorization. A OpenAI não o guarda, então envie em toda requisição.

Conecte

Em Agentes, clique em «Novo agente» e «Criar agente», depois em «Novo token» em «Tokens». Guarde o token em SP_AGENT_TOKEN ao lado de OPENAI_API_KEY.

curl https://api.openai.com/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -d @- <<EOF
{
  "model": "gpt-6-astra",
  "input": "Which services can you reach through Sallyport?",
  "tools": [
    {
      "type": "mcp",
      "server_label": "sallyport",
      "server_url": "https://mcp.sallyport.cloud/mcp",
      "authorization": "$SP_AGENT_TOKEN",
      "require_approval": "never"
    }
  ]
}
EOF

Mantenha o item mcp_list_tools na conversa. Assim a OpenAI não busca a lista de ferramentas de novo no turno seguinte.

Duas etapas de aprovação

require_approval é a verificação da própria OpenAI. Por padrão, cada chamada volta primeiro para o seu código como mcp_approval_request. Com "never", as regras que você definiu no Sallyport decidem o que espera por uma pessoa.

Uma chamada que espera no Sallyport volta com approve_url e call_id. Mostre o link a quem responde por esse serviço e continue a conversa depois da resposta.

O resultado diz ao modelo para repetir a chamada com o mesmo call_id. Essa repetição devolve o desfecho, então o serviço é chamado uma vez.