Permisos de la CLI de Attio para agentes de IA
Elige qué puede cambiar un agente en Attio y qué controles valen digan lo que digan los ajustes.
Deja que un agente de IA trabaje con tu espacio de trabajo de Attio a través de attio y conserva la última palabra
sobre lo que cambia. El token de acceso lee todo el espacio de trabajo, y con ámbitos de escritura lo cambia, así que
sin tus propios límites un agente podría hacer lo que permite el token.
Para cada perfil, el nombre que diste al inicio de sesión de un espacio de trabajo, decides qué puede solo leer un agente, qué te pregunta antes y qué sigue adelante. Puedes alejar toda escritura de un agente con una línea, y sabes qué comprobaciones se mantienen digan lo que digan los ajustes.
Cada comando tiene una clave de permiso, su nombre, como deals.list o api.notes-create, o un grupo como api,
donde la clave más larga gana. Cada clave tiene un nivel: deny, readonly, ask o allow. attio work config set
los pone, y --dry-run muestra qué claves comprueba un comando.
En esta página:
- Los niveles
- Lo que viene puesto antes de que cambies nada
- Aleja toda escritura de un agente
- Agentes y MCP
- Comprobaciones que se mantienen digan lo que digan los permisos
Los niveles
| Nivel | Qué pasa |
|---|---|
deny | El comando se rechaza, también una lectura. |
readonly | Las lecturas funcionan. Una escritura se rechaza. |
ask | Una escritura pregunta antes en una terminal. Sin terminal se rechaza, salvo que se dé --yes. Por MCP se ejecuta. |
allow | El comando se ejecuta sin preguntar. |
attio work config set permissions.api readonly # every api operation reads, none writes
attio work config set permissions.people deny # no live reads of people on this profile
attio work config show # each key with its level and where it came fromUn rechazo es permission_error (código de salida 5) y nombra la clave. No significa que el inicio de sesión esté
roto.
Un agente no puede aflojar un permiso: un config set o config unset que levantaría un límite se rechaza, salvo que
lo ejecutes tú en una terminal.
Lo que viene puesto antes de que cambies nada
| Clave | Nivel de serie | Por qué |
|---|---|---|
api.<operation> que borra, como api.objects-records-delete | ask | Un borrado no se puede deshacer. También comprueba attio.delete. |
attio.delete | ask | Una sola clave para todos los borrados. Ponla en deny para pararlos todos. |
Cualquier otro comando, escrituras de api incluidas | allow |
Los comandos de negociaciones, embudos, etapas, cambios, campos y búsqueda solo leen. Los comandos de personas,
empresas y usuarios también solo leen. Solo el grupo api escribe en Attio.
Aleja toda escritura de un agente
--dry-run nombra cada clave que comprueba un comando, con su nivel, y no envía nada:
attio work api objects-records-delete --object deals --record-id 0d7d1c2e-0000-4000-8000-000000000000 --dry-runEl id de registro de arriba es inventado. Cualquiera de estas opciones hace que las escrituras sigan siendo tuyas:
- Ámbitos de lectura en el token. Crea el token con solo los tres ámbitos de lectura de instala. Entonces el propio Attio rechaza toda escritura.
apienreadonly.attio work config set permissions.api readonly. Todas las lecturas deapisiguen funcionando.- Sin borrados.
attio work config set permissions.attio.delete denydetiene todo borrado y deja las demás escrituras como están.
Agentes y MCP
Por MCP no hay nadie en una terminal para responder, y el servidor no muestra ningún formulario, así que una escritura
en ask sigue adelante. Eso vale también para los niveles de serie: un agente con un token que tiene ámbitos de
escritura puede borrar registros. Elige una opción antes de conectar una aplicación:
- Pon
permissions.apienreadonly, como arriba. - O deja los niveles y activa la aprobación de la herramienta
attio_writeen el cliente de tu agente, para que el cliente te pregunte antes de cada escritura.
mcp serve --permission api=readonly y mcp add … --permission … hacen un nivel más estricto para ese servidor.
Nunca aflojan el perfil. Mira MCP.
Comprobaciones que se mantienen digan lo que digan los permisos
WCATTIO_READ_ONLY=1rechaza toda escritura, en esa shell o en la aplicación que la pone.- Los ámbitos del token. Attio rechaza lo que no permiten los ámbitos del token, diga lo que diga el perfil.
- El texto de Attio son datos. Los títulos de negociaciones, los nombres y los valores de atributos llegan a un
agente marcados como
untrusted, así que un agente no los toma como instrucciones.