Ir al contenido

Scopes

Cuando añades Engram como conector MCP, el cliente recibe un token de acceso OAuth. El token lleva un scope que determina lo que el cliente puede hacer en tu bóveda.

El endpoint MCP de Engram incluye actualmente un único scope monolítico: mcp.

Un token con el alcance mcp otorga al cliente acceso completo a todas las MCP funciones: leer notas, buscar semánticamente, escribir notas, editar carpetas, adjuntar archivos. No se divide en permisos por acción, pero está limitado a las bóvedas que elijas en la pantalla de consentimiento al conectar. Puedes seleccionar bóvedas específicas o todas las bóvedas (incluyendo las que crees más adelante).

Dividir mcp en scopes por acción (notes:read, notes:search, notes:write, notes:delete, folders:write, metadata:read) está en la hoja de ruta. Cuando se publique, el flujo del conector te permitirá conceder los permisos mínimos que necesite un agente (“leer y buscar, pero nunca escribir”) en lugar de la concesión de todo o nada actual.

Si los permisos granulares te importan ahora mismo, la solución alternativa es no conectar agentes en los que no confíes para escribir en tu bóveda. Hoy no existe ninguna forma, dentro del protocolo, de restringir la concesión una vez emitida.

En la aplicación Engram, la sección Ajustes → Conexiones muestra todas las conexiones OAuth y claves API activas. Haz clic en Revocar para desactivar una:

  • Una clave API revocada deja de funcionar inmediatamente.
  • Una conexión OAuth revocada ya no puede renovar su acceso y su token de acceso actual expira en 15 minutos.

Gramática de scopes (para quienes crean SDK)

Sección titulada «Gramática de scopes (para quienes crean SDK)»

El endpoint anuncia los scopes que admite mediante /.well-known/oauth-authorization-server. Quienes creen SDK deben leer esos metadatos en lugar de fijar cadenas de scope en el código, porque la división granular aparecerá primero ahí.