MCP de HeyReach en Claude: las 25 herramientas, los 4 límites y el detalle que duplica mensajes
El MCP de HeyReach convierte a Claude en operador de tu prospección: pausa campañas, etiqueta leads y carga listas sin que abras la herramienta. Documentamos las 25 herramientas agrupadas por capacidad, los cuatro límites que no figuran en el pitch, y el desfase de consistencia que puede hacerte escribir dos veces al mismo lead.
Pedile a Claude que pause una campaña de LinkedIn porque la tasa de aceptación se cayó, y lo va a hacer. Sin abrir HeyReach, sin buscar el botón, sin exportar un CSV. Eso ya funciona hoy y es una diferencia real respecto de cualquier integración anterior: no es Claude leyendo un reporte que le pegaste, es Claude operando adentro de la herramienta.
Venimos usando el MCP de HeyReach en cuentas de clientes desde hace unos meses. Esta nota es lo que aprendimos: qué se puede hacer de verdad, dónde están los límites que no figuran en la documentación de marketing, y un detalle de consistencia que si no lo conocés te puede hacer enviar el mismo mensaje dos veces al mismo lead.
Qué es un MCP y por qué cambia el trabajo del SDR
MCP (Model Context Protocol) es un estándar que le permite a un modelo conectarse a una herramienta y ejecutar acciones, no solo recibir texto. La distinción importa más de lo que parece.
Sin MCP, el flujo era: exportás un CSV de HeyReach, se lo pegás a Claude, Claude te devuelve un análisis, vos volvés a HeyReach y ejecutás a mano. Cuatro pasos, tres de ellos manuales, y el análisis envejece en el momento en que lo pegás.
Con MCP, Claude consulta el estado en vivo y actúa sobre él. La conversación pasa a ser: "revisá las campañas activas, encontrá las que tengan menos de 20% de aceptación y pausalas". Un paso.
Las 25 herramientas, ordenadas por lo que te habilitan
El MCP de HeyReach expone 25 herramientas. Listarlas alfabéticamente no sirve de nada; agrupadas por capacidad operativa, sí:
- Lectura de campañas: listar campañas, traer una por ID con sus estadísticas de progreso, sacar los leads de una campaña con filtro por estado, y ver en qué campañas está un lead determinado.
- Control de campañas: pausar una campaña en curso, reanudarla desde donde quedó, y detener a un lead puntual para que no reciba más pasos de la secuencia.
- Carga de leads: sumar hasta 100 leads a una campaña, importar hasta 100 a una lista existente, crear listas nuevas vacías, y borrar leads de una lista por URL de perfil o por ID.
- Etiquetado: agregar tags a un lead sin borrar los que ya tiene, leer sus tags actuales, o reemplazar el set completo.
- Cuentas y métricas: listar las cuentas de LinkedIn conectadas, ver el detalle de una (incluida la validez de su autenticación) y traer estadísticas de alcance por cuenta y rango de fechas.
- Enriquecimiento: buscar un lead por URL de perfil y recibir su perfil completo con el email enriquecido.
Los cuatro límites que conviene saber antes de empezar
Ninguno de estos aparece en el pitch. Todos aparecen cuando el flujo se rompe en producción.
- 300/min — Rate limit: Requests por minuto para toda la organización, no por usuario. Un agente en loop lo agota solo.
- 100 — Carga masiva: Máximo de leads por request. Una lista de 1.000 son 10 llamadas encadenadas.
- bloqueante — Estado DRAFT: No se pueden agregar leads a una campaña en borrador. Hay que iniciarla o pausarla primero.
- estricto — Tipo de lista: Leer leads exige USER_LIST; leer empresas exige COMPANY_LIST. Cruzarlos falla.
El de los 300 requests por minuto es el que más sorprende, porque es a nivel organización. Si tenés un agente paginando leads de una campaña grande mientras otro consulta estadísticas, se pisan entre ellos y empezás a comer HTTP 429.
Replace Tags es destructivo: Hay dos herramientas de etiquetado que suenan parecido y hacen cosas opuestas: una agrega tags conservando los existentes, la otra sobrescribe el set completo. Si un agente elige la segunda por error, se pierde toda la clasificación previa del lead y no hay deshacer. Cuando definas el prompt de tu agente, nombrá la herramienta explícitamente en vez de dejar que la elija por semántica.
Lo que el MCP puede y la API REST no
Acá está el hallazgo menos obvio y el que más nos cambió la arquitectura. La intuición dice que el MCP es un envoltorio cómodo sobre la API REST, y que si sabés programar te conviene ir directo a la API. No es exacto.
En nuestras implementaciones terminamos usando los dos en paralelo, y no por comodidad: la API REST pública de HeyReach no permite crear tags. El MCP sí. Así que el flujo real quedó partido — la mayoría de las operaciones van por REST con la API key, y el etiquetado va por MCP, porque es el único camino.
La conclusión práctica: antes de decidir "usamos API porque somos técnicos", revisá herramienta por herramienta. La superficie de los dos no es la misma y la diferencia no está documentada en un lugar único.
El detalle que puede duplicar tus mensajes
Este es el que más caro sale y el que motivó esta nota.
Cuando enviás un mensaje a través del MCP, la API REST no lo refleja de inmediato. Hay una ventana en la que el mensaje ya salió pero si consultás el historial del lead todavía no aparece. Si tu proceso decide a quién escribirle basándose en "¿ya le mandamos algo?", en esa ventana la respuesta va a ser "no" cuando en realidad es "sí".
El resultado es un doble envío al mismo lead. En prospección B2B eso no es un detalle estético: es la diferencia entre parecer una persona y parecer un bot roto, con el lead quemado y la cuenta de LinkedIn un poco más cerca de una restricción.
Lo resolvimos con verificación en tres capas antes de cada envío: el historial en vivo del lead, un registro local de lo ya enviado en la corrida actual, y una lista explícita de los que se saltearon a propósito. Si cualquiera de las tres dice que ya se le escribió, no se envía. Es más código del que parecía necesario, y es el que evita el problema.
La regla que aplicamos siempre: Antes de reportar una pérdida de datos o una corrupción, verificar contra la fuente autoritativa. Un error en stderr no significa que el mensaje no salió — puede haber salido y haber fallado el registro. Asumir lo contrario es lo que genera el reenvío.
Qué automatizar primero
Si recién lo conectás, estos son los tres flujos que dan retorno rápido sin riesgo de romper nada, en orden:
- Diagnóstico en lenguaje natural. "¿Cuáles de mis campañas activas tienen peor aceptación este mes?" Es solo lectura, no puede hacer daño, y reemplaza veinte minutos de clicks por una pregunta.
- Etiquetado por criterio. Clasificar respuestas y aplicar tags según el contenido del hilo. Acá el MCP es el único camino, y es donde más tiempo manual se recupera.
- Pausa automática por umbral. Un agente que mira la tasa de aceptación y pausa antes de que la cuenta se exponga. Es el que protege el activo más frágil de toda la operación: el perfil de LinkedIn.
Lo que dejaría para el final es el envío automático de mensajes sin revisión humana. No por la tecnología, que funciona, sino por lo del punto anterior: el margen de error tiene consecuencias en la reputación de la cuenta, y conviene tener el circuito de verificación probado antes de sacar a la persona del medio.
La conclusión, sin humo
El MCP de HeyReach es la primera integración que convierte a Claude en operador y no en analista. Eso es genuinamente nuevo y vale la pena adoptarlo.
Pero un agente con permiso de escritura sobre tu operación de prospección necesita las mismas defensas que cualquier proceso que toca producción: idempotencia, verificación contra la fuente de verdad, y límites explícitos sobre qué herramientas puede usar. Lo que se automatiza mal no se automatiza más rápido, se rompe más rápido.
En MAMBO operamos prospección B2B con este stack todos los días, para nuestros clientes y para nosotros. Si estás evaluando conectar tu operación de LinkedIn a un agente y querés que alguien te cuente dónde están los pozos antes de caerte en uno, escribinos.