Conectar à API da OpenAI
Tradução adaptada da documentação oficial do Make, consultada em 26 de setembro de 2026.
Antes de começar
Tenha a URL e a chave da sua caixa de ferramentas MCP do Make. Para autenticar a chamada à API da OpenAI, você também precisa da chave de API da OpenAI; ela não é a chave da caixa de ferramentas.
Montar a requisição
Envie uma requisição POST para https://api.openai.com/v1/responses.
Configure os cabeçalhos:
Content-Type:application/json.Authorization:Bearer, seguido de um espaço e da sua chave de API da OpenAI.
No corpo JSON, use os seguintes campos do exemplo publicado pelo Make:
| Campo | Valor |
|---|---|
model |
A string gpt-4.1, modelo usado no exemplo da fonte |
input |
A string List all available tools. |
tools |
Um array contendo um objeto com os três campos abaixo |
tools[0].type |
A string mcp |
tools[0].server_label |
A string make |
tools[0].server_url |
A URL completa da caixa de ferramentas com a chave e o caminho de transporte, montada conforme a próxima seção |
Montar a URL do servidor
No campo server_url, una estes elementos, na ordem:
- A URL gerada ao criar a caixa de ferramentas MCP.
- O segmento
/t/. - A chave gerada para essa caixa de ferramentas.
- O caminho
/stateless.
A documentação recomenda HTTP Streamable sem estado (/stateless) pela confiabilidade da conexão. Se houver problemas de conexão, ela orienta substituir o trecho final /stateless por /stream.
Tempo limite
Os cenários da caixa de ferramentas MCP precisam terminar em até 40 segundos. Se um cenário levar mais tempo, a conexão expira e nenhum resultado retorna ao cliente.
Orientações editoriais
As orientações desta seção são complementos do MakeAutomation, não resultados de um teste em conta autenticada:
- Use JSON válido: nomes de propriedades e strings entre aspas duplas, sem vírgula depois da última propriedade de um objeto.
- Trate a URL completa do servidor como informação sensível, pois ela contém a chave da caixa de ferramentas. Não a publique em logs, capturas de tela ou repositórios.
- O modelo indicado acima é o do exemplo da fonte, não uma recomendação de preço nem uma garantia de acesso na sua conta.