API y MCP

MCP — Enrichment en tus herramientas de IA

Conecta SalesQL a Claude, ChatGPT, Gemini, Cursor u otro cliente MCP para buscar leads, enriquecer contactos, verificar emails y consultar créditos.

En resumen

  • El MCP funciona en todos los planes, incluido Free, con límites según el plan; la URL del servidor es https://mcp.salesql.com/mcp.
  • Conéctalo con autorización OAuth en un clic, o usa una MCP key como header Bearer si tu cliente no admite OAuth.
  • Enriquecer una persona cuesta 1 crédito por contacto encontrado; buscar, enriquecer empresas, lookup y get_account_status son gratis.

Buscá leads, revelá emails verificados, enriquecé empresas y consultá tu saldo de créditos sin salir de Claude, ChatGPT, Gemini o Cursor. Tu asistente hace la búsqueda por vos — sin pestañas nuevas, sin copiar y pegar.

Este artículo cubre qué hace el MCP y cómo conectarlo. Para endpoints, configuraciones por cliente y troubleshooting técnico, consultá la documentación del MCP.

Plan requeridoCualquier plan, incluido Free — los límites varían según el plan
ConfiguraciónAutorización en un clic (OAuth) — o una MCP key si tu cliente no admite OAuth
Compatible conClaude, Claude Code, ChatGPT, Codex, Gemini CLI, Cursor, Perplexity, VS Code y cualquier cliente Streamable HTTP
Documentación técnica completasalesql.com/docs/mcp

Qué habilita

Una vez conectado, tu asistente puede:

  • Buscar leads — encontrar personas y empresas por cargo, ubicación, industria, tamaño de empresa y más — los mismos datos que Prospector
  • Enriquecer una persona — email laboral, teléfono, cargo, LinkedIn (los teléfonos no están incluidos en el plan Free)
  • Enriquecer una empresa — industria, tamaño, ubicación, LinkedIn
  • Enriquecer en lote — hasta 100 personas o empresas en una sola pasada (10 en el plan Free)
  • Verificar emails — comprobar si una dirección existe y acepta correos, de a una o en lote
  • Consultar créditos — saldo, próxima fecha de renovación, plan y límites de uso
  • Resolver filtros — valores exactos antes de una búsqueda

Misma cuenta, mismo saldo de créditos que usás en la extensión, el dashboard y la API.

Requisitos

  • Una cuenta de SalesQL en cualquier plan — incluido Free
  • Un cliente compatible con MCP: Claude (web, escritorio o móvil), Claude Code, ChatGPT (en la web), Codex, Gemini CLI, Cursor, Perplexity (plan Pro o superior), VS Code, o cualquier cliente que hable Streamable HTTP

Conectar ahora

URL del servidor: https://mcp.salesql.com/mcp

Opción 1 — Autorización en un clic (recomendada). Similar a conectar Zapier: hacé clic en Connect, iniciá sesión en SalesQL, elegí qué permisos otorgar y aprobá el acceso. No hay que copiar ninguna API key.

  • Conectar desde Claude — Customize → Connectors → + Add → Add custom connector. Nombralo SalesQL, pegá la URL del servidor, hacé clic en Add y después en Connect.
  • Conectar desde ChatGPT (web) — Abrí el plugin oficial de SalesQL (o buscá SalesQL en Plugins, en la barra lateral de ChatGPT) y hacé clic en Install plugin (y en Connect, si te lo pide). Iniciá sesión en SalesQL y aprobá el acceso — no hace falta la URL del servidor. ¿Preferís agregarlo manualmente? Plugins → Add → Add custom MCP server. Nombralo SalesQL, pegá la URL del servidor, elegí OAuth en Authentication y hacé clic en Create as a plugin y después en Connect SalesQL. ¿Todavía no ves Plugins? Usá Developer Mode en su lugar — los pasos están en la documentación del MCP.
  • Conectar desde Claude Code / Codex / Cursor / VS Code / Gemini CLI / Perplexity / cualquier cliente MCP — pasos exactos en la documentación del MCP

Opción 2 — MCP key (avanzada). Usala si tu cliente no admite OAuth o si preferís una key de larga duración (por ejemplo, en una máquina sin navegador). Obtené tu MCP key desde tu dashboard de SalesQL y enviala como header: Authorization: Bearer YOUR_MCP_KEY. Las configuraciones por cliente están en la documentación del MCP.

Administrá tus conexiones. Cada conexión OAuth aparece en tu dashboard de SalesQL en Connectors → MCP → Connected clients, con los permisos que se le otorgaron. Si desconectás una, se revoca al instante y tus otras herramientas conectadas siguen funcionando.

Ejemplos de uso

  • “Encontrá 20 Heads of Marketing de empresas de e-commerce en Londres.”
  • “Enriquecé linkedin.com/in/jane-doe y redactá un email de presentación corto con mi tono.”
  • “Encontrá 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 en CSV.”
  • “Verificá estos 50 emails antes de que envíe mi campaña.”
  • “Dame el tamaño, la industria y los decision-makers clave de acme.com.”
  • “¿Quién está detrás de jane.doe@acme.com? Dame su nombre completo, cargo, empresa y LinkedIn.”
  • “¿Cuántos créditos de enriquecimiento me quedan este mes y cuándo se renuevan?”

Créditos y límites

Enriquecer una persona cuesta 1 crédito de enriquecimiento por contacto encontrado — si no hay resultado, no se cobra. Verificar un email cuesta 1 crédito de verificación por dirección, que sale de un saldo separado de tus créditos de enriquecimiento. Buscar personas y empresas, enriquecer empresas, lookup y get_account_status son siempre gratuitos. En los resultados de búsqueda, los datos de contacto aparecen ocultos hasta que enriquecés, así que podés buscar y dimensionar una lista antes de gastar créditos.

