AmoCRM MCP for GigaCowork
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
AmoCRM MCP for GigaCowork
Полная инструкция по установке и подключению — в INSTALL.md.
MCP-сервер полного доступа к amoCRM (API v4) для ИИ-платформ (GigaCowork, Claude, Cursor и любых MCP-клиентов): поиск и выгрузка сделок любого объёма, создание и изменение сделок, контактов, компаний, задач, примечаний, массовые операции, отчёты, настройка воронок и полей, плюс универсальный запрос к любому методу API.
Транспорт: Streamable HTTP (
/mcp), SSE (/sse) для старых клиентов, stdio для локального запуска.Авторизация к серверу: логин/пароль (логин любой, пароль = ключ),
Authorization: Bearer <ключ>,X-API-Key: <ключ>или?key=<ключ>в URL.Удобно для ИИ: воронки, этапы, ответственных, поля, теги и причины отказа можно указывать названиями. Даты понимаются в формате
2026-11-20,20.11.2026,tomorrow,+3d. Ошибки amoCRM приходят понятным текстом с подсказками.Большие объёмы: автоматический проход по страницам, выгрузка в XLSX/CSV по ссылке, отчёты считаются по всем записям без загрузки их в ответ модели.
Надёжность: соблюдает лимит amoCRM (≤7 запросов/с), повторяет запрос при 429/5xx, корректно обрабатывает пустые ответы (204).
Быстрый старт (Docker)
git clone https://github.com/otstoyotstoy/AmoCRM-MCP-for-GigaCowork.git amocrm-mcp && cd amocrm-mcp
cp .env.example .env
nano .env # AMOCRM_DOMAIN, AMOCRM_TOKEN, MCP_AUTH_TOKEN, PUBLIC_BASE_URL, MCP_DOMAIN
openssl rand -hex 32 # → значение для MCP_AUTH_TOKEN
# Вариант А: свой домен + автоматический HTTPS (Caddy, Let's Encrypt)
docker compose --profile https up -d --build
# Вариант Б: на сервере уже есть nginx — поднимаем только приложение на 127.0.0.1:8000
docker compose up -d --build # пример конфига nginx: deploy/nginx.confПроверка: curl https://mcp.example.ru/health → {"ok":true,"tools":48,...}.
Виртуальный хостинг (быстрый тест)
Подробно — в INSTALL.md, раздел 7. Коротко: создать поддомен с SSL, включить для него Python 3.12, затем в терминале хостинга:
git clone https://github.com/otstoyotstoy/AmoCRM-MCP-for-GigaCowork.git ~/amocrm-mcp
cd ~/amocrm-mcp && bash deploy/install_shared_hosting.sh mcp.company.ruТестовый запуск на виртуальном хостинге (Passenger WSGI: Рег.ру, Beget, Timeweb…)
Только для тестов: работает лишь /mcp (без SSE), ресурсы хостинга ограничены.
Проверено на Рег.ру (ispmanager 6):
Создайте поддомен (например
mcp.site.ru) с SSL Let's Encrypt. В его настройках → «Дополнительные возможности» включите CGI-скрипты и Python, версия 3.12.Код и настройки держите вне папки сайта, например
~/amocrm-mcp:/opt/python/python-3.12/bin/python3 -m venv ~/amocrm-mcp/venv && ~/amocrm-mcp/venv/bin/pip install -r requirements.txt, затем.env(из.env.example,chmod 600).В папке поддомена — только загрузчик
passenger_wsgi.py(без.htaccessиindex.html):import runpy application = runpy.run_path("/var/www/<логин>/data/amocrm-mcp/passenger_wsgi.py")["application"]Перезапуск после изменений:
touch <папка поддомена>/.restart-app.Проверка:
https://mcp.site.ru/health, подключение:https://mcp.site.ru/mcp.
Без Docker: python -m venv venv && venv/bin/pip install -r requirements.txt && venv/bin/python -m amocrm_mcp.server (юнит systemd: deploy/amocrm-mcp.service).
Related MCP server: amoCRM MCP Server
Подключение к ИИ-платформе
Параметр | Значение |
Тип | Удалённый MCP-сервер (Streamable HTTP) |
URL |
|
Заголовок |
|
Если заголовки задать нельзя |
|
Если платформа просит логин и пароль (GigaCowork) | логин |
Если платформа поддерживает только SSE |
|
Локально (Claude Desktop и т.п.):
{"mcpServers": {"amocrm": {"command": "python", "args": ["/path/amocrm-mcp/server.py", "stdio"],
"env": {"AMOCRM_DOMAIN": "mycompany", "AMOCRM_TOKEN": "..."}}}}Токен amoCRM
amoCRM → Настройки → Интеграции → «Создать интеграцию» → «Внешняя интеграция» → дать все права (доступ к данным аккаунта) → сохранить → вкладка «Ключи и доступы» → «Сгенерировать долгосрочный токен». Срок выбирается при выпуске; когда токен истечёт, сервер вернёт понятную ошибку 401.
Права в CRM совпадают с правами пользователя, который выпустил токен. Для полного доступа токен должен выпустить администратор.
Настройки
Переменная | Описание |
|
|
| Долгосрочный токен |
| Часовой пояс для дат (по умолчанию Europe/Moscow) |
| Токен(ы) доступа к серверу, через запятую. Обязателен для HTTP |
| Внешний адрес сервера, нужен для ссылок на выгрузки |
|
|
| Включить только нужные группы: |
| Запросов в секунду к amoCRM (по умолчанию 6) |
| Максимум записей в выгрузке/отчёте (по умолчанию 50 000) |
Инструменты (48)
Справочники: get_account_info, list_users, list_pipelines, list_custom_fields, list_loss_reasons, list_tags
Сделки: search_leads (фильтры по воронке, этапу, результату, ответственному, бюджету, датам, тегам, значениям полей; страницы / всё / файл) · get_lead · create_leads · create_leads_complex (сделка + новый контакт + компания) · update_leads · close_leads · bulk_update_leads (массовые изменения по фильтру с предпросмотром)
Контакты и компании: search_contacts, get_contact, create_contacts (с защитой от дублей), update_contacts, search_companies, get_company, create_companies, update_companies
Задачи: search_tasks (открытые / просроченные / выполненные), create_tasks, update_tasks, complete_tasks
Активность: get_notes, add_notes, update_note, get_events (история изменений), add_calls
Связи: get_links, link_entities, unlink_entities
Неразобранное: list_unsorted, process_unsorted (принять / отклонить), create_unsorted_forms
Покупатели и списки (товары): search_customers, save_customers, list_catalogs, search_catalog_elements, save_catalog_elements
Отчёты: leads_report (количество, суммы, конверсия по этапам / менеджерам / месяцам / тегам / причинам отказа), tasks_report (просрочки по менеджерам)
Настройка CRM: manage_pipeline, manage_status, manage_custom_field, create_tags
Всё остальное: amocrm_api_request — любой метод API v4 (вебхуки, источники, роли, чаты, файлы, транзакции…)
Ограничения amoCRM API
Сделки, контакты и компании нельзя удалить через API, только в интерфейсе. Вместо удаления:
close_leads, снять теги, отвязать, сменить ответственного.Удаление поддерживается для воронок, этапов, полей и заявок в «Неразобранном».
Фильтры по тегам и значениям полей amoCRM на сервере не поддерживает, поэтому MCP-сервер применяет их сам после загрузки записей. Сочетайте их с другими фильтрами (воронка, даты), чтобы загрузка шла быстрее.
Тесты
pip install -r requirements.txt pytest pytest-asyncio
pytest -q # сквозные тесты: HTTP-сервер + MCP-клиент + имитация amoCRMTool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Remote MCP for amoCRM and Kommo: leads, contacts, tasks, pipelines, chats, Salesbot. OAuth.
Remote MCP for Kommo CRM: leads, contacts, tasks, notes, pipelines, chats, Salesbot. OAuth.
AI agent platform: manage leads, conversations, bots, calendar and CRM via MCP.
API-first CRM for LLMs - contacts, companies, deals and activities over a native MCP server.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn MCP server that provides 36 tools for interacting with the amoCRM (Kommo) API v4, covering leads, contacts, companies, and tasks. It supports full entity lifecycles, account analytics, and bulk operations with integrated OAuth 2.0 and rate limiting.2MIT
- AlicenseNot gradedqualityDmaintenanceMCP server for amoCRM integration, enabling AI assistants to manage leads, contacts, companies, tasks, and more via natural language.4MIT
- FlicenseNot gradedqualityDmaintenanceAI-powered CRM assistant for Kommo/amoCRM that provides natural language management via Telegram bot and MCP protocol, enabling analytics, entity operations, and CRM setup.8-
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to interact with amoCRM, providing access to deals, contacts, companies, notes, tasks, and custom fields via natural language.MIT