{
  "markdown": "# amoCRM MCP — сделки, контакты и воронка продаж через нейросеть\n\nЕсли вы искали, как подключить amoCRM к ИИ-ассистенту, спросить состояние воронки обычными словами, завести сделку или найти контакт не открывая интерфейс — это оно. 19 инструментов для [amoCRM](https://www.amocrm.ru/): сделки, контакты, компании, воронки, задачи, примечания, поиск, события и неразобранное. OAuth 2.0 с автообновлением токена, ограничение 7 запросов/сек и повтор с экспоненциальной задержкой.\n\n## Установка\n\n```bash\nnpx -y @theyahia/amocrm-mcp\n```\n\n## Настройка MCP\n\nДобавьте в конфигурацию Claude Desktop, Cursor или любого другого MCP-клиента:\n\n```json\n{\n  \"mcpServers\": {\n    \"amocrm\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@theyahia/amocrm-mcp\"],\n      \"env\": {\n        \"AMOCRM_SUBDOMAIN\": \"mycompany\",\n        \"AMOCRM_ACCESS_TOKEN\": \"your-access-token\",\n        \"AMOCRM_REFRESH_TOKEN\": \"your-refresh-token\",\n        \"AMOCRM_CLIENT_ID\": \"your-client-id\",\n        \"AMOCRM_CLIENT_SECRET\": \"your-client-secret\"\n      }\n    }\n  }\n}\n```\n\n## Переменные окружения\n\n| Переменная | Обяз. | Описание |\n|----------|----------|-------------|\n| `AMOCRM_SUBDOMAIN` | да | Поддомен вашего amoCRM (например, `mycompany` из `mycompany.amocrm.ru`) |\n| `AMOCRM_ACCESS_TOKEN` | да | OAuth access-токен |\n| `AMOCRM_REFRESH_TOKEN` | нет | OAuth refresh-токен (включает автообновление при 401) |\n| `AMOCRM_CLIENT_ID` | нет | OAuth client ID (нужен для обновления токена) |\n| `AMOCRM_CLIENT_SECRET` | нет | OAuth client secret (нужен для обновления токена) |\n\n> `AMOCRM_DOMAIN` тоже принимается как алиас `AMOCRM_SUBDOMAIN` (обратная совместимость).\n\n## Инструменты (19)\n\n### Сделки\n| Инструмент | Описание |\n|------|-------------|\n| `list_leads` | Поиск и список сделок с фильтрами (воронка, статусы, запрос). Подтягивает контакты и причины отказа. |\n| `get_lead` | Одна сделка по ID вместе со связанными контактами и элементами каталога. |\n| `create_lead` | Создать сделку с названием, бюджетом, воронкой, статусом и пользовательскими полями. |\n| `update_lead` | Обновить поля сделки — перевести между этапами, изменить бюджет, сменить ответственного. |\n\n### Контакты\n| Инструмент | Описание |\n|------|-------------|\n| `list_contacts` | Поиск контактов по имени, телефону, e-mail. |\n| `get_contact` | Один контакт со всеми пользовательскими полями. |\n| `create_contact` | Создать контакт с телефоном, e-mail и пользовательскими полями. |\n\n### Компании\n| Инструмент | Описание |\n|------|-------------|\n| `list_companies` | Поиск компаний. Подтягивает связанные сделки и контакты. |\n| `create_company` | Создать компанию с пользовательскими полями. |\n\n### Воронки\n| Инструмент | Описание |\n|------|-------------|\n| `list_pipelines` | Все воронки продаж вместе с их статусами (этапами). |\n\n### Задачи\n| Инструмент | Описание |\n|------|-------------|\n| `list_tasks` | Список задач с фильтрами по сущности, выполненности и ответственному. |\n| `create_task` | Создать задачу, привязанную к сделке, контакту или компании, с дедлайном. |\n| `complete_task` | Отметить задачу выполненной и добавить текст результата. |\n\n### Неразобранное\n| Инструмент | Описание |\n|------|-------------|\n| `list_unsorted` | Входящие неразобранные заявки (формы, разбор почты). |\n| `accept_unsorted` | Принять неразобранную заявку в воронку. |\n\n### Примечания\n| Инструмент | Описание |\n|------|-------------|\n| `add_note` | Добавить примечание (common, call_in, call_out, service_message) к любой сущности. |\n\n### Поиск\n| Инструмент | Описание |\n|------|-------------|\n| `search` | Универсальный поиск по сделкам, контактам и компаниям. |\n\n### События\n| Инструмент | Описание |\n|------|-------------|\n| `list_events` | Лента событий — смены статусов, звонки, примечания, связи. |\n\n### Аккаунт\n| Инструмент | Описание |\n|------|-------------|\n| `get_account` | Информация об аккаунте, пользователи, типы задач, настройки amojo. |\n\n## Демо-промпты\n\n**Обзор продаж:**\n> «Покажи все сделки в воронке „Продажи“, которые сейчас на этапе „Переговоры“. С контактами.»\n\n**Работа с задачами:**\n> «Создай задачу-перезвон по сделке #12345, дедлайн завтра в 10:00. Потом выведи все мои невыполненные задачи.»\n\n**Заведение нового клиента:**\n> «Создай контакт „Иван Петров“ с телефоном +79001234567, потом компанию „Петров Солюшнс“ и сделку „Разработка сайта“ на 150 000 рублей в основной воронке.»\n\n## Как настроить OAuth 2.0\n\n1. Откройте настройки аккаунта amoCRM: `https://YOUR_SUBDOMAIN.amocrm.ru/settings/widgets/`\n2. Создайте новую интеграцию (внешняя интеграция)\n3. Укажите redirect URI: `https://YOUR_SUBDOMAIN.amocrm.ru`\n4. Скопируйте **Client ID** и **Client Secret**\n5. Авторизуйте интеграцию, чтобы получить первичный **код авторизации**\n6. Обменяйте код на токены:\n\n```bash\ncurl -X POST https://YOUR_SUBDOMAIN.amocrm.ru/oauth2/access_token \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"client_id\": \"YOUR_CLIENT_ID\",\n    \"client_secret\": \"YOUR_CLIENT_SECRET\",\n    \"grant_type\": \"authorization_code\",\n    \"code\": \"YOUR_AUTH_CODE\",\n    \"redirect_uri\": \"https://YOUR_SUBDOMAIN.amocrm.ru\"\n  }'\n```\n\n7. Сохраните `access_token` и `refresh_token` из ответа\n8. Сервер сам обновит просроченный токен, если заданы `AMOCRM_REFRESH_TOKEN`, `AMOCRM_CLIENT_ID` и `AMOCRM_CLIENT_SECRET`\n\n## Обработка ошибок\n\n- **401 Unauthorized** — автообновление токена, если настроены реквизиты для refresh, затем повтор запроса\n- **429 Rate Limited** — учитывает заголовок `Retry-After`, ждёт и повторяет\n- **5xx** — повтор с экспоненциальной задержкой (до 3 попыток)\n- **Ограничение частоты** — встроенная пауза 150 мс между запросами (~7 запросов/сек), чтобы укладываться в лимиты amoCRM\n\n## Разработка\n\n```bash\ngit clone https://github.com/theYahia/amocrm-mcp.git\ncd amocrm-mcp\nnpm install\nnpm run build\nnpm test\n```\n\n## Лицензия\n\nMIT\n",
  "bytes": 5766,
  "sha": "5b38e53bed42d0a20792ec1de04fccfe36b6fa5ac4fb733c5d368e6fb40eb3ca",
  "repo_slug": "theyahia/amocrm-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_theyahia_amocrm_mcp_49d810ac/readme"
}