CRMAttio

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:

  1. Los niveles
  2. Lo que viene puesto antes de que cambies nada
  3. Aleja toda escritura de un agente
  4. Agentes y MCP
  5. Comprobaciones que se mantienen digan lo que digan los permisos

Los niveles

NivelQué pasa
denyEl comando se rechaza, también una lectura.
readonlyLas lecturas funcionan. Una escritura se rechaza.
askUna escritura pregunta antes en una terminal. Sin terminal se rechaza, salvo que se dé --yes. Por MCP se ejecuta.
allowEl 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 from

Un 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

ClaveNivel de seriePor qué
api.<operation> que borra, como api.objects-records-deleteaskUn borrado no se puede deshacer. También comprueba attio.delete.
attio.deleteaskUna sola clave para todos los borrados. Ponla en deny para pararlos todos.
Cualquier otro comando, escrituras de api incluidasallow

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-run

El 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.
  • api en readonly. attio work config set permissions.api readonly. Todas las lecturas de api siguen funcionando.
  • Sin borrados. attio work config set permissions.attio.delete deny detiene 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.api en readonly, como arriba.
  • O deja los niveles y activa la aprobación de la herramienta attio_write en 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=1 rechaza 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.

Más: ajustes, seguridad.