Cómo conectar Clay a Microsoft Copilot 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 + Microsoft Copilot

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 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 Clay.
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 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

¿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