Sandboxes por assistentes de IA (MCP)
O servidor MCP oferece ferramentas para o assistente usar sandboxes sem tocar nas suas
aplicações. Elas exigem o escopo OAuth mcp:sandbox, com tela de consentimento própria: autorizar mcp:operate não dá
acesso a sandboxes, e mcp:sandbox não dá terminal nem exec nas aplicações.
| Ferramenta | O que faz | Papel mínimo |
|---|---|---|
sandbox_list | lista as sandboxes do projeto | Viewer |
sandbox_create | cria uma sandbox (imagem, TTL, perfil de rede; aceita chave de idempotência) | Developer |
sandbox_run | executa um comando e devolve o código de saída e até 64 KB de saída | Developer |
sandbox_write_file / sandbox_read_file | grava ou lê um arquivo de texto do /workspace (até 1 MiB) | Developer |
sandbox_expose_port | expõe uma porta; PUBLIC pede a sua confirmação antes | Developer |
sandbox_terminate | encerra a sandbox (ação destrutiva, pede confirmação) | Developer |
Conectar
Conecte o servidor remoto no cliente MCP como de costume. Quando o assistente chama uma ferramenta sandbox_* sem o escopo, o
servidor responde 403 insufficient_scope com scope="mcp:sandbox" e o cliente pede a autorização adicional: você vê o
consentimento "Criar sandboxes isoladas, executar código, enviar e baixar arquivos e expor portas temporárias nelas".
Com token de API, use um token com mcp:use e sandboxes:read, sandboxes:write e sandboxes:exec.
Saída não confiável
Tudo o que vem de dentro da sandbox (saída de comandos, conteúdo de arquivos) chega ao assistente marcado como não confiável e cortado em 64 KB: um programa malicioso não consegue se passar por instrução sua. Portas públicas sempre pedem a sua confirmação, mesmo que o assistente insista.