Crie agentes confiáveis com Make MCP Toolboxes

Reescrita editorial baseada no original do Make. As sugestões de desenho e validação são orientações editoriais, não um relato de testes realizados.

Uma MCP Toolbox permite disponibilizar um conjunto escolhido de cenários do Make como ferramentas para um cliente de IA. A proposta é definir a lógica no cenário e limitar quais ferramentas o cliente pode chamar, em vez de entregar a ele uma lista indiscriminada de ações.

O artigo do Make de 24/03/2026 apresenta exemplos de uso. Para configuração, autorização e comportamento, este guia segue o Help de MCP Toolboxes, consultado em 26/09/2026.

O que compõe uma toolbox

Cada toolbox tem uma URL própria, um conjunto de ferramentas e chaves de acesso. O Help permite criar várias chaves para a mesma toolbox e ajustar nome, descrição e comportamento apresentado ao cliente.

As ferramentas selecionáveis são cenários ativos, com agendamento On demand. Defina entradas e saídas claras antes de expor um cenário. Uma ferramenta de “consultar cliente”, por exemplo, precisa receber um identificador e retornar somente os dados necessários.

Criar a primeira toolbox

1. No menu lateral do Make, abra MCP Toolboxes e escolha Create toolbox.
2. Dê um nome que identifique a finalidade.
3. Em Tools, selecione os cenários que pretende disponibilizar.
4. Clique em Create.
5. No diálogo Create key, copie a chave e guarde-a em local seguro.
6. Feche o diálogo e copie a URL de MCP Server URL.

Se um cenário não aparecer, confira se está ativo e com o agendamento exigido. Não amplie o conjunto de ferramentas apenas para contornar uma configuração incompleta.

Conectar ao cliente MCP

Verifique na documentação do cliente quais transportes e métodos de autorização ele aceita. O Help recomenda HTTP Streamable e descreve duas formas de conexão: chave no cabeçalho de autorização ou chave incorporada à URL quando não há suporte a esse cabeçalho.

Quando suportado, use o cabeçalho Authorization com o esquema Bearer. Em clientes sem esse recurso, siga a estrutura de URL indicada no Help. Uma URL que contém a chave deve ser protegida como uma credencial: não a publique em capturas de tela, documentos compartilhados ou mensagens.

Use Connect with na toolbox para abrir as orientações do cliente ou consulte a documentação dele para servidores MCP remotos. A presença do nome Claude, Cursor ou ChatGPT no artigo não garante que toda versão ou modalidade desses produtos aceite a mesma configuração.

Nomes, descrições e comportamento

Nas configurações da ferramenta, descreva o resultado esperado e os dados necessários. Um nome preciso ajuda o cliente a escolher a ferramenta, mas não substitui validação no cenário.

Read only e Read & write são anotações. O Help explica que clientes compatíveis podem usá-las para decidir como pedir permissão. Marcar uma ferramenta como somente leitura não transforma um cenário que grava dados em uma barreira técnica de segurança. Confira os módulos e as permissões reais.

Usos práticos

• Cadastro de cliente: um cenário valida dados, cria registros e retorna os identificadores, sem fazer o modelo inventar a sequência.
• Preparação de documento: um cenário reúne informações autorizadas e retorna a referência do documento criado.
• Testes controlados: o cliente chama uma ferramenta com entradas de teste e a equipe compara o resultado esperado com o histórico.

São desenhos de aplicação. Um cenário predefinido ainda pode falhar por dados inválidos, permissões, erros de API ou lógica incorreta. Não há garantia automática de execução bem-sucedida.

Tempo de resposta e chaves

Na consulta de 26/09/2026, o Help informa que o cenário da toolbox deve terminar em 40 segundos; acima disso, a conexão expira e a saída não retorna ao cliente. Essa é uma condição técnica da toolbox, não uma informação de preços. A ausência de resposta não comprova que nenhuma ação foi executada: confira o histórico antes de repetir uma operação que grava dados.

Para adicionar uma chave, abra a toolbox e use Keys > Add. Nomeie-a de forma identificável e armazene-a com segurança. O Help também documenta a exclusão de chaves e da própria toolbox. Revise quais clientes dependem delas antes de alterar o acesso.

Verificação recomendada

Teste uma consulta, uma entrada inválida e uma ferramenta de escrita com dados descartáveis. Confira saídas, ações realizadas e permissões efetivas. Mantenha aprovação humana para ações sensíveis e revise o conjunto exposto quando o cenário mudar.