amoCRM MCP-сервер

Этот сервер даёт Claude Code доступ к данным amoCRM (воронки, сделки, контакты, пользователи) через протокол MCP. Инструкция по развёртыванию — на русском, ниже.

Что внутри

• server.js — сам сервер (Node.js). Инструменты, которые он даёт Claude: list_pipelines, list_leads, get_lead, list_contacts, list_users, list_custom_fields, amocrm_raw_request (запасной вариант для любых других запросов к API amoCRM v4).

• render.yaml — описание для автоматического развёртывания на Render.

Шаг 1. Получите токен amoCRM

1. Зайдите в amoCRM под своим аккаунтом (вы администратор).

2. Откройте Настройки → Интеграции.

3. Нажмите Создать интеграцию, укажите любое название (например, «Claude MCP»). В поле redirect_uri можно указать любую ссылку-заглушку, например https://example.com.

4. Сохраните и откройте карточку созданной интеграции.

5. В блоке «Ключи и коды доступа» нажмите кнопку генерации долгосрочного токена.

6. Скопируйте показанную строку токена сразу — второй раз посмотреть её через интерфейс будет нельзя (при необходимости придётся сгенерировать новую, старая перестанет работать).

7. Запомните также ваш поддомен amoCRM — это часть адреса, под которым вы входите. Если вы заходите по адресу https://mycompany.amocrm.ru, то поддомен — mycompany.

Шаг 2. Загрузите код на GitHub

1. Если у вас нет аккаунта — зарегистрируйтесь на github.com (бесплатно).

2. Нажмите New repository (зелёная кнопка), укажите имя, например amocrm-mcp, оставьте Public, ничего дополнительно не отмечайте, нажмите Create repository.

3. На следующей странице нажмите ссылку uploading an existing file.

4. Разархивируйте скачанный архив с этим проектом (двойной клик по .zip на Mac) и перетащите все файлы из папки (включая render.yaml, package.json, server.js, .gitignore) в область загрузки на странице GitHub.

5. Нажмите Commit changes.

Шаг 3. Разверните на Render

1. Зарегистрируйтесь на render.com — проще всего войти через тот же аккаунт GitHub.

2. Нажмите New + → Blueprint.

3. Выберите репозиторий amocrm-mcp, который вы только что создали. Render сам найдёт файл render.yaml и предложит создать сервис.

4. Render попросит заполнить три значения:

   • AMOCRM_SUBDOMAIN — ваш поддомен (например, mycompany)

   • AMOCRM_TOKEN — долгосрочный токен из Шага 1

   • MCP_AUTH_TOKEN — придумайте свой секретный код (пароль), которым Claude будет представляться серверу. Можно использовать, например: 53485f651af67ac24031ce959a655e0321ec3a1cda1319ac (это случайно сгенерированная строка; используйте именно её, либо придумайте свою — главное, никому её не показывайте).

5. Нажмите Apply / Deploy. Развёртывание займёт пару минут.

6. Когда статус станет Live, скопируйте адрес сервиса вверху страницы — он выглядит как https://amocrm-mcp-xxxx.onrender.com.

Важно: бесплатный план Render «засыпает» после 15 минут без запросов и просыпается около 30–60 секунд при первом обращении. Если первый запрос от Claude покажется зависшим — просто подождите немного и повторите.

Шаг 4. Подключите к Claude Code

В терминале (там же, где установлен claude), выйдя из активной сессии (/exit), выполните, подставив свой адрес с Шага 3 и свой MCP_AUTH_TOKEN с Шага 3:

claude mcp add --transport http amocrm https://amocrm-mcp-xxxx.onrender.com/mcp --header "Authorization: Bearer ВАШ_MCP_AUTH_TOKEN"

Запустите claude, затем в чате наберите /mcp и убедитесь, что сервер amocrm имеет статус connected.

Первый запрос делайте разведочным:

Через MCP amoCRM собери список всех воронок с их этапами. Ничего не анализируй, просто выведи структуру таблицей.