~/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.

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

GatewayComo uma pessoa aprova
DigitalOcean Action GatewayUsa 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.
ComposioO 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-engineFora 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ãoValor
Timeout de aprovação600 s
Executar dentro de, após a decisão60 s, senão cancelada por obsoleta
Tolerância de execução após o deadline da chamada10 s, depois outcome unknown
Máximo de pendentes por sessão, agente e conector5

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.