Agentes
obop trata a los agentes de IA como usuarios de primera clase, limitados a propósito. Esta página explica el modelo; las siguientes muestran cómo configurar uno.
El modelo de agente
Un agente es cualquier cosa que actúa sobre obop con un token de agente: un cliente MCP como Claude Desktop o Cursor, un script que llama a la API REST, o la línea de comandos. Los agentes trabajan sobre los mismos registros y con los mismos comandos que las personas. Cuatro reglas lo hacen seguro.
- Alcance limitado. Un token de agente lleva una lista de grupos de permisos (sus scopes). Solo puede reducir lo que su propietario puede hacer, nunca ampliarlo. Si pide un grupo que el propietario no tiene, se rechaza.
- Enmascarado. Los datos personales se devuelven como tokens marcadores estables, como
EMAIL_1. Los campos financieros, de RR. HH. y de categorías especiales se retienen. Un agente puede seguir razonando sobre los registros y devolver tokens, pero nunca ve los valores reales. Consulta Tokens de enmascarado. - Proponer, no ejecutar. Un agente puede ejecutar acciones ordinarias dentro de sus scopes, pero para todo lo irreversible (contabilizar una factura, pagar, reembolsar, enviar, publicar, eliminar) solo puede proponerlo. El servidor devuelve el identificador de un plan y no cambia nada. Una persona aprueba. Consulta El ciclo de aprobación.
- La misma puerta. REST, MCP y la CLI pasan por un único despachador, así que un agente tiene exactamente los mismos permisos, el mismo enmascarado y las mismas aprobaciones se conecte como se conecte.
Tres formas de conectar
| Superficie | Úsala cuando | Página |
|---|---|---|
| MCP sobre stdio | Un cliente MCP (Claude Desktop, Claude Code, Cursor, VS Code, Windsurf y otros) debe llamar a obop como herramientas. | Conectar mediante MCP |
| REST | Un script o servicio llama a endpoints HTTP. | Usar la API REST |
| CLI | Una shell o una tarea cron llama a obop call. | Usar la CLI |
Configuración en cinco pasos
- Decide qué debe hacer el agente y qué grupos necesita para ello. Cuanto menos, mejor.
- Crea un token de agente con solo esos scopes.
- Conecta el agente mediante MCP, REST o la CLI.
- Prueba una lectura inofensiva y después un cambio que requiera aprobación, y apruébalo como persona.
- Lee las Buenas prácticas de seguridad antes de entregar el token a cualquier proceso desatendido.
Qué existe hoy y qué no
- Construido: tokens con alcance limitado, enmascarado y restauración, planes de aprobación, MCP sobre stdio, REST y la CLI.
- Aún no construido: un transporte MCP HTTP (remoto) con OAuth, por lo que todavía no se puede llegar a las instancias alojadas mediante MCP; una pantalla para crear o revocar tokens de agente; una lista de aprobaciones pendientes en la interfaz. Los tokens de agente no caducan y todavía no hay un comando para revocarlos. Se vuelve a señalar donde importa.
Consulta Flujos de ejemplo para prompts y flujos de partida, y Solución de problemas cuando algo no funcione.