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

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

HeyReach + Cursor

LinkedIn-аутрич HeyReach из любого AI-агента: управление кампаниями, добавление и остановка лидов, списки лидов и компаний и теги лидов, чтение диалогов в общем инбоксе LinkedIn и ответы на них, проверка аккаунтов отправителей и контактов первого уровня, сравнение статистики аутрича и управление вебхуками. Работает с API-ключом HeyReach; удаления отключены при установке.

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

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

HEYREACH_API_KEY

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

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

1. В HeyReach откройте Integrations и раздел HeyReach API.
2. Нажмите Get API Key, затем New API Key, и скопируйте ключ в HEYREACH_API_KEY. Ключи не истекают, но там же их можно удалить или отключить. Ключ относится к одному рабочему пространству.
3. Установите коннектор и запустите heyreach_check_api_key: если ключ работает, он отвечает 200 с пустым телом.

Ключ отправляется в заголовке X-API-KEY.

Id: campaign_id берётся из heyreach_list_campaigns; id отправителей (account_id, linkedin_account_id, sender_id) из heyreach_list_linkedin_accounts; list_id из heyreach_list_lists; conversation_id из heyreach_list_conversations; webhook_id из heyreach_list_webhooks. Лид определяется по URL профиля LinkedIn (https://www.linkedin.com/in/<slug>/) или по его LinkedIn id (linkedin_id в записях лидов).

Кампании:

• Чтение: heyreach_list_campaigns (фильтр по статусу или отправителю), heyreach_get_campaign, heyreach_get_campaign_sequence (дерево шагов: запрос на контакт, сообщение, InMail, подписка, лайк, просмотр профиля, с задержками и текстами), heyreach_list_campaign_leads и heyreach_get_campaigns_for_lead.
• Управление: heyreach_start_campaign запускает черновик с последовательностью, списком лидов и хотя бы одним подключённым отправителем LinkedIn; heyreach_pause_campaign и heyreach_resume_campaign ставят его на паузу и возобновляют.
• Лиды: heyreach_add_leads_to_campaign добавляет до 100 лидов за вызов, при желании закрепляя за каждым отправителя, и может тем же вызовом возобновить приостановленную кампанию. heyreach_stop_lead_in_campaign останавливает одного лида, heyreach_update_lead_custom_fields задаёт пользовательские поля, которые служат переменными в сообщениях.
• Статусы кампаний: DRAFT, IN_PROGRESS, PAUSED, FINISHED, CANCELED, FAILED, STARTING, SCHEDULED. Статусы лидов: Pending, InSequence, Finished, Paused, Failed, Excluded.

При запуске кампаний и добавлении лидов ваши аккаунты LinkedIn действуют на реальных профилях, поэтому попросите ИИ сначала показать кампанию, отправителя и лидов.

Списки: heyreach_list_lists, heyreach_get_list, heyreach_list_list_leads, heyreach_list_list_companies, heyreach_get_lists_for_lead, heyreach_create_list (пустой список лидов или компаний) и heyreach_add_leads_to_list (до 100 лидов за вызов). Список не кампания: завершённая кампания не подхватывает новых лидов из списка; для этого есть heyreach_add_leads_to_campaign.

Лиды и теги: heyreach_get_lead читает профиль по URL (имя, заголовок, компания, должность, местоположение, email, теги, опыт, образование). Также есть heyreach_get_lead_tags, heyreach_add_lead_tags (существующие теги сохраняются) и heyreach_replace_lead_tags.

Инбокс: heyreach_list_conversations показывает диалоги аккаунтов отправителей, сначала новые, с фильтрами по отправителю, кампании, лиду, тегам, статусу прочтения и времени. Email-адресов и пользовательских полей он не возвращает; они есть в heyreach_get_lead. heyreach_get_conversation возвращает все сообщения, heyreach_send_message отвечает от отправителя, которому принадлежит диалог, а heyreach_set_conversation_seen отмечает его прочитанным или непрочитанным. Отправленное сообщение сразу приходит лиду в LinkedIn, поэтому ИИ сначала показывает текст.

Отправители и сеть: heyreach_list_linkedin_accounts и heyreach_get_linkedin_account показывают лимиты, паузы, статус Sales Navigator и Recruiter; heyreach_get_linkedin_account_status сообщает, подключена ли ещё сессия LinkedIn и если нет, то почему. heyreach_list_network показывает контакты первого уровня отправителя, heyreach_is_connection проверяет одного лида (URL профиля или LinkedIn id, не оба сразу).

Статистика: heyreach_get_overall_stats и heyreach_get_stats_by_campaign принимают start_date и end_date (ISO 8601, например 2026-10-01T00:00:00.000Z) и необязательные id отправителей и кампаний. Они возвращают просмотры профиля, лайки, подписки, отправленные и принятые запросы на контакт, отправленные сообщения и InMail и ответы на них, с долями принятия и ответов.

Вебхуки: heyreach_list_webhooks, heyreach_get_webhook, heyreach_create_webhook и heyreach_update_webhook. Один тип события на вебхук: CONNECTION_REQUEST_SENT, CONNECTION_REQUEST_ACCEPTED, MESSAGE_SENT, MESSAGE_REPLY_RECEIVED, EVERY_MESSAGE_REPLY_RECEIVED, INMAIL_SENT, INMAIL_REPLY_RECEIVED, FOLLOW_SENT, LIKED_POST, VIEWED_PROFILE, CAMPAIGN_COMPLETED, LEAD_TAG_UPDATED.

Отключено при установке: heyreach_delete_leads_from_list и heyreach_delete_webhook. Их нельзя отменить, поэтому администратор рабочего пространства включает их, когда они нужны команде.

Форматы данных: время в ISO 8601, в UTC, если не указано смещение. В статистике byDayStats разбит по дням (UTC), доли указаны дробями (0.23 = 23%).

Постраничный вывод: большинство списков принимает offset и limit (максимум 100) и возвращает totalCount и items; heyreach_list_list_leads позволяет до 1000 на страницу, а heyreach_list_network использует page_size (максимум 100). heyreach_list_conversations работает с курсором (по умолчанию 10, максимум 100): ИИ передаёт nextCursor обратно как cursor, пока он не станет null.

Лимиты и частые ошибки: 300 запросов в минуту на ключ; сверх этого HeyReach отвечает 429. 401 означает неверный или отключённый ключ, 404 неверный id, 400 неверное тело запроса, например имя пользовательского поля с символами кроме букв, цифр и подчёркиваний.

Создание кампаний, подключение аккаунтов LinkedIn (пароли, cookies, прокси) и управление организацией намеренно не включены; это делается в приложении HeyReach.

Шаг 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. Начинай общаться: агент теперь может вызывать инструменты HeyReach.

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

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

• «Как прошёл наш LinkedIn-аутрич в прошлом месяце? Покажи отправленные и принятые запросы на контакт и долю ответов по кампаниям.»
• «Покажи непрочитанные диалоги LinkedIn за последние 3 дня с именем лида и последним сообщением.»
• «Добавь эти три профиля LinkedIn в кампанию Founders DACH и скажи, сколько добавилось.»
• «Есть ли сейчас отключённые аккаунты отправителей LinkedIn?»
• «В каких кампаниях участвует https://www.linkedin.com/in/jane-doe и какой у неё статус в каждой?»

FAQ

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

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

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