Autorizas capacidades, no un nuevo rol del espacio de trabajo.
OAuth permite que Claude, Codex o ChatGPT actúen como el usuario de HumanDesign.ai con sesión iniciada. No crea acceso, cambia la membresía ni concede al agente la propiedad de un espacio de trabajo.
Qué significa elegir un espacio de trabajo
La pantalla de consentimiento pregunta «¿Dónde debería trabajar Claude?» porque una cuenta de pago puede tener una biblioteca personal y uno o varios espacios de trabajo de equipo o empresa. La elección establece el límite de datos; no es un permiso adicional de membresía. Cada llamada sigue comprobando la membresía, el rol, las concesiones de capacidades, la propiedad y los permisos del producto. La autorización de Builder se aplica a proyectos permitidos dentro de ese límite; los proyectos no requieren concesiones OAuth independientes.
Cuentas Free e Individual: no tienen selector de espacio de trabajo. La conexión se limita a la cuenta personal y a la carta principal del usuario; Individual también incluye el uso de la cuenta. Para acceder a cartas de otras personas y a más herramientas de la plataforma se requiere Personal o Pro.
Para que el consentimiento no sea ambiguo, Personal y Pro muestran un único permiso combinado Cartas y biblioteca en lugar de casillas superpuestas para «tu carta» y «biblioteca». En el límite Personal incluye la carta principal y la biblioteca permitida; en un espacio de trabajo seleccionado, se reduce a las cartas y composiciones autorizadas en ese espacio.
Ámbitos de identidad y concesiones de capacidades
El protocolo OAuth solo solicita ámbitos de identidad y sesión, como email, profiley offline_access. Tras iniciar sesión, HumanDesign.ai deduce las siguientes concesiones internas de capacidades a partir del límite de cuenta seleccionado, la membresía, el rol, la propiedad y los permisos. Son etiquetas de control, no ámbitos OAuth adicionales que un cliente pueda solicitar para evitar la membresía.
| Concesión de capacidad | Permite |
|---|---|
charts:read | Leer registros de cartas autorizadas |
charts:generate | Crear la carta principal del usuario conectado tras la vista previa y la confirmación |
library:read | Buscar y recuperar elementos permitidos de la biblioteca |
library:organize | Gestionar carpetas y ubicación de elementos |
reports:read | Leer plantillas, informes y estado de generación |
builder:read | Leer proyectos y ejecuciones autorizados de Builder |
builder:write | Cancelar una ejecución activa de Builder cuando esté permitido |
account:usage | Leer saldos, cupo y resúmenes de uso |
Qué aparece en el agente
tools/list se filtra según las concesiones actuales de capacidades, la membresía, el rol del espacio de trabajo, la propiedad y los permisos del usuario autenticado. Los cambios de plan o de rol y la revocación de permisos surten efecto tras volver a conectar o actualizar el token. El estado y la cancelación de una operación también vuelven a comprobar la capacidad que autorizó la operación original; así, quitar un permiso no deja accesible un trabajo anterior mediante las herramientas de operaciones.
Confirmación y efectos externos
Cuando una herramienta ofrece una vista previa o confirmación, esta queda vinculada al actor, el límite, la acción, los argumentos, el destino, el cargo máximo y el vencimiento. Si cambia cualquiera de esos datos, deja de ser válida. La creación de la carta principal requiere una vista previa de una unidad y confirmación; eliminar una carpeta de la biblioteca también requiere confirmar. La cancelación de operaciones y ejecuciones de Builder se realiza directamente solo cuando el estado actual lo permite. En esta versión siguen sin estar disponibles las acciones de publicación y entrega de mayor riesgo.
Revocar acceso
Desconecta HumanDesign.ai desde los ajustes del conector del cliente o borra la autenticación de MCP. La revocación termina la conexión delegada; no elimina datos de HumanDesign.ai ni cambia la membresía.