Как подключить Ringostat к Claude через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Ringostat, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

Ringostat + Claude

Коллтрекинг и виртуальная АТС Ringostat: журнал звонков с источниками трафика, длительностью, статусом, сотрудниками и ссылками на записи, кто онлайн или на линии, сотрудники с отделами, ежедневный отчёт SIP-онлайн и статусы Smart Phone. Обратный звонок при установке отключён.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

RINGOSTAT_AUTH_KEY, RINGOSTAT_PROJECT_ID

Шаг 1 — Получите учётные данные

Настройка занимает около 2 минут и требует администратора проекта в Ringostat.

1. В Ringostat откройте Settings, Integrations, Ringostat API и скопируйте Auth-key в RINGOSTAT_AUTH_KEY. Ключ относится к одному проекту и передаётся в заголовке Auth-key.
2. Укажите в RINGOSTAT_PROJECT_ID номер этого проекта: значение после project_id= или projectId= в адресной строке веб-приложения Ringostat, например 39071. Его используют только инструменты сотрудников, SIP-отчёта и пользовательских статусов.
3. Установите коннектор; проверка выполняет ringostat_list_online_sip.

Что он читает: журнал звонков за период, одна строка на звонок с нужными вам столбцами: дата, номер звонящего и вызываемый номер, тип звонка, статус (disposition), длительность разговора, общая длительность и время ожидания, имя и отдел сотрудника, пул номеров и схема переадресации, отметки целевого и повторного звонка, UTM source, medium, campaign, content и term, посадочная страница и реферер, причина пропуска звонка, оценка CSAT, id звонка и ссылка на запись; SIP-аккаунты, которые сейчас онлайн, и те, что сейчас на линии; сотрудники с SIP-статусом, полным именем, e-mail, внутренним номером, staffId, отделами и направлениями звонков (основные и резервные SIP-аккаунты или номера телефонов); время онлайн и офлайн по каждому сотруднику и дню; и пользовательские статусы Smart Phone, например Обед или Совещание.

Журнал звонков: ringostat_list_calls принимает from и to в формате YYYY-MM-DD HH:MM:SS; без них возвращает последние 24 часа. Ответ представляет собой один массив со всеми звонками периода, без постраничной разбивки, поэтому в загруженных проектах ИИ берёт короткие периоды (день или неделю) и запрашивает только нужные fields. Длительность разговора хранится в billsec в секундах; call_type принимает значения in, out, callback, transitin или transitout; proper_flag и repeated_flag отмечают целевые и повторные звонки. Для статистики по сотрудникам ИИ группирует строки по employee_fio и суммирует billsec.

Фильтры и сортировка: фильтры задаются выражениями Ringostat через запятую, например call_type=in,billsec>=30, с операторами =, <>, >, <, >=, <= или ~ (регулярное выражение в base64). order задаёт сортировку, например calldate desc; merge объединяет звонки по номеру звонящего за день (1) или за весь период (2).

Персональные данные: номера телефонов и ссылки на записи являются персональными данными. Ссылки на записи в recording и recording_wav доступны в течение года.

Отключено при установке: ringostat_start_callback запускает настоящий звонок, соединяющий номер проекта с номером телефона или SIP-логином сотрудника. Он набирает сразу и расходует минуты, поэтому администратор включает его осознанно. Даже тогда ИИ показывает вам оба номера и ждёт вашего согласия. Номера указываются в международном формате без +.

POST-вызовы только для чтения: список сотрудников, SIP-отчёт и пользовательские статусы в API Ringostat являются POST-запросами, но только читают данные.

Частые ошибки: 401 или 403 означают отсутствующий или неверный Auth-key либо ключ и id проекта из разных проектов. Ошибка JSON-RPC от инструментов сотрудников, отчёта или статусов обычно означает неверный RINGOSTAT_PROJECT_ID; "User does not exist" значит, что фильтр по сотрудникам никого не нашёл.

Коннектор не меняет настройки АТС, сотрудников, пулы номеров и схемы переадресации и возвращает ссылки на записи, а не сам звук.

Шаг 2 — Установите адаптер

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Шаг 3 — Добавьте коннектор в Claude

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Рекомендуемый путь: работает в claude.ai web без редактирования конфигурационных файлов.

1. Открой в Claude Customize → Connectors.
2. Нажми +, затем Add custom connector.
3. Введи название, например Ringostat, и URL удалённого MCP-сервера https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, затем нажми Add.
4. Нажми Connect и войди в AnythingMCP (OAuth), чтобы разрешить доступ.

Все инструменты ниже появятся в чате: начинайте писать промпты.

Доступные инструменты

Примеры запросов

• «Сколько входящих звонков было вчера, сколько из них пропущено и какова средняя длительность разговора?»
• «Сгруппируй звонки прошлой недели по сотрудникам с числом звонков и общей длительностью разговоров.»
• «Какие UTM-источники и кампании принесли целевые звонки в этом месяце?»
• «Кто сейчас онлайн и кто из них разговаривает?»
• «Сколько времени каждый сотрудник был онлайн по дням на прошлой неделе?»

FAQ

Работает ли с Claude Code так же как с Claude Desktop? Да, оба указывайте на https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.

Следующие шаги

• Страница коннектора
• Подключить к ChatGPT
• Подключить к Cursor
• Подключить к Gemini
• Подключить к Meta Muse
• Подключить к Microsoft Copilot