Cómo conectar Lusha a Microsoft Copilot vía MCP

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

Lusha + Microsoft Copilot

Da a tu IA los datos B2B de Lusha: encuentra contactos y empresas por nombre, correo, URL de LinkedIn o dominio, prospecta por cargo, nivel, sector, tamaño y ubicación, revisa tus créditos y revela correos, teléfonos y datos de empresa solo de los registros que elijas. También lee señales de cambios de empleo y de empresas.

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:

LUSHA_API_KEY

Paso 1 — Obtener credenciales

1. Inicia sesión en Lusha con una cuenta que tenga acceso a la API. Solo los administradores de la cuenta y los managers con acceso a la API ven la página de API.
2. Abre API → Manage API Keys en https://dashboard.lusha.com/api/manage-api-keys y crea o copia una clave.
3. Pégala en LUSHA_API_KEY e instala el conector. La clave se envía en la cabecera api_key y solo a Lusha.
4. Comprueba la configuración con lusha_get_account_usage: muestra los créditos que quedan y el precio de cada acción, sin gastar créditos.

Las llamadas que devuelven registros cuestan créditos, así que la IA pregunta antes: la API v3 de Lusha cobra del saldo de créditos de tu cuenta cada llamada que devuelve datos, búsquedas incluidas. Los precios dependen de tu plan, y lusha_get_account_usage los muestra por acción (búsqueda, reveal de empresa, correo, teléfono, etc.).

• Gratis: lusha_get_account_usage (como máximo 5 llamadas por minuto), lusha_list_filters, lusha_get_filter_values, lusha_list_signal_types y consultar un trabajo de enriquecimiento con lusha_get_enrich_job.
• Un pequeño cargo por resultado encontrado (nada si no encuentra): lusha_search_contacts, lusha_search_companies, lusha_prospect_contacts y lusha_prospect_companies. Devuelven vistas previas sin correos ni teléfonos, más lo que revelaría un enriquecimiento y cuánto costaría.
• Más créditos: lusha_enrich_contacts (por cada correo y cada teléfono revelado; un teléfono suele costar varias veces lo que un correo), lusha_enrich_companies (por empresa), y lusha_get_contact_signals y lusha_get_company_signals (por señal encontrada).

Antes de cualquier llamada que cueste créditos, la IA te dice qué va a ejecutar, para cuántos registros y cuánto puede costar, y espera tu sí. Mantiene pequeñas las páginas de resultados y revela solo los campos que necesitas: solo correos cuesta menos que correos y teléfonos.

Cómo funciona: para personas y empresas que ya conoces, la IA busca por id de Lusha, URL de LinkedIn, correo, nombre más empresa, o nombre y dominio de la empresa. Para nuevos prospectos lee primero los valores válidos de los filtros (nivel, departamentos, sectores, tamaños de empresa, facturación, ubicaciones, tecnologías) y luego prospecta con filtros de inclusión y exclusión. Cuando eliges registros, los enriquece por id de Lusha, hasta 100 a la vez. Si Lusha responde con un trabajo para datos que llegan más tarde, la IA espera y lee el trabajo gratis.

Señales: cambios de empleo y ascensos de contactos, y picos de contratación, cambios de plantilla, tráfico web, gasto en TI, noticias y cambios de intención en empresas. lusha_list_signal_types las lista gratis; leer señales cuesta créditos por coincidencia.

Datos personales, solo para uso B2B: los registros de contactos describen a personas reales: nombres, cargos, empresas, correos de trabajo y personales, teléfonos móviles y directos. Ú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 Lusha. Guarda solo lo necesario, respeta la marca do-not-call de los teléfonos y la marca UE de los contactos, no crees listas de envío masivo y no busques a particulares. Lusha retiene algunas personas por motivos legales (HTTP 451 o COMPLIANCE_RESTRICTED). El conector da a la IA las mismas reglas.

Límites de uso: por defecto 25 solicitudes por segundo por cuenta, más cuotas por hora y por día según el plan. Un 429 significa esperar y volver a intentarlo.

Errores comunes: 401: la clave es incorrecta, está revocada o falta. 402: no quedan créditos. 403: la cuenta está inactiva o el plan no incluye una función. 400: un valor de filtro o parámetro no válido, que se indica en la respuesta. 451: Lusha no puede devolver a esta persona por motivos legales. Una respuesta correcta puede marcar registros sueltos como no encontrados, restringidos o fallidos.

El conector nunca cambia datos en Lusha. No busca y enriquece en una sola llamada (se saltaría tu confirmación) y no cubre lookalikes, buying groups, scoring, visitantes del sitio web, exportación al CRM, webhooks ni los antiguos endpoints v2.

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 Microsoft Copilot

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.

Microsoft Copilot usa servidores MCP a través de agentes creados en Copilot Studio: añades AnythingMCP a un agente como herramienta y luego publicas el agente en Microsoft 365 Copilot y Teams. Copilot Studio se conecta desde la nube de Microsoft por Streamable HTTP, que AnythingMCP admite.

1. En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
2. Escribe un Server name (por ejemplo AnythingMCP), una Server description que diga qué hace el conector y la Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor.
3. En la autenticación, elige API key, pon Type en Header y X-API-Key como nombre de la cabecera, y selecciona Create.
4. En Add tool, elige Create a new connection, pega una clave de API MCP de AnythingMCP (MCP Servers → tu servidor → API keys) y selecciona Add to agent.
5. Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de Lusha.
6. Selecciona Publish y luego Channels → Microsoft 365 and Microsoft Teams, deja marcada Make agent available in Microsoft Copilot y elige Add channel. See agent in Teams lo instala para ti; en Microsoft 365 Copilot, escribe @ y elige el agente.

¿Prefieres que cada persona inicie sesión? En lugar de la clave de API elige OAuth 2.0 → Dynamic discovery: cada usuario inicia sesión en AnythingMCP la primera vez que el agente lo llama.

¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Copilot Studio se conecta desde la nube de Microsoft, así que localhost no funciona.

Herramientas disponibles

Ejemplos de prompts

• "¿Cuántos créditos de Lusha nos quedan y cuánto cuesta en nuestro plan revelar un correo o un teléfono?"
• "Busca responsables de marketing en empresas SaaS de España con 51 a 500 empleados. Enséñame una página pequeña de vistas previas y dime antes cuánto cuesta la búsqueda."
• "Revela solo los correos de trabajo de los dos primeros contactos. Dime el coste en créditos antes de hacerlo."
• "Revisa si acme.com, northwind.com y contoso.com tienen picos de contratación o cambios de plantilla. Dime antes el coste."
• "¿Alguno de estos cinco contactos ha cambiado de empleo o ha sido ascendido hace poco?"

FAQ

¿Para qué Copilot es? Para Microsoft 365 Copilot en el trabajo, mediante agentes de Copilot Studio. La app de Microsoft Copilot para cuentas personales no permite añadir tu propio servidor MCP.

¿Qué necesito? Una cuenta de trabajo con acceso a Copilot Studio (licencia o prueba) para crear el agente. Quien lo use en Microsoft 365 Copilot o Teams necesita acceso al agente: compártelo o pide a un administrador que lo publique para la organización. Si tu organización aplica directivas de datos a los conectores de Power Platform, también cubren los servidores MCP.

El agente no llama a las herramientas. Comprueba que el nombre de la cabecera sea exactamente X-API-Key y que la clave pertenezca al mismo servidor MCP que la URL, y escribe una Server description concreta: Copilot Studio la usa para decidir cuándo llamar al servidor. Vuelve a publicar el agente después de cada cambio; en un chat abierto, escribe "start over" para usar la nueva versión.

Siguientes pasos

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