# Права ИИ-агента в CLI Attio (/ru/docs/attio/permissions)

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

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

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

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

1. [Уровни](#the-levels)
2. [Что задано, пока вы ничего не меняли](#what-is-set-before-you-change-anything)
3. [Закройте от агента любую запись](#keep-every-write-away-from-an-agent)
4. [Агенты и MCP](#agents-and-mcp)
5. [Проверки, которые действуют независимо от разрешений](#checks-that-hold-whatever-the-permissions-say)

## Уровни [#уровни]

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

```sh
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-delete` | `ask` | Удаление нельзя отменить. Оно также проверяет `attio.delete`. |
| `attio.delete` | `ask` | Один ключ для любого удаления. Поставьте `deny`, чтобы остановить их все. |
| Любая другая команда, включая записи `api` | `allow` | |

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

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

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

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

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

- **Права на чтение у токена.** Создайте токен только с тремя правами на чтение из раздела
  [установка](/llms.mdx/docs/ru/attio/installation/content.md). Тогда Attio сам отклоняет любую запись.
- **`api` на `readonly`.** `attio work config set permissions.api readonly`. Любое чтение `api` продолжает работать.
- **Без удалений.** `attio work config set permissions.attio.delete deny` останавливает любое удаление, а другие
  записи оставляет как есть.

## Агенты и MCP [#агенты-и-mcp]

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

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

`mcp serve --permission api=readonly` и `mcp add … --permission …` делают уровень строже для одного этого сервера.
Профиль они никогда не ослабляют. См. [MCP](/llms.mdx/docs/ru/attio/mcp/content.md#keep-writes-yours).

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

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

Подробнее: [настройки](/llms.mdx/docs/ru/attio/configuration/content.md), [безопасность](/llms.mdx/docs/ru/attio/security/content.md).