Los límites diarios y por minuto dependen de tu plan y se comparten entre todas tus herramientas de IA conectadas, tus keys y el uso de la API. ¿Superaste el límite por minuto de tu plan? Vas a recibir un 429 — esperá unos segundos y reintentá.

FreeBasic
Búsqueda de personas25/día · 10/min, compartido con la búsqueda de empresas3.000/día · 100/min
Búsqueda de empresasCompartido con la búsqueda de personas1.000/día · 100/min
Enriquecer personas25/día · 10/min600/día · 50/min
Enriquecer empresas25/día · 10/min600/día · 50/min
Resolver filtros (lookup)100/día · 20/min600/día · 50/min
Verificar emails100/día · 10/min600/día · 50/min
Consultar el estado de verificaciones en lote300/día · 20/min600/día · 50/min
Personas o empresas por enriquecimiento en lote10100
Direcciones por verificación en lote100500
Resultados por página de búsqueda25100
Resultados que podés recorrer por búsqueda10010.000
Teléfonos en el enriquecimientoNoSí
Créditos de enriquecimiento50/mes2.000/mes o 24.000/año
Créditos de verificación por mes1005.000

En Professional y Premium, los límites son los mismos con facturación mensual o anual:

ProfessionalPremium
Búsqueda de personas3.000/día · 100/min3.000/día · 100/min
Búsqueda de empresas1.000/día · 100/min1.000/día · 100/min
Enriquecer personas5.000/día · 180/min20.000/día · 300/min
Enriquecer empresas5.000/día · 180/min20.000/día · 300/min
Resolver filtros (lookup)600/día · 50/min600/día · 50/min
Verificar emails600/día · 50/min600/día · 50/min
Consultar el estado de verificaciones en lote600/día · 50/min600/día · 50/min
Personas o empresas por enriquecimiento en lote100100
Direcciones por verificación en lote500500
Resultados por página de búsqueda100100
Resultados que podés recorrer por búsqueda10.00010.000
Teléfonos en el enriquecimientoSíSí
Créditos de enriquecimiento5.000/mes o 60.000/año12.000/mes o 144.000/año
Créditos de verificación por mes10.00020.000

¿Querés confirmar los límites exactos de tu plan? Pedile a tu asistente que ejecute get_account_status.

Qué está disponible, y qué viene

  • account (lectura) — Disponible
  • enrich (individual y en lote) — Disponible
  • search (Prospector) — Disponible
  • verify — Disponible
  • campaigns — Más adelante

Solución de problemas

¿Ves el plan o los créditos equivocados? La conexión usa la cuenta de SalesQL con la que estaba iniciada la sesión en tu navegador cuando la aprobaste. Preguntale a tu asistente qué cuenta y qué plan de SalesQL están conectados. Si no es la correcta, desconectala en Connectors → MCP → Connected clients y volvé a conectarla con la sesión iniciada en la cuenta correcta.

¿No podés conectarte? Revisá que la URL del servidor sea exactamente

https://mcp.salesql.com/mcp y que tu cliente use Streamable HTTP. Abrir la URL en el navegador no sirve como prueba. En un workspace de empresa (Claude Team o Enterprise, ChatGPT Business o Enterprise), puede que un administrador tenga que agregar o habilitar el conector primero.

¿“This MCP key lacks a required scope”? La conexión se aprobó sin ese permiso. Desconectala en Connectors → MCP → Connected clients y volvé a conectarla aprobando todos los permisos que necesitás. ¿Usás una MCP key? Editá sus permisos (scopes) en la misma pantalla.

¿No aparecen teléfonos? Los teléfonos no están incluidos en el plan Free. En los demás planes, revisá que la conexión se haya aprobado con el permiso de teléfonos.

¿“Créditos insuficientes”? Consultá get_account_status y recargá desde el dashboard. La verificación de emails usa un saldo de verificación separado.

¿No encontró resultados? No se cobra crédito. Probá con la URL de LinkedIn del contacto — es el identificador más confiable.

Preguntas frecuentes

¿Qué planes pueden usar el MCP? Todos los planes, incluido Free. Los límites varían según el plan — consultá Créditos y límites.

¿Con qué herramientas de IA funciona? Claude (web, escritorio y móvil), Claude Code, ChatGPT (web), Codex, Gemini CLI, Cursor, Perplexity, VS Code y cualquier cliente Streamable HTTP.

¿Tiene costo adicional? No, nada por encima de tu plan. Buscar, enriquecer empresas, lookup y get_account_status son gratuitos. Enriquecer personas usa créditos de enriquecimiento, y verificar emails usa créditos de verificación.

¿Puedo usar la API REST en Free o Basic? No. En Free y Basic, tu key funciona solo con el MCP. La API REST está disponible en Professional y Premium.

¿Mis datos están seguros? Misma cuenta, mismos permisos alineados a GDPR que la API. Consultá nuestra Política de Privacidad y el DPA.

Más en API y MCP

  • SalesQL API - Introducción

    Empieza con la API de SalesQL: sus endpoints Person y Organization, qué planes incluyen acceso y cómo los administradores generan y usan la API Key.

  • Preguntas frecuentes sobre la API

    Resuelve las dudas comunes sobre la API de SalesQL: créditos, límites diarios, búsquedas sin resultados, emails verificados y diferencias con la extensión.