Ir al contenido principal

MCP — Enrichment en tus herramientas de IA

Conecta el servidor MCP de SalesQL a Claude, ChatGPT, Gemini o Cursor y obtén emails verificados, datos de empresa y tu saldo de créditos sin salir del chat. Nada de pestañas nuevas ni de copiar y pegar entre herramientas: tu asistente hace la búsqueda por vos.

Para la guía técnica completa —endpoints, configuración por cliente y solución de errores— visitá la documentación del MCP.

¿Qué es el MCP de SalesQL?

MCP (Model Context Protocol) es el estándar que usan los asistentes de IA para conectarse a herramientas externas. En la práctica, es un puente entre tu base de datos de SalesQL y el chat donde ya estás trabajando.

Una vez conectado, tu asistente puede:

  • Revelar el email de trabajo, teléfono, cargo y LinkedIn de un contacto

  • Enriquecer una empresa completa (industria, tamaño, ubicación, LinkedIn)

  • Procesar listas de hasta 100 personas o empresas en una sola pasada

  • Consultar tu saldo de créditos y fecha de renovación

  • Resolver los valores exactos de un filtro antes de una búsqueda

Todo esto corre sobre la misma cuenta y el mismo saldo de créditos que ya usás en la extensión, el dashboard y la API. No es un producto separado: es otra puerta de entrada a los mismos datos.

¿Dónde funciona?

El servidor vive en un único endpoint (https://mcp.salesql.com/mcp, vía Streamable HTTP) y hoy se conecta desde:

  • Claude Desktop y Claude Code

  • ChatGPT (modo desarrollador)

  • Gemini CLI

  • Cursor

  • Perplexity (conectores)

  • VS Code (GitHub Copilot, modo agente)

  • Cualquier cliente que hable Streamable HTTP

Cada cliente apunta al mismo endpoint; lo único que cambia es dónde pegás la clave. Los pasos exactos para cada uno —con los bloques de configuración listos para copiar— están en la documentación del MCP.

Antes de empezar

Necesitás una clave de API/MCP activa. Se genera desde tu dashboard, en Enrichment API. Por seguridad, no la compartas dentro del chat ni la pegues en un mensaje: cada cliente tiene su propio lugar para guardarla de forma local.

Cómo conectar tu asistente en 3 pasos

  1. Elegí tu cliente. Claude Desktop y Claude Code son los caminos más directos si ya trabajás dentro del ecosistema Claude; Cursor y VS Code son ideales si vivís en el editor de código.

  2. Pegá la configuración. Cada cliente tiene un archivo o pantalla distinta (claude_desktop_config.json, ~/.cursor/mcp.json, el panel de conectores de ChatGPT, etc.), pero la estructura es siempre la misma: el endpoint del MCP más tu clave como Bearer token.

  3. Reiniciá el cliente. La mayoría de los asistentes necesita un reinicio completo para leer la nueva configuración y mostrar las herramientas de SalesQL en el composer.

Si preferís que tu propio asistente arme el archivo de configuración por vos, la documentación incluye un prompt listo para pegar por cada cliente, que te guía sin pedirte que expongas tu clave en la conversación.

Qué le podés pedir a tu asistente

Una vez conectado, no hace falta memorizar comandos. Con lenguaje natural alcanza:

  • "Enriquecé linkedin.com/in/jane-doe y redactá un email de presentación con mi tono."

  • "Buscá el teléfono directo y el email verificado del VP de Marketing de Acme."

  • "Enriquecé estas 40 URLs de LinkedIn con emails verificados y exportalas a CSV."

  • "Dame el tamaño, la industria y los decision-makers clave de acme.com."

  • "¿Quién está detrás de [email protected]? Dame su nombre completo, cargo, empresa y LinkedIn."

  • "¿Cuántos créditos de enrichment me quedan este mes y cuándo se renuevan?"

Los pedidos masivos funcionan igual: pegá hasta 100 URLs de LinkedIn, emails o nombres y pedí un CSV de vuelta. Por detrás se hace una sola llamada bulk; vos seguís la conversación como si nada, y solo se cobran créditos por los contactos que efectivamente hacen match.

También pensado para developers

El MCP no es solo para chats. Cursor, VS Code y cualquier agente compatible con MCP tienen las mismas herramientas disponibles —enrichment dentro de sesiones de código, automatizaciones o apps internas, usando tu mismo saldo de créditos. Un caso típico: "Antes de enviar este email a la lista, verificá qué direcciones siguen siendo válidas", corrido directamente desde tu IDE sin salir del editor.

Créditos y límites

El MCP y la API REST comparten un mismo saldo de créditos y un mismo límite de velocidad, sin importar cuántas claves o clientes tengas conectados. Cada contacto o empresa enriquecida con éxito consume 1 crédito; una búsqueda sin resultados no descuenta nada. Consultar tu cuenta o resolver filtros (get_account_status, lookup) es siempre gratis.

Si superás el límite por minuto de tu plan, vas a recibir un error 429. En ese caso, esperá unos segundos antes de reintentar.

Qué está disponible hoy, y qué viene

Las claves del MCP tienen scopes que definen qué pueden hacer:

  • account (lectura) — uso, plan y saldo de créditos. Disponible.

  • enrich — revelar y enriquecer personas y empresas, individual y en bulk. Disponible.

  • search (lectura) — Prospector, búsqueda de personas y empresas. Próximamente.

  • verify — verificación de email. Próximamente.

  • campaigns (lectura/escritura/envío) — crear y gestionar campañas de outbound. Más adelante.

Hoy las claves tienen acceso completo a lo que ya está disponible. Si tu asistente todavía no puede correr una búsqueda de Prospector o verificar un email, es lo esperado — no un bug.

Problemas comunes

El cliente no se conecta. Confirmá que el transporte sea Streamable HTTP y que la URL termine en /mcp. La causa más frecuente es una clave Bearer mal pegada o faltante.

"Créditos insuficientes." Revisá tu saldo con la herramienta de estado de cuenta y recargá desde el dashboard si hace falta.

Una búsqueda no devuelve resultados. No se descuenta crédito. Probá con la URL de LinkedIn del contacto: es el identificador más confiable.

Claude Desktop no conecta o tira errores de npm. Suele deberse a una versión vieja de Node. La documentación completa detalla cómo verificarlo y solucionarlo paso a paso.

Para el resto de los errores por cliente —incluidos los casos particulares de Claude Desktop y Claude Code— la guía técnica en salesql.com/docs/mcp tiene el detalle completo, con los bloques de configuración exactos para copiar y pegar.

Preguntas frecuentes

¿Qué es el MCP de SalesQL? Un servidor que conecta los datos de contacto verificados de SalesQL con herramientas de IA a través del Model Context Protocol. Tu asistente recibe herramientas como enrich_person y las llama cuando se lo pedís.

¿Con qué herramientas de IA funciona? Claude Desktop, Claude Code, ChatGPT (modo desarrollador), Gemini CLI, Cursor, Perplexity, VS Code y cualquier otro cliente que hable Streamable HTTP.

¿Necesito saber programar? No. Conectarlo desde Claude Desktop, ChatGPT o Perplexity es pegar una configuración y reiniciar — sin código de por medio. Cursor y VS Code están pensados para developers, pero el proceso de conexión son los mismos tres pasos.

¿Tiene un costo aparte? No, más allá de tu plan actual. El MCP usa los mismos créditos que ya tenés; no hay una tarifa separada por usarlo. get_account_status y lookup son siempre gratis.

¿Mis datos están seguros? El MCP corre sobre tu cuenta existente de SalesQL y está alineado con GDPR, compartiendo el mismo saldo de créditos y modelo de permisos que la API. Más detalles en nuestra Política de Privacidad y el Data Processing Addendum.

Para una visión más general del producto, mirá el overview del MCP.

¿Ha quedado contestada tu pregunta?