Cómo conectar Clay a Cursor vía MCP

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

Clay + Cursor

Datos GTM de Clay desde cualquier agente de IA: busca en la base de datos de personas y empresas de Clay, ejecuta funciones de enriquecimiento gestionadas por Clay o propias sobre hasta 100 elementos, consulta tablas de Clay en los planes Enterprise, busca ejecuciones de Workflows y revisa el saldo de créditos. Funciona con una clave API personal de Clay; el borrado por privacidad viene desactivado.

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:

CLAY_API_KEY

Paso 1 — Obtener credenciales

La configuración lleva unos 2 minutos. Necesitas una cuenta de Clay.

1. En Clay abre API and CLI, pestaña API keys (https://app.clay.com/workspaces/~/api-and-cli?tab=api-keys), y crea una clave. La clave actúa como tu usuario, con tus accesos al workspace.
2. Pégala en CLAY_API_KEY. Se envía en la cabecera clay-api-key.
3. Para funciones propias, abre la función en Clay, luego Details, y activa el acceso API; copia su id t_....
4. Instala el conector y ejecuta clay_get_me: devuelve tu usuario y workspace y confirma la clave. clay_get_credit_balance muestra los créditos que quedan; leer el saldo no cuesta créditos.

Buscar en la base de datos de personas y empresas:

1. clay_get_search_query_reference, una vez por sesión, da los campos consultables de personas y empresas, los operadores y la gramática.
2. clay_create_search inicia una búsqueda con una consulta que empieza por select from people o select from companies, por ejemplo select from companies where people.exists(is_current = true and job_title is_similar_to ("VP Sales")), y devuelve un search_id. No se admiten consultas de recuento ni búsquedas de ofertas de empleo.
3. clay_get_search_results con ese id es un iterador con estado: cada llamada devuelve la página siguiente y la IA vuelve a llamar mientras has_more sea true. Las personas llegan con nombre, ubicación y experiencias coincidentes; las empresas con dominio, sector, tamaño, facturación y URL de LinkedIn.

Los resultados de búsqueda cuentan para los límites de tu plan: en el gratuito, 50 por búsqueda y 100 cada 30 días; en los de pago, 500 por petición. Por encima de un límite Clay responde 402 indicando el límite.

Enriquecer con una función:

1. clay_run_routine ejecuta una función gestionada por Clay, o una propia con acceso API, sobre 1 a 100 elementos: el id de la rutina (function:t_...) y elementos como {"id": "row-1", "inputs": {"domain": "clay.com"}}. El id (como máximo 64 caracteres) es tuyo y vuelve con el resultado. Un webhook_id puede avisar a un webhook de Clay registrado cuando termina la ejecución. Las ejecuciones gastan créditos de Clay, así que la IA te dice antes qué función y cuántos elementos va a lanzar.
2. clay_get_run_results con el routine_run_id: HTTP 202 y status: in_progress mientras se ejecuta, luego 200 con status: complete y data. Los resultados se emparejan con las entradas por id, no por orden; una ejecución completa puede contener elementos fallidos, y finished incluye los fallos. La IA consulta cada pocos segundos, no en un bucle cerrado.
3. clay_get_batch_run_results sigue una ejecución por lotes iniciada desde la CLI de Clay o la API; un lote terminado devuelve result_url con el archivo de resultados.

Tablas (planes Enterprise): clay_query_tables lee filas de tablas conocidas con campos seleccionados, filtros, orden, agrupación y joins; el id de la tabla está en su URL (.../tables/t_...). Cada celda vuelve con un status: success (con value), empty, error (con error) o un estado pendiente (running, queued, retry, rate_limited, awaiting_callback). Un recorrido puede devolver dos veces una fila que cambia mientras se lee, así que la IA elimina duplicados por id.

Workflows (beta): clay_get_runs_query_reference da la gramática de consultas de ejecuciones y luego clay_query_workflow_runs encuentra ejecuciones (una consulta select las devuelve de la más reciente a la más antigua, una consulta count da el número). Las consultas tienen como máximo 2000 caracteres; los datos pueden ir unos segundos por detrás.

Desactivadas al instalar: clay_privacy_delete_people borra personas de Clay Audiences para una solicitud de privacidad, como un borrado RGPD, localizadas por email, slug de LinkedIn (la parte tras /in/, no la URL) o teléfono, de 1 a 100 identificadores por llamada. No se puede deshacer, así que un admin del workspace la activa cuando haga falta; después se ejecuta primero con dry_run: true para contar las coincidencias y el trabajo se sigue con clay_get_privacy_deletion_status, disponible hasta cinco días después de que termine.

Paginación: las colecciones devuelven data y un cursor mientras haya más páginas; la IA devuelve el cursor. Las consultas de tablas devuelven 50 filas por página por defecto (como máximo 100), los resultados de ejecuciones 20 (como máximo 100) y las páginas de búsqueda 20 (como máximo 500 en planes de pago, 50 en gratuito y prueba).

Errores habituales: los errores llevan un message. 401 o 403 indican una clave errónea o falta de acceso, 402 un límite de resultados de búsqueda alcanzado, 404 un id desconocido o una función sin acceso API, 409 o 422 un estado o una entrada no válidos. 429 es el límite de frecuencia del workspace: espera los segundos de Retry-After.

Lo que no hace: la Clay Public API no tiene endpoints para listar tablas o funciones, crear tablas ni escribir filas. Las filas siguen llegando a una tabla por su webhook de entrada, y los ids de funciones y tablas se copian desde la app de Clay.

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 Cursor

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.

Cursor lee los servidores MCP de ~/.cursor/mcp.json. Añade esta entrada:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "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 Cursor.
3. Abre Cursor → Settings → MCP y comprueba que anythingmcp aparece en la lista y está conectado.
4. Empieza a chatear: el agente ya puede usar las herramientas de Clay.

Herramientas disponibles

Ejemplos de prompts

• "¿Cuántos créditos de Clay nos quedan?"
• "Busca VPs de ventas en empresas de software de Alemania con 50 a 200 empleados y muéstrame los 20 primeros."
• "Ejecuta nuestra función de enriquecimiento de empresas function:t_abc123 sobre estos cinco dominios y muéstrame los resultados cuando termine la ejecución."
• "De la tabla t_0te9i4tZEHwc9hihBXu, muestra las empresas con el dominio relleno, ordenadas por dominio."
• "¿Qué ejecuciones de nuestros Workflows de Clay han fallado en las últimas 24 horas?"

FAQ

¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.

Siguientes pasos

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