CRMAttio

Права ИИ-агента в CLI Attio

Выберите, что агент может менять в Attio, и какие проверки действуют при любых настройках.

Пусть ИИ-агент работает с вашим пространством Attio через attio, а решение о том, что он меняет, остается за вами. Токен доступа читает все пространство, а с правами на запись и меняет его, поэтому без ваших собственных ограничений агент мог бы сделать все, что разрешает токен.

Для каждого профиля, то есть имени, которое вы дали входу в одно пространство, вы решаете, что агент может только читать, что сначала спрашивает вас и что выполняется сразу. Одной строкой вы можете закрыть от агента любую запись и знаете, какие проверки действуют, что бы ни говорили настройки.

У каждой команды есть ключ разрешения, ее имя, например deals.list или api.notes-create, или группа, например api, и более длинный ключ побеждает. У каждого ключа есть уровень: deny, readonly, ask или allow. Уровни задаются через attio work config set, а --dry-run показывает, какие ключи проверяет команда.

На этой странице:

  1. Уровни
  2. Что задано, пока вы ничего не меняли
  3. Закройте от агента любую запись
  4. Агенты и MCP
  5. Проверки, которые действуют независимо от разрешений

Уровни

УровеньЧто происходит
denyКоманда отклоняется, чтение тоже.
readonlyЧтение работает. Запись отклоняется.
askЗапись сначала спрашивает в терминале. Без терминала она отклоняется, если не указан --yes. Через MCP она выполняется.
allowКоманда выполняется без вопроса.
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

Отказ это permission_error (код выхода 5), и он называет ключ. Он не значит, что вход сломан.

Агент не может ослабить разрешение: config set или config unset, которые сняли бы ограничение, отклоняются, если их не запускаете вы сами в терминале.

Что задано, пока вы ничего не меняли

КлючВстроенный уровеньПочему
api.<operation>, которая удаляет, например api.objects-records-deleteaskУдаление нельзя отменить. Оно также проверяет attio.delete.
attio.deleteaskОдин ключ для любого удаления. Поставьте deny, чтобы остановить их все.
Любая другая команда, включая записи apiallow

Команды сделок, воронок, этапов, изменений, полей и поиска только читают. Команды людей, компаний и пользователей тоже только читают. Пишет в Attio только группа api.

Закройте от агента любую запись

--dry-run называет каждый ключ, который проверяет команда, с его уровнем, и ничего не отправляет:

attio work api objects-records-delete --object deals --record-id 0d7d1c2e-0000-4000-8000-000000000000 --dry-run

Id записи в этой команде придуман. Записи останутся под вашим контролем с любым из этих способов:

  • Права на чтение у токена. Создайте токен только с тремя правами на чтение из раздела установка. Тогда Attio сам отклоняет любую запись.
  • api на readonly. attio work config set permissions.api readonly. Любое чтение api продолжает работать.
  • Без удалений. attio work config set permissions.attio.delete deny останавливает любое удаление, а другие записи оставляет как есть.

Агенты и MCP

Через MCP в терминале никого нет, чтобы ответить, и сервер не показывает форму, поэтому запись на уровне ask выполняется. Это касается и встроенных уровней: агент с токеном, у которого есть права на запись, может удалять записи. Прежде чем подключить приложение, выберите одно:

  • Поставьте permissions.api на readonly, как в разделе выше.
  • Или оставьте уровни и включите подтверждение для инструмента attio_write в клиенте агента, чтобы клиент спрашивал вас перед каждой записью.

mcp serve --permission api=readonly и mcp add … --permission … делают уровень строже для одного этого сервера. Профиль они никогда не ослабляют. См. MCP.

Проверки, которые действуют независимо от разрешений

  • WCATTIO_READ_ONLY=1 отклоняет любую запись в этой оболочке или в приложении, которое его задает.
  • Права токена. Attio отклоняет то, что не разрешают права токена, что бы ни говорил профиль.
  • Текст из Attio это данные. Названия сделок, имена и значения атрибутов приходят агенту с пометкой untrusted, поэтому агент не принимает их за инструкции.

Подробнее: настройки, безопасность.