amo-crm-mcp: модульный сервер для AmoCRM
amo-crm-mcp
MCP-сервер на TypeScript с отдельным модулем на каждую сущность AmoCRM: задачи, воронки, лиды, пользователи, примечания, события
- 0 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Модули лидов и примечаний могут изменять данные в AmoCRM
- Интеграционный ключ хранится в .env на вашей стороне
Установка
- Работает в
- Сервисы
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/amo-crm-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Модули лидов и примечаний могут изменять данные в AmoCRM
- Интеграционный ключ хранится в .env на вашей стороне
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер построен на модульной архитектуре: базовый слой BaseServerContext, BaseModule и BaseController переиспользуется, а поверх него подключены модули amo-tasks, amo-pipelines, amo-leads, amo-users, amo-notes и amo-events, каждый со своим контроллером, сервисом и схемами. Модуль health отдает инструмент server-health с uptime, памятью и метаданными сервера. Логирование пишется в файл, чтобы не засорять stdout, обязательный для stdio-протокола. Конфигурация читается из .env через zod-валидацию, при некорректных значениях сервер не стартует. README документирует только базовые инструменты server-health и get_active_tasks, но в коде зарегистрированы и модули по воронкам, лидам, пользователям, примечаниям и событиям.
Для кого. Для разработчиков, которым интересна чистая модульная база для своего MCP-сервера AmoCRM и готовность расширять ее собственными модулями.
Подходит, если
- Нужна модульная архитектура MCP-сервера, которую легко расширить своим доменом
- Нужны задачи, воронки, лиды, пользователи, примечания и события AmoCRM в одном сервере
- Важна строгая валидация конфигурации через zod при старте
Не подходит, если
- Нужна точная документация каждого инструмента: README отстает от кода и описывает не все модули
- Нужен готовый npm-пакет: сервер собирается и запускается из исходников
Пример запроса к агенту
Покажи активные задачи в AmoCRM и статус самого MCP-сервераMCP
- Транспорт
- stdio
- Авторизация
- API-ключ
Переменные окружения
AMO_BASE_URLобязательная- Базовый URL API вида https://<subdomain>.amocrm.ru/api/v4/.
AMO_INTEGRATION_IDобязательная, секрет- Идентификатор интеграции AmoCRM.
AMO_INTEGRATION_SECRETобязательная, секрет- Секретный ключ интеграции.
AMO_INTEGRATION_KEYобязательная, секрет- Ключ доступа интеграции.
Ограничения
README описывает из коробки только server-health и get_active_tasks, хотя в src/modules/index.ts зарегистрированы еще пять модулей: воронки, лиды, пользователи, примечания и события. Точный список и параметры инструментов этих модулей нужно смотреть в исходниках, документация по ним не написана. Готового npm-пакета нет, сервер собирается локально командой npm run build.
Как отключить. Удалите сервер из конфигурации MCP-клиента и остановите процесс dist/index.js.
Частые вопросы
Есть ли инструменты по лидам и воронкам?
В коде да, модули amo-leads и amo-pipelines зарегистрированы в src/modules/index.ts, но README их не документирует.
Почему логи пишутся в файл, а не в консоль?
Протокол stdio требует чистый stdout только для JSON-сообщений, поэтому логи по умолчанию идут в файл по пути LOG_FILE_PATH.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
amoCRM — все инструментыМинимальный MCP-сервер для amoCRM API v4: чтение и создание сделок, контактов и примечаний, OAuth2 и долгосрочный токен
MCP-сервер для API v4 amoCRM (Kommo): сделки, контакты, компании, задачи, воронки, неразобранное и аналитика
MCP для руководителя отдела продаж в amoCRM
amoCRM ROP MCP Server
MCP-сервер с бизнес-инструментами поверх amoCRM для руководителя отдела продаж: сводка, зависшие сделки, сравнение менеджеров
MCP-сервер для amoCRM на FastMCP
amoCRM MCP Server
MCP-сервер на FastMCP с 39 инструментами по 11 доменам amoCRM: лиды, контакты, аналитика, батч-операции, деплой одним проектом Vercel на аккаунт
MCP-сервер для amoCRM и Kommo: сделки, контакты, задачи и отчеты по воронке, зависшие сделки и просроченные задачи менеджеров
MCP-сервер для Kommo (amoCRM)
kommo-mcp
Самостоятельно развернутый MCP на чистом Node.js с 41 инструментом для Kommo (amoCRM): сделки, воронки, задачи, очередь диалогов, salesbot
Коротко о README
README описывает модульную архитектуру, требования Node.js 18+, установку и запуск через npm, переменные окружения с валидацией zod, структуру src по слоям lib и core, и инструменты server-health и get_active_tasks с описанием возвращаемых данных.