@theyahia/amocrm-mcp

MCP-сервер промышленного уровня для amoCRM API. 19 инструментов, покрывающих сделки, контакты, компании, воронки, задачи, примечания, поиск, события и неразобранные сделки. OAuth 2.0 с автоматическим обновлением токена. Ограничение скорости (7 запросов/сек). Повторные попытки с экспоненциальной задержкой.

Установка

npx -y @theyahia/amocrm-mcp

Related MCP server: 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, затем создай компанию «Petrov Solutions» и сделку «Разработка сайта» на 150 000 RUB в основной воронке."

Руководство по настройке 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. Авторизуйте интеграцию, чтобы получить первоначальный Authorization Code

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

• 429 Rate Limited: учитывает заголовок Retry-After, ожидает и повторяет запрос.

• 5xx Server Errors: повторные попытки с экспоненциальной задержкой (до 3 попыток).

• Ограничение скорости: встроенная задержка 150 мс между запросами (~7 запросов/сек), чтобы не превышать лимиты amoCRM.

Разработка

git clone https://github.com/theYahia/amocrm-mcp.git
cd amocrm-mcp
npm install
npm run build
npm test

Лицензия

MIT