Cómo conectar RocketReach a Gemini vía MCP

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

RocketReach + Gemini

Da a tu IA los datos B2B de RocketReach: busca personas y empresas por nombre, cargo, empresa, ubicación, sector y tamaño, revisa tus créditos y consulta correos, teléfonos y perfiles de empresa solo de los registros que elijas.

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:

ROCKETREACH_API_KEY

Paso 1 — Obtener credenciales

1. Inicia sesión en https://rocketreach.co con una cuenta que tenga acceso a la API (un plan de API o un plan que incluya llamadas a la API).
2. Abre Account Settings → API en https://rocketreach.co/account?section=nav_gen_api y elige Generate New API Key, o copia la clave existente.
3. Pégala en ROCKETREACH_API_KEY e instala el conector. La clave se envía en la cabecera Api-Key y solo a RocketReach.
4. Comprueba la configuración con rocketreach_get_account: muestra tus créditos por tipo y tus límites de uso, sin gastar créditos.

Gratis: búsqueda: rocketreach_search_people, rocketreach_search_companies, rocketreach_get_account y rocketreach_check_lookup_status no gastan créditos; las búsquedas solo cuentan para los límites de búsqueda. Los resultados no traen correos ni teléfonos, solo un teaser (dominios de correo y teléfonos enmascarados) que indica si una consulta encontrará algo.

Las consultas cuestan créditos, así que la IA pregunta antes: rocketreach_lookup_person gasta un crédito de lookup y un crédito de person export cuando encuentra datos de contacto (un lookup premium si encuentra un correo de la mejor calidad o un teléfono válido, uno estándar si solo encuentra un correo). Sin datos, sin coste, y volver a consultar a la misma persona más adelante es gratis mientras tu plan esté activo. rocketreach_lookup_company gasta un crédito de company export; las consultas de empresas no están en todos los planes. Ambas añaden el registro a My Contacts o My Companies en RocketReach. Antes de una consulta, la IA te muestra a quién o qué va a consultar y que cuesta créditos, y espera tu sí.

Cómo funciona: la IA busca con facetas como cargo actual, empresa, ubicación, sector, tamaño y facturación de la empresa (por ejemplo {"current_title": ["CFO"], "geo": ["Spain"]}), te enseña las coincidencias y consulta solo a las personas que eliges, por id de RocketReach, URL de LinkedIn, correo, o nombre más empresa actual. La consulta de una persona suele tardar unos segundos: la IA comprueba el estado gratis hasta que termina. La consulta de una empresa devuelve el perfil completo: dominio, dirección, teléfono, número de empleados, facturación, sector, códigos SIC y NAICS, tecnologías, competidores, plantilla por departamento y crecimiento.

Datos personales, solo para uso B2B: las consultas de personas devuelven correos de trabajo y personales y teléfonos de personas reales. Úsalos solo para un fin empresarial legítimo que puedas justificar, como ventas B2B o selección de personal por interés legítimo, conforme al RGPD, la CAN-SPAM y las condiciones de RocketReach. Para contactos comerciales prefiere los correos profesionales, guarda solo lo necesario, no crees listas de envío masivo y no busques a particulares. El conector da a la IA las mismas reglas.

Páginas y límites de uso: una página tiene hasta 100 registros y una búsqueda llega como máximo a 10.000. RocketReach permite 10 solicitudes por segundo en toda la API, más topes por minuto, hora, día y mes para búsquedas y consultas según el plan. Un 429 indica la espera en Retry-After.

Errores comunes: 401: la clave de API es incorrecta o falta. 403: la clave no tiene permiso para esta llamada, se agotaron los créditos de lookup, el plan no incluye consultas de empresas, o una comprobación de estado pidió un perfil que no está en tus contactos. 400: un parámetro o una faceta no válidos. 404: no existe ese perfil o esa empresa.

Universal Credits: RocketReach está pasando a algunos clientes a Universal Credits, que usan endpoints distintos. Este conector usa los endpoints estándar; si las llamadas fallan en una cuenta con Universal Credits, pregunta a RocketReach qué endpoints puede usar tu cuenta.

El conector no hace consultas masivas, consultas combinadas de persona y empresa, verificación de correos, webhooks ni rotación de claves de API.

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 Gemini

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.

Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "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 gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de RocketReach.

Herramientas disponibles

Ejemplos de prompts

• "¿Cuántos créditos de lookup nos quedan en RocketReach?"
• "Busca directores financieros de empresas de logística en España con 201 a 500 empleados. Muestra nombres, cargos, empresas y el teaser, sin consultas todavía."
• "Consulta los datos de contacto de las dos primeras personas de esa lista. Dime cuánto cuesta antes de hacerlo."
• "¿Qué fabricantes de maquinaria del País Vasco tienen entre 51 y 200 empleados?"
• "Trae el perfil completo de northwind-logistics.com: empleados, facturación, tecnologías y competidores. Pregúntame antes de gastar el crédito."

FAQ

¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT