Установка CLI и MCP-сервера amoCRM
Установите CLI для amoCRM из npm, создайте приватную интеграцию и войдите по токену или в браузере.
Подключите аккаунт amoCRM или Kommo один раз, и дальше ваш ИИ-агент сможет читать и обновлять ваши сделки. CRM хранит ваши сделки, контакты и компании в облаке и пускает программу только через приватную интеграцию, которую создает администратор аккаунта.
После этого агент отвечает, какие сделки открыты, переводит сделку на следующий этап или находит клиента, из терминала или по MCP, в пределах разрешений, которые вы задали. Те же команды вы запускаете сами или из скрипта.
amo это инструмент командной строки WireCat, то есть программа, которую вы или ваш агент запускаете по ее имени.
Он подключается один раз на каждый аккаунт, а amo work setup задает вопросы по очереди. Одна приватная интеграция
служит обоим способам входа: токену, который вы вставляете, или входу в браузере. Единственное условие: нужен
администратор аккаунта, который создаст интеграцию.
На этой странице:
- Установка
- Создайте интеграцию
- Вход по ключу
- Вход через интеграцию
- Что выбрать
- Подключение по шагам
- Выход и отзыв доступа
- Дальше: первая синхронизация
Установка
Установите amo один раз на каждом компьютере, где с ним работаете вы или агент. Нужен Node.js 22.16 или более
поздний 22.x, либо 24 и новее. Node 23 не поддерживается.
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. amo doctor не ходит в сеть и не
открывает связку ключей. Он показывает версию, где лежат настройки, какие есть профили и могут ли другие пользователи
компьютера читать настройки.
Создайте интеграцию
Это делает администратор аккаунта, один раз. Одна и та же интеграция служит и для ключа, и для входа в браузере.
В amoCRM (<subdomain>.amocrm.ru):
- Откройте амоМаркет, нажмите ⋯ слева вверху и выберите «Создать интеграцию».
- Дайте ей название и описание, например WireCat.
- В поле «Ссылка для перенаправления» (Redirect URI) укажите
https://wirecat.dev/webhooks/apps/amo-callback. Ключу она не нужна, но с ней та же интеграция работает и для входа в браузере. - В разделе «Предоставить доступ» отметьте «Доступ к данным аккаунта».
- «Контроль дублей» и «Множественные источники» оставьте без отметки и сохраните.
Если аккаунт не помечен как технический, amoCRM сначала просит подписать отказ от технической поддержки для приватной интеграции. После этого поддержка amoCRM больше не принимает обращения о системных ошибках в аккаунте, и отказ нельзя отозвать. Прочитайте его, прежде чем подписывать (amoCRM: интеграции, amoCRM: пошаговая инструкция).
В Kommo (<subdomain>.kommo.com или <subdomain>.amocrm.com): Settings → Integrations → Create integration.
Заполните название, описание и тот же Redirect URL. В Allow access по умолчанию отмечены все права.
Duplicate control и Multiple sources оставьте без отметки и сохраните. Kommo отказа не просит
(Kommo: приватная интеграция).
Вход по ключу
Ключ это долгосрочный токен amoCRM. Он действует с правами администратора, который его создал.
-
В интеграции откройте вкладку «Ключи» (в Kommo Keys and scopes) и нажмите «Сгенерировать токен» (в Kommo Generate long-lived token).
-
Выберите дату окончания, от одного дня до пяти лет.
-
Скопируйте токен. Он показывается только один раз (amoCRM: пошаговая инструкция, Kommo: долгосрочный токен).
-
Выберите имя профиля для этого аккаунта, например
work. Запустите команды, подставив адрес своего аккаунта вместоhttps://example.amocrm.ruиз примера, и вставьте токен, когдаamoего спросит: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: вы разрешаете интеграцию в браузере, и каждый человек действует со своими правами.
-
На вкладке интеграции «Ключи» (в Kommo Keys and scopes) скопируйте ID интеграции. Секретный ключ тоже держите открытым.
-
Запустите команду, подставив свой адрес и ID интеграции вместо
https://example.amocrm.ruи0123abcd-4567-89ef-0123-456789abcdefиз примера:amo work session start --host https://example.amocrm.ru --client-id 0123abcd-4567-89ef-0123-456789abcdef -
Вставьте секретный ключ, когда
amoего спросит. Он не показывается. Вместо этого его можно передать вAMO_AMOCRM_CLIENT_SECRET. -
Браузер откроет amoCRM. Выберите аккаунт и нажмите «Разрешить» (Allow).
amo хранит токены и сам обновляет токен доступа. Redirect URI интеграции должен быть
https://wirecat.dev/webhooks/apps/amo-callback. Новый вход любым способом заменяет прежний вход профиля.
Что выбрать
- Ключ проще всего: одна вставка, без браузера. Он действует от имени администратора, который его создал, и
перестает работать в дату окончания. Тогда создайте новый и снова запустите
session start. - Вход через интеграцию действует от имени того, кто входит, и даты окончания, за которой нужно следить, у него
нет. Refresh-токен amoCRM живет 3 месяца, и
amoполучает новый каждый раз, когда обновляет токен доступа. Поэтому вход работает, покаamoзапускается хотя бы раз в 3 месяца. После более долгого перерыва войдите снова (amoCRM: пошаговая инструкция).
Подключение по шагам
amo work setup задает вопросы по одному, проверяет ответы и сохраняет их, только если проверка прошла:
- Какой аккаунт? Адрес, по которому вы открываете CRM.
- Создайте приватную интеграцию. Шаги из раздела создайте интеграцию.
- Создайте токен. Вставьте ключ с вкладки «Ключи».
- Проверка токена.
amoспрашивает у аккаунта, кому принадлежит токен, и сохраняет адрес и токен, только если аккаунт ответил. Если токен отклонен, вы вернетесь к шагу с токеном. - Подключено. Профиль готов.
Здесь вход идет по ключу. Вход в браузере это команда, которая показана в разделе Advanced на последнем шаге.
Выход и отзыв доступа
amo work session end забывает вход на этом компьютере. amo work account remove --keep-data забывает вход и
файлы профиля, а --delete-data еще и удаляет копию аккаунта из хранилища WireCat.
Ни одна из этих команд не сообщает amoCRM. Чтобы остановить ключ в самом аккаунте, например после утечки, откройте вкладку интеграции «Выданные доступы» и нажмите «Отозвать доступ» (amoCRM: пошаговая инструкция). В Kommo это вкладка Authorization → Revoke access (Kommo: долгосрочный токен).
Дальше: первая синхронизация
Скопируйте сделки и их клиентов в WireCat, затем посмотрите открытые:
amo work sync
amo work deals list status:openПодробнее в разделе первая синхронизация.