# 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](https://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](https://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 собери список всех воронок с их этапами. Ничего не анализируй, просто выведи структуру таблицей.
```