Cómo conectar HeyReach a Cursor vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → HeyReach, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

HeyReach + Cursor

Prospección en LinkedIn con HeyReach desde cualquier agente de IA: gestiona campañas y añade o detén sus leads, mantén listas de leads y empresas y las etiquetas de los leads, lee y contesta conversaciones en la bandeja unificada de LinkedIn, revisa cuentas remitentes y contactos de primer grado, compara estadísticas de prospección y gestiona webhooks. Funciona con una clave API de HeyReach; los borrados vienen desactivados.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

HEYREACH_API_KEY

Paso 1 — Obtener credenciales

La configuración lleva unos 2 minutos. Necesitas un workspace de HeyReach.

1. En HeyReach abre Integrations y la sección HeyReach API.
2. Haz clic en Get API Key, luego en New API Key, y copia la clave en HEYREACH_API_KEY. Las claves no caducan, pero allí se pueden borrar o desactivar. Una clave pertenece a un solo workspace.
3. Instala el conector y ejecuta heyreach_check_api_key: responde 200 con el cuerpo vacío si la clave funciona.

La clave se envía en la cabecera X-API-KEY.

Ids: campaign_id sale de heyreach_list_campaigns; los ids de remitente (account_id, linkedin_account_id, sender_id) de heyreach_list_linkedin_accounts; list_id de heyreach_list_lists; conversation_id de heyreach_list_conversations; webhook_id de heyreach_list_webhooks. Un lead se identifica por la URL de su perfil de LinkedIn (https://www.linkedin.com/in/<slug>/) o por su id de LinkedIn (linkedin_id en los registros de leads).

Campañas:

• Lectura: heyreach_list_campaigns (filtro por estado o remitente), heyreach_get_campaign, heyreach_get_campaign_sequence (el árbol de pasos: solicitud de conexión, mensaje, InMail, seguir, me gusta, visita al perfil, con esperas y textos), heyreach_list_campaign_leads y heyreach_get_campaigns_for_lead.
• Control: heyreach_start_campaign inicia un borrador que tiene secuencia, lista de leads y al menos un remitente de LinkedIn conectado; heyreach_pause_campaign y heyreach_resume_campaign la detienen y la reanudan.
• Leads: heyreach_add_leads_to_campaign añade hasta 100 leads por llamada, opcionalmente fijando un remitente para cada uno, y puede reanudar una campaña en pausa en la misma llamada. heyreach_stop_lead_in_campaign detiene un lead y heyreach_update_lead_custom_fields pone campos personalizados que se usan como variables en los mensajes.
• Estados de campaña: DRAFT, IN_PROGRESS, PAUSED, FINISHED, CANCELED, FAILED, STARTING, SCHEDULED. Estados de lead: Pending, InSequence, Finished, Paused, Failed, Excluded.

Al iniciar campañas y añadir leads tus cuentas de LinkedIn actúan sobre perfiles reales, así que pide a la IA que te muestre antes campaña, remitente y leads.

Listas: heyreach_list_lists, heyreach_get_list, heyreach_list_list_leads, heyreach_list_list_companies, heyreach_get_lists_for_lead, heyreach_create_list (lista vacía de leads o de empresas) y heyreach_add_leads_to_list (hasta 100 leads por llamada). Una lista no es una campaña: una campaña terminada no recoge los leads nuevos de la lista; para eso está heyreach_add_leads_to_campaign.

Leads y etiquetas: heyreach_get_lead lee un perfil por URL (nombre, titular, empresa, cargo, ubicación, email, etiquetas, experiencia, formación). Además heyreach_get_lead_tags, heyreach_add_lead_tags (conserva las etiquetas existentes) y heyreach_replace_lead_tags.

Bandeja: heyreach_list_conversations lista las conversaciones de las cuentas remitentes, de la más reciente a la más antigua, filtradas por remitente, campaña, lead, etiquetas, estado de lectura y periodo. No devuelve emails ni campos personalizados; esos los da heyreach_get_lead. heyreach_get_conversation devuelve todos los mensajes, heyreach_send_message responde desde el remitente al que pertenece la conversación y heyreach_set_conversation_seen la marca como leída o no leída. Un mensaje enviado llega al lead en LinkedIn al momento, así que la IA te enseña antes el texto.

Remitentes y red: heyreach_list_linkedin_accounts y heyreach_get_linkedin_account muestran límites, periodos de enfriamiento y estado de Sales Navigator y Recruiter; heyreach_get_linkedin_account_status indica si la sesión de LinkedIn sigue conectada y, si no, por qué. heyreach_list_network lista los contactos de primer grado de un remitente y heyreach_is_connection comprueba un lead (URL del perfil o id de LinkedIn, no ambos).

Estadísticas: heyreach_get_overall_stats y heyreach_get_stats_by_campaign aceptan start_date y end_date (ISO 8601, por ejemplo 2026-10-01T00:00:00.000Z) e ids opcionales de remitentes y campañas. Devuelven visitas al perfil, me gusta, seguimientos, solicitudes de conexión enviadas y aceptadas, mensajes e InMails enviados y respondidos, con tasas de aceptación y de respuesta.

Webhooks: heyreach_list_webhooks, heyreach_get_webhook, heyreach_create_webhook y heyreach_update_webhook. Un tipo de evento por 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.

Desactivadas al instalar: heyreach_delete_leads_from_list y heyreach_delete_webhook. No se pueden deshacer, así que un admin del workspace las activa cuando el equipo las necesite.

Formatos de datos: las horas son ISO 8601, en UTC salvo que se indique un desfase. En las estadísticas byDayStats va por día (UTC) y las tasas son fracciones (0.23 = 23 %).

Paginación: la mayoría de los listados aceptan offset y limit (como máximo 100) y devuelven totalCount e items; heyreach_list_list_leads permite hasta 1000 por página y heyreach_list_network usa page_size (como máximo 100). heyreach_list_conversations pagina con cursor (10 por defecto, como máximo 100): la IA devuelve nextCursor como cursor hasta que es null.

Límites y errores habituales: 300 peticiones por minuto y clave; por encima HeyReach responde 429. 401 indica una clave errónea o desactivada, 404 un id erróneo, 400 un cuerpo no válido, por ejemplo un nombre de campo personalizado con caracteres distintos de letras, dígitos y guiones bajos.

Crear campañas, conectar cuentas de LinkedIn (contraseñas, cookies, proxies) y la gestión de la organización quedan fuera a propósito; eso se hace en la app de HeyReach.

Paso 2 — Instalar el adapter

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

Paso 3 — Añadir el conector en Cursor

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Cursor lee los servidores MCP de ~/.cursor/mcp.json. Añade esta entrada:

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

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia Cursor.
3. Abre Cursor → Settings → MCP y comprueba que anythingmcp aparece en la lista y está conectado.
4. Empieza a chatear: el agente ya puede usar las herramientas de HeyReach.

Herramientas disponibles

Ejemplos de prompts

• "¿Qué tal fue nuestra prospección en LinkedIn el mes pasado? Muestra solicitudes de conexión enviadas y aceptadas y la tasa de respuesta por campaña."
• "Muéstrame las conversaciones de LinkedIn sin leer de los últimos 3 días con el nombre del lead y el último mensaje."
• "Añade estos tres perfiles de LinkedIn a la campaña Founders DACH y dime cuántos se han añadido."
• "¿Alguna de nuestras cuentas remitentes de LinkedIn está desconectada ahora mismo?"
• "¿En qué campañas está https://www.linkedin.com/in/jane-doe y qué estado tiene en cada una?"

FAQ

¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Gemini
• Conectar a Meta Muse
• Conectar a Microsoft Copilot