# amoCRM и Kommo: MCP-сервер и CLI для CRM (/ru/docs/amo)

Знайте, где стоит каждая сделка и что поменялось за ночь, не открывая amoCRM или Kommo. `amo` дает ИИ-агенту, с
которым вы уже работаете, например Claude Code или Codex, копию ваших сделок на вашем компьютере. Агент отвечает по
этой копии, даже без интернета. Он также двигает и закрывает сделки за вас, насколько вы это разрешите.

Спросите, какие сделки застряли на этапе "Quote sent", что поменялось в CRM со вчерашнего дня или как воронка Sales
отработала за последние 30 дней. Агент ответит со сделкой, ее суммой и ответственным. У amoCRM и Kommo нет своего
MCP-сервера для этих данных. Вам нужна одна приватная интеграция в аккаунте. Ее один раз создает администратор.

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

1. [Что вы получаете](#what-you-get)
2. [О чем новичок не догадается](#things-a-newcomer-would-not-guess)
3. [Как это выглядит](#how-it-looks)
4. [Почему amo](#why-amo)
5. [Что он умеет](#what-it-can-do)
6. [Как это работает](#how-it-works)
7. [Начните за несколько минут](#start-in-a-few-minutes)
8. [Ограничения](#limits)
9. [Найдите руководство для своей задачи](#find-a-guide-for-your-task)

## Что вы получаете [#что-вы-получаете]

- **Ответ, а не поиск.** Спросите о сделке или клиенте своими словами. Агент найдет сделку с ее суммой и
  ответственным, прочитав ее с вашего компьютера, без переходов по CRM.
- **Воронка одним взглядом.** Сколько сделок стоит на каждом этапе и на какую сумму, сколько дошло до этапа и пошло
  дальше, и доля выигранных за период.
- **Утро начинается с того, что поменялось.** Вчерашние новые сделки, победы, проигрыши и перемещения приходят
  короткой сводкой в выбранное вами время: уведомлением на рабочем столе или в ваш Telegram или почтовый ящик через
  `tg` или `mail` от WireCat.
- **Изменения по просьбе.** Достаточно сказать "Move Example kitchen to Negotiation". Агент найдет этап по названию,
  а вы можете проверить, какие разрешения нужны для изменения, до того как оно будет сделано.
- **CRM рядом с вашими чатами.** Один поиск находит сделку рядом с сообщениями, письмами и встречами о ней, которые
  другие инструменты WireCat хранят на вашем компьютере.

## О чем новичок не догадается [#о-чем-новичок-не-догадается]

- **В amoCRM нет лидов отдельно от сделок.** То, что API называет лидом, и есть сделка, поэтому у `amo` есть `deals`
  и нет `leads`.
- **Ключ это токен приватной интеграции.** Администратор аккаунта один раз создает интеграцию и генерирует ее
  долгосрочный токен. Токен действует с правами этого администратора. Если аккаунт amoCRM не помечен как технический,
  amoCRM сначала просит отказ от технической поддержки, и отозвать его нельзя. Kommo такого не просит.
  [Установка и подключение](/llms.mdx/docs/ru/amo/installation/content.md#create-the-integration) показывает каждый щелчок.
- **`work` это имя, которое вы выбираете.** Оно называет один аккаунт и стоит первым словом в каждой команде. Ни одна
  команда не выбирает аккаунт за вас.
- **Копия хранит ваши сделки, а не всю CRM.** Синхронизация копирует сделки, где ответственный вы или коллеги,
  которых выбрал администратор, вместе с их контактами и компаниями. Любой другой клиент каждый раз читается из
  аккаунта.
- **Сделку нельзя удалить.** В API v4 amoCRM нет такого вызова. Вместо этого закройте сделку как проигранную.
- **Через MCP "ask" выполняется.** MCP это способ, которым приложения вроде Claude Desktop вызывают инструмент, и там
  никто не сидит у терминала, чтобы ответить на вопрос. Прежде чем подключить агента, поставьте записям, которые он
  делать не должен, только чтение или запрет.
- **Смена этапа может запустить автоматизацию самого аккаунта**, например Salesbot, который пишет клиенту. Решите, кто
  может двигать сделку, прежде чем агент получит профиль.

## Как это выглядит [#как-это-выглядит]

```text
You:    What changed in the CRM since yesterday?
Agent:  (runs amo work changes list "at>=1d")
        · New deal "Example kitchen", 15 000 EUR, in Quote sent
        · "Example office" won, 8 200 EUR
        · Task "Call back about the quote" added on "Example kitchen"
You:    Move Example kitchen to Negotiation.
Agent:  (runs amo work deals move deal:12 "Negotiation")
        Done. "Example kitchen" (deal 12) is in Negotiation now.
```

## Почему amo [#почему-amo]

- **Копия ваших сделок на вашем компьютере.** Из инструментов в
  [сравнении](/llms.mdx/docs/ru/amo/compare/content.md) больше ни один не описывает чтение ваших сделок без интернета.
  Следующая синхронизация забирает только изменения.
- **Разрешение на каждое действие.** Разрешить, спросить, только чтение или запрет, для каждой команды и каждой
  операции API amoCRM. Сообщения клиентам, Salesbot и вебхуки, а также передача сделки коллеге запрещены, пока вы их
  не разрешите.
- **Записи можно сначала проверить.** `--dry-run` ничего не отправляет и показывает, какие разрешения нужны записи.
  Запись, ответ на которую потерялся, сама никогда не отправляется снова, поэтому оборванное соединение не создаст
  вторую сделку.
- **Бережно к amoCRM.** `amo` держится в пределах лимита amoCRM на число запросов в секунду, а большинству ответов
  запрос вообще не нужен.
- **Токен остается в связке ключей системы.** Он никогда не попадает в вывод, ошибки или логи.
- **amoCRM и Kommo, сколько угодно аккаунтов.** Каждый аккаунт это профиль, который вы называете в команде.
- **Бесплатно и с открытым кодом.** Apache 2.0.

Другой инструмент подойдет лучше, если агент должен сам ставить задачи и писать примечания. `amo` пишет их только
через `api call`, который вы запускаете сами после того, как разрешите его.

## Что он умеет [#что-он-умеет]

- **Сделки:** список по этапу, воронке, ответственному или статусу, одна сделка с ее контактами и историей этапов,
  создание, изменение, перемещение, закрытие как успешной или проигранной с причиной, и собственные поля аккаунта по
  их названию. [Работа с инструментом](/llms.mdx/docs/ru/amo/usage/content.md#read-your-deals)
- **Воронка:** каждый этап воронки с числом сделок и суммой, сколько пошло дальше, и доля выигранных за период.
  [Работа с инструментом](/llms.mdx/docs/ru/amo/usage/content.md#read-your-deals)
- **Контакты и компании:** найти, прочитать, создать и изменить их, а также выгрузить список в CSV-файл для таблицы.
  Пользователей аккаунта можно читать. [Работа с инструментом](/llms.mdx/docs/ru/amo/usage/content.md#read-your-deals)
- **Задачи, комментарии и звонки** по вашим сделкам, когда вы их включите, и задача на вашем компьютере каждый раз,
  когда сделка попадает на выбранный вами этап. [Работа с инструментом](/llms.mdx/docs/ru/amo/usage/content.md#tasks-and-what-changed)
- **Что поменялось:** созданные, перемещенные, выигранные, проигранные и переданные другому ответственному сделки,
  добавленные и выполненные задачи, и сводка по расписанию. [Работа с инструментом](/llms.mdx/docs/ru/amo/usage/content.md#tasks-and-what-changed)
- **Любая операция API v4 amoCRM** с теми же проверками разрешений. [Работа с инструментом](/llms.mdx/docs/ru/amo/usage/content.md#call-the-api)

## Как это работает [#как-это-работает]

- **Копия на вашем компьютере.** `sync` кладет ваши сделки и их клиентов в локальное хранилище WireCat, один файл на
  вашем компьютере, общий для всех инструментов WireCat. Списки, воронка и поиск читают его, в том числе без
  интернета.
- **Вход по токену или через интеграцию.** И то, и другое хранится в связке ключей системы, а на компьютере без нее в
  закрытом файле. [Установка и подключение](/llms.mdx/docs/ru/amo/installation/content.md)
- **Сделан для скриптов и агентов.** `--json` дает ответ в JSON, а ошибка приходит с кодом, по которому можно
  ветвиться. [MCP](/llms.mdx/docs/ru/amo/mcp/content.md)
- **Что хранится и что уходит в сеть.** [Безопасность](/llms.mdx/docs/ru/amo/security/content.md)

## Начните за несколько минут [#начните-за-несколько-минут]

Вставьте это своему агенту:

```text prompt
Установи amo командой npm install -g @wirecat/amo-cli. Помоги мне запустить amo work setup, чтобы подключить мой аккаунт amoCRM, затем синхронизируй и покажи мои открытые сделки.
```

Или выполните сами:

```sh
npm install -g @wirecat/amo-cli
amo skill install            # teaches Claude Code, Codex and Gemini CLI to use amo
amo work setup               # the account's address and the integration's token, step by step
amo work sync                # copy your deals and their clients
amo work deals list status:open
```

Нужен Node.js 22.16 или более поздний 22.x, либо Node.js 24 и новее. [Установка и подключение](/llms.mdx/docs/ru/amo/installation/content.md)

## Ограничения [#ограничения]

- Списки контактов и компаний фильтруются по ответственному или времени только с платным дополнением amoCRM с
  фильтрами API. Поиск по словам работает и без него.
- Контакты, компании и пользователи каждый раз читаются из аккаунта, поэтому им нужен интернет.
- Файлы в сделках и контактах пока не поддерживаются.
- Chats API, Диск и API ИИ-агента amoCRM живут на других хостах, и `amo` до них не достает.

## Найдите руководство для своей задачи [#найдите-руководство-для-своей-задачи]

| Задача | Руководство |
|---|---|
| Установить и подключить аккаунт | [Установка и подключение](/llms.mdx/docs/ru/amo/installation/content.md) |
| Читать и менять сделки, задачи, сводку | [Работа с инструментом](/llms.mdx/docs/ru/amo/usage/content.md) |
| Подключить приложение, которое работает по MCP | [MCP](/llms.mdx/docs/ru/amo/mcp/content.md) |
| Решить, что может менять агент | [Разрешения](/llms.mdx/docs/ru/amo/permissions/content.md) |
| Чьи сделки копирует синхронизация, и другие настройки | [Настройки](/llms.mdx/docs/ru/amo/configuration/content.md) |
| Точная команда или параметр | [Команды](/llms.mdx/docs/ru/amo/commands/content.md) |
| Что-то не работает | [Если что-то не работает](/llms.mdx/docs/ru/amo/troubleshooting/content.md) |
| Чем amo отличается от других инструментов для amoCRM | [Сравнение](/llms.mdx/docs/ru/amo/compare/content.md) |
