Amocrm MCP

## 🗄 Репозиторий заархивирован

Разработка переехала в [theYahia/WWmcp](https://github.com/theYahia/WWmcp) — монорепозиторий MCP-серверов для незападных API: СНГ, MENA, Африка, LATAM, Юго-Восточная Азия. Общее ядро @theyahia/mcp-core, единый CI, единый релизный конвейер.

Актуальная версия того, что лежало здесь: servers/amocrm/

Пакет в npm прежний — @theyahia/amocrm-mcp, ставится и работает как раньше.

Здесь больше ничего не обновляется. Задачи и pull request'ы — в WWmcp.

Archived — development moved to [theYahia/WWmcp](https://github.com/theYahia/WWmcp), a monorepo of MCP servers for non-Western APIs.

The current version of this package now lives at servers/amocrm/.

The npm package @theyahia/amocrm-mcp is unchanged.

Please open issues and pull requests there.

amoCRM MCP — сделки, контакты и воронка продаж через нейросеть

Если вы искали, как подключить amoCRM к ИИ-ассистенту, спросить состояние воронки обычными словами, завести сделку или найти контакт не открывая интерфейс — это оно. 19 инструментов для amoCRM: сделки, контакты, компании, воронки, задачи, примечания, поиск, события и неразобранное. OAuth 2.0 с автообновлением токена, ограничение 7 запросов/сек и повтор с экспоненциальной задержкой.

Установка

npx -y @theyahia/amocrm-mcp

Настройка MCP

Добавьте в конфигурацию Claude Desktop, Cursor или любого другого MCP-клиента:

{

"mcpServers": { "amocrm": { "command": "npx", "args": ["-y", "@theyahia/amocrm-mcp"], "env": { "AMOCRM_SUBDOMAIN": "mycompany", "AMOCRM_ACCESS_TOKEN": "your-access-token", "AMOCRM_REFRESH_TOKEN": "your-refresh-token", "AMOCRM_CLIENT_ID": "your-client-id", "AMOCRM_CLIENT_SECRET": "your-client-secret" } } } }

Переменные окружения

AMOCRM_DOMAIN тоже принимается как алиас AMOCRM_SUBDOMAIN (обратная совместимость).

Инструменты (19)

Сделки

Контакты

Компании

Воронки

Задачи

Неразобранное

Примечания

Поиск

События

Аккаунт

Демо-промпты

Обзор продаж:

«Покажи все сделки в воронке „Продажи“, которые сейчас на этапе „Переговоры“. С контактами.»

Работа с задачами:

«Создай задачу-перезвон по сделке #12345, дедлайн завтра в 10:00. Потом выведи все мои невыполненные задачи.»

Заведение нового клиента:

«Создай контакт „Иван Петров“ с телефоном +79001234567, потом компанию „Петров Солюшнс“ и сделку „Разработка сайта“ на 150 000 рублей в основной воронке.»

Как настроить OAuth 2.0

1. Откройте настройки аккаунта amoCRM: https://YOUR_SUBDOMAIN.amocrm.ru/settings/widgets/
2. Создайте новую интеграцию (внешняя интеграция)
3. Укажите redirect URI: https://YOUR_SUBDOMAIN.amocrm.ru
4. Скопируйте Client ID и Client Secret
5. Авторизуйте интеграцию, чтобы получить первичный код авторизации
6. Обменяйте код на токены:

curl -X POST https://YOUR_SUBDOMAIN.amocrm.ru/oauth2/access_token \

-H "Content-Type: application/json" \ -d '{ "client_id": "YOUR_CLIENT_ID", "client_secret": "YOUR_CLIENT_SECRET", "grant_type": "authorization_code", "code": "YOUR_AUTH_CODE", "redirect_uri": "https://YOUR_SUBDOMAIN.amocrm.ru" }'

1. Сохраните access_token и refresh_token из ответа
2. Сервер сам обновит просроченный токен, если заданы AMOCRM_REFRESH_TOKEN, AMOCRM_CLIENT_ID и AMOCRM_CLIENT_SECRET

Обработка ошибок

• 401 Unauthorized — автообновление токена, если настроены реквизиты для refresh, затем повтор запроса
• 429 Rate Limited — учитывает заголовок Retry-After, ждёт и повторяет
• 5xx — повтор с экспоненциальной задержкой (до 3 попыток)
• Ограничение частоты — встроенная пауза 150 мс между запросами (~7 запросов/сек), чтобы укладываться в лимиты amoCRM

Разработка

git clone https://github.com/theYahia/amocrm-mcp.git

cd amocrm-mcp npm install npm run build npm test

Лицензия

MIT

---

Telegram: @vhodvai