Tokens de agente
Un token permite que un agente actúe por ti, nunca con más que tu rol.
La mayoría de los agentes inician sesión en el navegador y no necesitan token (consulta Conecta tu agente). Usa un token para CI, máquinas remotas y agentes que no pueden abrir un navegador.
- Un token por dispositivo o agente, con una etiqueta como
ciocursor-work. Los tokens empiezan porsst_. - Se muestra una sola vez, al crearlo. SDD Vault solo conserva un hash.
- Los tokens de solo lectura actúan como lector en todos los proyectos; los de lectura y escritura actúan con tu rol. Ninguno puede más que tú, y la constitución sigue siendo solo para propietarios.
- Un token cubre toda la organización o los proyectos que elijas.
- Los tokens caducan: la duración es obligatoria y la organización puede fijar un máximo (
sddvault org security set <ORG> --token-max-days <DAYS>). - Se pueden revocar en cualquier momento; los agentes que los usan quedan desconectados en su siguiente llamada.
Crear uno
En la aplicación, abre Tokens de agente. O usa la CLI:
sddvault tokens list lista tus tokens y sddvault tokens revoke <ID> revoca uno. La aplicación muestra cuándo, desde dónde y con qué cliente se usó cada token por última vez.
Usarlo
Envíalo como Authorization: Bearer sst_…, o guárdalo en la variable de entorno SDD_VAULT_TOKEN y haz referencia a ella desde tu configuración MCP.
sddvault init --token escribe un token en la configuración de los agentes que no pueden iniciar sesión en el navegador; añade --read para que sea de solo lectura.