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

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

Aircall + Cursor

Дайте ИИ работать с Aircall: находить звонки, записи и голосовые сообщения, читать ИИ-расшифровки, сводки и тональность, видеть, кто свободен, добавлять заметки и теги к звонкам, управлять общими контактами и начинать звонки из Aircall Workspace оператора.

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

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

AIRCALL_API_ID, AIRCALL_API_TOKEN

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

1. Войдите в Aircall Dashboard по адресу https://dashboard.aircall.io как администратор.
2. Откройте Integrations & API → API Keys и нажмите Generate an API key (в старых версиях: Company settings → API Keys). Дайте ключу имя.
3. Скопируйте API ID в AIRCALL_API_ID, а API token в AIRCALL_API_TOKEN и установите коннектор. Aircall показывает токен только один раз; если он потерян, создайте новый ключ.
4. Проверьте настройку с помощью aircall_ping, а затем aircall_get_company: он показывает название компании и количество пользователей и номеров.

Кто что видит: ключ действует от имени всей компании в Aircall, со всеми звонками, записями и общими контактами. Делитесь MCP-сервером только с теми, кому разрешено всё это видеть. Звонки, контакты, записи, голосовые сообщения, расшифровки и ИИ-сводки являются персональными данными звонящих и операторов, поэтому ИИ читает только то, о чём вы просите. Ссылки на записи и голосовые сообщения может воспроизвести любой, у кого они есть (прямые ссылки действуют 1 час, короткие 3 часа).

Звонит реальный телефон, поэтому ИИ сначала спрашивает: aircall_start_outbound_call сразу начинает звонок из Aircall Workspace (настольного приложения) оператора, а исходящие минуты могут стоить денег. ИИ показывает, кто, кому и с какой линии звонит, и ждёт вашего «да». Оператор должен быть в сети, свободен, не занят другим звонком и привязан к номеру. aircall_dial_number только вводит номер в набиратель оператора, а звонок начинает сам оператор.

Изменения, которые видят ваши операторы, тоже только после вашего «да»: aircall_comment_call добавляет к звонку заметку (не больше пяти на звонок; заметки нельзя изменить или удалить), aircall_tag_call ставит существующие теги из aircall_list_tags, aircall_archive_call помечает звонок как архивный, а aircall_create_contact и aircall_update_contact создают или меняют общие контакты. Перед созданием контакта ИИ проверяет его через aircall_search_contacts, потому что одни и те же данные, отправленные дважды, создают дубликат.

Отключено при установке: aircall_delete_contact, который удаляет общий контакт для всей компании без возможности восстановления. Администратор включает его осознанно; после этого ИИ показывает контакт и удаляет его только после вашего подтверждения.

Для ИИ-расшифровок и сводок нужно дополнение Aircall AI (AI Assist или AI Assist Pro): aircall_get_call_transcription, aircall_get_call_summary, aircall_get_call_sentiments, aircall_get_call_topics и aircall_get_call_action_items работают с завершёнными звонками. Без дополнения они отвечают 403 или 404, а 404 может также означать, что у звонка нет расшифровки.

Как работать: aircall_list_calls показывает звонки за период, aircall_search_calls фильтрует по направлению, пользователю, номеру телефона или тегу, а aircall_get_call читает один звонок со ссылками на запись и голосовое сообщение. Время указывается как UNIX-метка в секундах; доступны только последние шесть месяцев, не больше 10 000 звонков на запрос, поэтому ИИ сужает период. Кто свободен прямо сейчас: aircall_list_user_availabilities. Линии и команды: aircall_list_numbers и aircall_list_teams. Контакты здесь только общие контакты Aircall, без синхронизированных из CRM.

Лимит запросов: Aircall допускает 120 запросов в минуту на всю компанию, и этот лимит делят все интеграции, использующие её ключи. Ответ 429 означает, что нужно дождаться конца минуты.

Частые ошибки: 403 у всех инструментов: API ID или токен неверны, перепутаны местами или ключ удалён. 404: звонка нет или он старше шести месяцев, либо для него нет ИИ-анализа. 405 при запуске или наборе звонка: оператор недоступен, разговаривает или не привязан к номеру. 400 при добавлении заметки: у звонка уже пять заметок.

Коннектор не охватывает SMS и сообщения WhatsApp, перевод текущих звонков, приостановку и удаление записей, исходящие кампании, а также управление пользователями, командами, номерами, тегами и вебхуками (aircall_list_webhooks только читает их).

Шаг 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 — Добавьте коннектор в Cursor

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

Cursor читает MCP-серверы из ~/.cursor/mcp.json. Добавь эту запись:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
2. Сохрани файл и перезапусти Cursor.
3. Открой Cursor → Settings → MCP и проверь, что anythingmcp есть в списке и подключён.
4. Начинай общаться: агент теперь может вызывать инструменты Aircall.

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

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

• «Какие звонки мы пропустили вчера после обеда на линии поддержки? Сгруппируй их по номеру звонившего и скажи, кому мы уже перезвонили.»
• «Найди мой последний звонок с +4930123456 и дай ИИ-сводку, тональность клиента и список задач.»
• «Кто из отдела продаж сейчас свободен, а кто разговаривает?»
• «Поставь тег Жалоба на вчерашние звонки с +4930123456 и добавь заметку, что возврат одобрен. Покажи звонки и заметку, прежде чем что-то менять.»
• «Начни звонок на +4930123456 из Workspace Анны с нашей берлинской линии. Спроси меня, прежде чем телефон зазвонит.»

FAQ

Поддерживает ли Cursor собственные MCP-серверы на бесплатном тарифе? Да, MCP доступен на тарифах Hobby, Pro и Business.

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

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT