~/studies/work 2026-11-20 · published 2026-11-21
Elicitation não é aprovação
A elicitation do MCP coleta entrada de uma pessoa. Ela não define nenhuma mensagem de aprovação. O que um registro de aprovação precisa guardar, a partir de uma leitura de código do connector-engine, e como três gateways perguntam a um humano.
- mcp
- approval
- elicitation
- security
- gateway
- ~/project/versatile-sh
O que a spec diz
Estas citações são da página de elicitation do MCP 2026-07-28, obtida em 2026-11-20 para o estudo de controles do connector-engine. As mesmas frases aparecem em 2025-11-25.
- O modo form coleta dados estruturados in band, e os dados são expostos ao cliente. O modo URL envia a pessoa a uma URL externa, e dados além da URL não são expostos ao cliente.
- Servidores NÃO DEVEM usar o modo form para senhas, chaves de API, tokens ou credenciais de pagamento, e DEVEM usar o modo URL para eles.
- Servidores DEVEM vincular as solicitações de elicitation à identidade do cliente e do usuário. Clientes DEVERIAM deixar o usuário recusar a qualquer momento.
- A resposta é accept, decline ou cancel. Accept significa que o usuário consentiu com a interação, não que ela esteja completa.
- Na página de tools: DEVERIA haver sempre um humano no loop capaz de negar invocações de tools.
Minha leitura, que a nota do scout também declara: a spec não define nenhum tipo de mensagem de aprovação. Elicitation é coleta genérica de entrada. Usá-la para aprovar é uma convenção que um gateway acrescenta.
Como os gateways a usam
| Gateway | Como uma pessoa aprova |
|---|---|
| DigitalOcean Action Gateway | Usa elicitation quando o cliente suporta; senão, um caminho separado de approve/deny com um id de aprovação e expiração. A aprovação é consumida uma vez e fica atrelada a team, escopo do endpoint, versão da tool e argumentos. |
| Composio | O usuário final responde. Com clientes que não suportam elicitation, as chamadas que precisam de aprovação são negadas, a menos que uma configuração de fallback esteja em allow. Always approve dura o resto da sessão. |
| connector-engine | Fora de banda: console, superfícies de chat e desktops pareados. A elicitation vem desligada por padrão em cada app. |
As três descrições são do fornecedor descrevendo o próprio produto, lidas por uma ferramenta de fetch, então confiança média. O padrão é que a elicitation é a conveniência in band e um segundo canal é o fallback.
Por que o connector-engine a mantém fora de banda
O modelo de segurança lista uma coisa como fora de escopo: quem tem o token de um agente aprovar a própria chamada via elicitation do MCP, quando o owner ligou a elicitation para aquele app. Pense pelo lado da ameaça. Se o cliente do agente repassa a pergunta, o cliente do agente também repassa a resposta. A parte governada fica no caminho da aprovação.
Fora de banda significa que a pergunta viaja por um canal que o agente não controla. As superfícies de chat só aceitam cliques do id de owner configurado, os tokens de link são HMACs de uso único, e os argumentos da chamada ficam fora de mensagens de terceiros.
O que o registro de aprovação guarda
O estudo leu o código de aprovação no commit 905a503. Nada foi executado. O registro carrega, entre cerca de trinta campos, o hash da definição, a classe da função, um hash da chamada, argumentos selados, aprovadores, modo, estado, canal e expiração. A máquina de estados é: pending, depois approved, denied, expired ou cancelled; approved, depois executing ou cancelled; executing, depois executed, failed ou outcome unknown; então delivered uma vez.
| Padrão | Valor |
|---|---|
| Timeout de aprovação | 600 s |
| Executar dentro de, após a decisão | 60 s, senão cancelada por obsoleta |
| Tolerância de execução após o deadline da chamada | 10 s, depois outcome unknown |
| Máximo de pendentes por sessão, agente e conector | 5 |
Duas escolhas se destacam. Uma aprovação decidida expira se não for executada em 60 segundos, então um clique não pode ser guardado para depois. E um outcome unknown nunca é retentado: o engine não sabe se o efeito colateral aconteceu, então não chuta.
Uma chamada repetida com o mesmo hash de chamada se anexa ao registro aberto em vez de abrir um segundo, e uma chamada aprovada roda uma vez.
O que a leitura achou de errado
Uma afirmação da documentação dizia que o engine guarda apenas um hash dos argumentos da chamada. Isso é verdade para a linha de auditoria. A linha de aprovação, porém, mantinha o texto puro selado até o fim da retenção, que por padrão é de uma hora. O estudo registrou isso como doc drift. A nota final dele diz que todo defeito encontrado pelo estudo foi corrigido ou mantido por decisão do owner; não reverifiquei cada correção.
Os nove controles do estudo foram pausados pelo owner em 2026-11-21. Só o armazenamento do log de mudanças de permissão está mergeado. Trate os designs como um roadmap, não como um compromisso.