# Установка CLI и MCP-сервера amoCRM (/ru/docs/amo/installation)

Подключите аккаунт amoCRM или Kommo один раз, и дальше ваш ИИ-агент сможет читать и обновлять ваши сделки. CRM хранит
ваши сделки, контакты и компании в облаке и пускает программу только через приватную интеграцию, которую создает
администратор аккаунта.

После этого агент отвечает, какие сделки открыты, переводит сделку на следующий этап или находит клиента, из
терминала или по MCP, в пределах разрешений, которые вы задали. Те же команды вы запускаете сами или из скрипта.

`amo` это инструмент командной строки WireCat, то есть программа, которую вы или ваш агент запускаете по ее имени.
Он подключается один раз на каждый аккаунт, а `amo work setup` задает вопросы по очереди. Одна приватная интеграция
служит обоим способам входа: токену, который вы вставляете, или входу в браузере. Единственное условие: нужен
администратор аккаунта, который создаст интеграцию.

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

1. [Установка](#install)
2. [Создайте интеграцию](#create-the-integration)
3. [Вход по ключу](#sign-in-with-a-key)
4. [Вход через интеграцию](#sign-in-through-the-integration)
5. [Что выбрать](#which-one-to-choose)
6. [Подключение по шагам](#connect-step-by-step)
7. [Выход и отзыв доступа](#sign-out-and-revoke-access)
8. [Дальше: первая синхронизация](#next-the-first-sync)

## Установка [#установка]

Установите `amo` один раз на каждом компьютере, где с ним работаете вы или агент. Нужен Node.js 22.16 или более
поздний 22.x, либо 24 и новее. Node 23 не поддерживается.

```sh
npm install -g @wirecat/amo-cli
amo --version
amo skill install   # the agent skill, for Claude Code, Codex, Gemini CLI and OpenClaw
amo doctor
```

Агент без терминала, например Claude Desktop, работает с `amo` по [MCP](/llms.mdx/docs/ru/amo/mcp/content.md). `amo doctor` не ходит в сеть и не
открывает связку ключей. Он показывает версию, где лежат настройки, какие есть профили и могут ли другие пользователи
компьютера читать настройки.

## Создайте интеграцию [#создайте-интеграцию]

Это делает администратор аккаунта, один раз. Одна и та же интеграция служит и для ключа, и для входа в браузере.

В amoCRM (`<subdomain>.amocrm.ru`):

1. Откройте **амоМаркет**, нажмите **⋯** слева вверху и выберите **«Создать интеграцию»**.
2. Дайте ей название и описание, например *WireCat*.
3. В поле **«Ссылка для перенаправления»** (Redirect URI) укажите `https://wirecat.dev/webhooks/apps/amo-callback`.
   Ключу она не нужна, но с ней та же интеграция работает и для входа в браузере.
4. В разделе **«Предоставить доступ»** отметьте **«Доступ к данным аккаунта»**.
5. **«Контроль дублей»** и **«Множественные источники»** оставьте без отметки и сохраните.

Если аккаунт не помечен как технический, amoCRM сначала просит подписать отказ от технической поддержки для
приватной интеграции. После этого поддержка amoCRM больше не принимает обращения о системных ошибках в аккаунте, и
отказ нельзя отозвать. Прочитайте его, прежде чем подписывать
([amoCRM: интеграции](https://www.amocrm.ru/developers/content/integrations/intro),
[amoCRM: пошаговая инструкция](https://www.amocrm.ru/developers/content/oauth/step-by-step)).

В Kommo (`<subdomain>.kommo.com` или `<subdomain>.amocrm.com`): Settings → Integrations → **Create integration**.
Заполните название, описание и тот же **Redirect URL**. В **Allow access** по умолчанию отмечены все права.
**Duplicate control** и **Multiple sources** оставьте без отметки и сохраните. Kommo отказа не просит
([Kommo: приватная интеграция](https://developers.kommo.com/docs/private-integration)).

## Вход по ключу [#вход-по-ключу]

Ключ это долгосрочный токен amoCRM. Он действует с правами администратора, который его создал.

1. В интеграции откройте вкладку **«Ключи»** (в Kommo **Keys and scopes**) и нажмите **«Сгенерировать токен»**
   (в Kommo **Generate long-lived token**).
2. Выберите дату окончания, от одного дня до пяти лет.
3. Скопируйте токен. Он показывается только один раз
   ([amoCRM: пошаговая инструкция](https://www.amocrm.ru/developers/content/oauth/step-by-step),
   [Kommo: долгосрочный токен](https://developers.kommo.com/docs/long-lived-token)).
4. Выберите имя профиля для этого аккаунта, например `work`. Запустите команды, подставив адрес своего аккаунта
   вместо `https://example.amocrm.ru` из примера, и вставьте токен, когда `amo` его спросит:

   ```sh
   amo work session start --host https://example.amocrm.ru
   amo work session status --check
   ```

`session start` читает токен, не показывая его, или из stdin. Он проверяет токен на аккаунте и только потом
сохраняет его в связке ключей системы вместе с адресом. С `--credential-storage file` токен хранится в закрытом файле.
`session status --check` показывает аккаунт и пользователя, от имени которого действует токен. Адрес остается таким,
как вы его ввели: `<subdomain>.amocrm.ru`, `<subdomain>.kommo.com` или `<subdomain>.amocrm.com`.

## Вход через интеграцию [#вход-через-интеграцию]

Этот вход работает по OAuth: вы разрешаете интеграцию в браузере, и каждый человек действует со своими правами.

1. На вкладке интеграции **«Ключи»** (в Kommo **Keys and scopes**) скопируйте ID интеграции. Секретный ключ тоже
   держите открытым.
2. Запустите команду, подставив свой адрес и ID интеграции вместо `https://example.amocrm.ru` и
   `0123abcd-4567-89ef-0123-456789abcdef` из примера:

   ```sh
   amo work session start --host https://example.amocrm.ru --client-id 0123abcd-4567-89ef-0123-456789abcdef
   ```

3. Вставьте секретный ключ, когда `amo` его спросит. Он не показывается. Вместо этого его можно передать в
   `AMO_AMOCRM_CLIENT_SECRET`.
4. Браузер откроет amoCRM. Выберите аккаунт и нажмите **«Разрешить»** (Allow).

`amo` хранит токены и сам обновляет токен доступа. Redirect URI интеграции должен быть
`https://wirecat.dev/webhooks/apps/amo-callback`. Новый вход любым способом заменяет прежний вход профиля.

## Что выбрать [#что-выбрать]

- **Ключ** проще всего: одна вставка, без браузера. Он действует от имени администратора, который его создал, и
  перестает работать в дату окончания. Тогда создайте новый и снова запустите `session start`.
- **Вход через интеграцию** действует от имени того, кто входит, и даты окончания, за которой нужно следить, у него
  нет. Refresh-токен amoCRM живет 3 месяца, и `amo` получает новый каждый раз, когда обновляет токен доступа. Поэтому
  вход работает, пока `amo` запускается хотя бы раз в 3 месяца. После более долгого перерыва войдите снова
  ([amoCRM: пошаговая инструкция](https://www.amocrm.ru/developers/content/oauth/step-by-step)).

## Подключение по шагам [#подключение-по-шагам]

`amo work setup` задает вопросы по одному, проверяет ответы и сохраняет их, только если проверка прошла:

1. **Какой аккаунт?** Адрес, по которому вы открываете CRM.
2. **Создайте приватную интеграцию.** Шаги из раздела [создайте интеграцию](#create-the-integration).
3. **Создайте токен.** Вставьте ключ с вкладки «Ключи».
4. **Проверка токена.** `amo` спрашивает у аккаунта, кому принадлежит токен, и сохраняет адрес и токен, только если
   аккаунт ответил. Если токен отклонен, вы вернетесь к шагу с токеном.
5. **Подключено.** Профиль готов.

Здесь вход идет по ключу. Вход в браузере это команда, которая показана в разделе **Advanced** на последнем шаге.

## Выход и отзыв доступа [#выход-и-отзыв-доступа]

`amo work session end` забывает вход на этом компьютере. `amo work account remove --keep-data` забывает вход и
файлы профиля, а `--delete-data` еще и удаляет копию аккаунта из хранилища WireCat.

Ни одна из этих команд не сообщает amoCRM. Чтобы остановить ключ в самом аккаунте, например после утечки, откройте
вкладку интеграции **«Выданные доступы»** и нажмите **«Отозвать доступ»**
([amoCRM: пошаговая инструкция](https://www.amocrm.ru/developers/content/oauth/step-by-step)). В Kommo это вкладка
**Authorization** → **Revoke access** ([Kommo: долгосрочный токен](https://developers.kommo.com/docs/long-lived-token)).

## Дальше: первая синхронизация [#дальше-первая-синхронизация]

Скопируйте сделки и их клиентов в WireCat, затем посмотрите открытые:

```sh
amo work sync
amo work deals list status:open
```

Подробнее в разделе [первая синхронизация](/llms.mdx/docs/ru/amo/usage/content.md#the-first-sync).
