amocrm-mcp-prm

Форк @theyahia/amocrm-mcp 2.0.2 (MIT). Все 19 исходных инструментов работают как раньше, добавлено 12 новых, фильтры и чтение переписки из мессенджер-шлюза «Чацкий».

Что добавлено

Переписка из Чацкого (включается, если задан CHATSKY_API_KEY):

С ключом get_lead_full сам добавляет переписку в карточку сделки. Отправки сообщений в сервере нет намеренно.

Изменения в старых инструментах:

• create_lead: можно сразу привязать существующие контакт и компанию (contact_id, company_id) или создать новые в том же вызове (contact, company), а также задать теги. В этих случаях используется /leads/complex: один контакт и одна компания на сделку.

• list_leads: фильтры created_from/to, updated_from/to, closed_from/to, responsible_user_ids, ids, сортировка order_by и order_dir, режим compact (читаемые даты, поля в виде «название → значение», без cookies и трекинга).

• list_events: types, created_from/to, created_by, status_after, status_before.

• list_tasks: due_from/to, order_dir, compact.

Даты принимаются как YYYY-MM-DD, ISO или Unix. Дата без времени читается в поясе аккаунта: переменная AMOCRM_TZ_OFFSET, по умолчанию +03:00.

Related MCP server: Bitrix24 MCP Server

Запуск

Собранный файл без зависимостей: bundle/amocrm-mcp-prm.mjs, нужен Node 18+.

{
  "mcpServers": {
    "amocrm": {
      "command": "node",
      "args": ["C:/путь/до/amocrm-mcp-prm.mjs"],
      "env": {
        "AMOCRM_SUBDOMAIN": "<поддомен>",
        "AMOCRM_ACCESS_TOKEN": "<токен>",
        "CHATSKY_API_KEY": "gw_...",
        "CHATSKY_URL": "https://msghub.prmonline.ru"
      }
    }
  }
}

Переменные amoCRM те же, что у исходного сервера. CHATSKY_API_KEY создается в Чацком: «Настройки» → «Ключи API интеграций». CHATSKY_URL можно не указывать, по умолчанию https://msghub.prmonline.ru.

Сборка из исходников: npm install && npm test && npm run bundle.

Ниже README исходного проекта.

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"
  }'

7. Сохраните access_token и refresh_token из ответа

8. Сервер сам обновит просроченный токен, если заданы 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