Escopos

Quando você adiciona o Engram como um Conector MCP, o cliente recebe um token de acesso OAuth. O token carrega um escopo que determina o que o cliente pode fazer no seu cofre.

O que o token concede hoje

O endpoint MCP do Engram hoje oferece um único escopo monolítico: mcp.

Um token com o escopo mcp concede ao cliente acesso total à funcionalidade MCP: ler notas, pesquisar semanticamente, escrever notas, editar pastas, anexar arquivos. Ele não é dividido em permissões específicas para cada ação, mas é limitado aos cofres que você escolher na tela de consentimento ao conectar. Você pode escolher cofres específicos ou todos os cofres (incluindo os que você criar posteriormente).

Escopos granulares estão planejados

Dividir o mcp em escopos por ação (notes:read, notes:search, notes:write, notes:delete, folders:write, metadata:read) está no roteiro. Quando isso for lançado, o fluxo do Conector permitirá conceder o mínimo de permissões que um agente precisa (“ler e buscar, mas nunca escrever”) em vez da concessão de tudo ou nada de hoje.

Se permissões granulares importam para você agora, o contorno é não conectar agentes em que você não confia para escrever no seu cofre. Atualmente não há como restringir a concessão dentro do protocolo depois que ela é emitida.

Auditoria e revogação de acesso

No Engram, a seção Configurações → Conexões lista todas as conexões OAuth e chaves de API ativas. Clique em Revogar para desativar uma delas:

• Uma chave de API revogada para de funcionar imediatamente.
• Uma conexão OAuth revogada não consegue mais renovar seu acesso e seu token de acesso atual expira em 15 minutos.

Gramática de escopos (para quem cria SDKs)

O endpoint anuncia os escopos que suporta em /.well-known/oauth-authorization-server. Quem cria SDKs deve ler esses metadados em vez de fixar strings de escopo no código, porque a divisão granular vai aparecer ali primeiro.