El MCP de Lidia Labs: conecta todo tu negocio a Claude Code, Cursor y tu agente de IA favorito

Imagina abrir Claude Code y escribir: «¿cuántas citas tengo mañana?», «responde en WhatsApp a Mariana que sí hay lugar el jueves», «ajusta el system prompt de Lidia para que ofrezca el 2x1 de esta semana». Sin abrir el dashboard, sin cambiar de ventana, sin copiar y pegar. Desde hoy eso es exactamente lo que puedes hacer con el MCP de Lidia Labs: tu negocio completo — contactos, agenda, notas, el inbox de WhatsApp, la configuración del agente y hasta tu equipo — disponible como herramientas nativas dentro del agente de IA que ya usas todos los días.

En esta guía te contamos qué es MCP, todo lo que expone nuestro servidor, cómo crear tu API key con permisos granulares (recurso por recurso, lectura o escritura), y cómo instalarlo paso a paso en Claude Code, Cursor, Windsurf, Antigravity, GitHub Copilot, Kiro, Codex y Qoder.

Qué es MCP y por qué importa

El Model Context Protocol (MCP) es un estándar abierto creado por Anthropic a finales de 2024 y adoptado desde entonces por prácticamente toda la industria: OpenAI, Google, Microsoft, Cursor y decenas de herramientas más. Su idea es simple y poderosa: en lugar de que cada aplicación invente su propia integración con cada modelo de IA, MCP define un lenguaje común — una especie de «puerto USB-C» para la inteligencia artificial. Un servidor MCP publica herramientas (tools); cualquier cliente compatible las descubre y las usa.

Para un negocio esto cambia el juego. Antes, «integrar la IA con mi sistema» significaba un proyecto de semanas con un desarrollador. Con MCP significa pegar una URL y una llave. El agente ve tus herramientas, entiende qué hace cada una y las combina solo: puede buscar un contacto, revisar su historial de citas y agendarle una nueva en una sola conversación.

Todo lo que expone el MCP de Lidia Labs

Nuestro servidor vive en https://lidialabs.com/api/mcp y usa el transporte HTTP oficial del protocolo, autenticado con tu API key. No se queda en el CRM: cubre prácticamente todo lo que harías en el dashboard, organizado en diez recursos.

• Contactos — busca por nombre, teléfono o email; crea, edita y borra, con campos personalizados por giro.
• Agenda — lista citas por rango de fechas, estado o contacto; agenda, reagenda y cancela.
• Notas — notas libres ligadas a un contacto o a una cita.
• Agente (system prompt) — lee y modifica las instrucciones de Lidia, su modelo y si está activa.
• Imágenes del agente — sube al catálogo de fotos que Lidia envía (por archivo o por URL) y bórralas.
• Inbox de WhatsApp — lista conversaciones y mensajes, responde por WhatsApp y cierra o reabre chats.
• Conexión de WhatsApp — consulta el estado del número y desconéctalo.
• Miembros — lista el equipo, invita, cambia roles y permisos, y quita miembros.
• Organización — lee y edita los datos de la org y del negocio (nombre, zona horaria, idioma, moneda).
• API keys — lista, crea y revoca tus propias keys desde la API.

Cada operación es una herramienta con nombre claro (get_business_info, list_contacts, send_whatsapp_message, update_agent_config, invite_member…) que el agente descubre y combina solo. Y todo queda aislado por negocio: la API key pertenece a un negocio específico de tu organización y solo ve los datos de ese negocio. Si manejas varias sucursales o marcas, cada una tiene sus propias keys.

Permisos granulares: tú decides qué toca cada key

Aquí está la diferencia clave. Una API key no es «todo o nada». Cada uno de los diez recursos tiene dos interruptores independientes — lectura y escritura — así que armas exactamente el alcance que necesitas.

• Un panel de reportes: solo lectura de agenda y contactos, nada más. Aunque el agente quisiera, no puede modificar un solo dato.
• Un asistente que contesta WhatsApp: lectura y escritura del inbox, pero sin tocar miembros ni la organización.
• Una automatización que ajusta la campaña: escritura del system prompt del agente y de sus imágenes, sin acceso al CRM.
• Provisión de equipo: escritura de miembros para dar de alta gente, y nada más.

Las herramientas para las que la key no tiene permiso ni siquiera aparecen en la lista del agente. Y para no complicarte, hay dos presets de un clic: «Solo lectura» (lectura de todo) y «Acceso total» (todo).

Crea tu API key en dos minutos

Las keys se administran desde el dashboard, en Configuración → Conexiones:

• Entra a lidialabs.com y ve a Configuración → Conexiones.
• Pulsa «Crear API key» y dale un nombre descriptivo (por ejemplo «Claude Code de Fede»).
• Prende los interruptores de lectura y/o escritura por recurso, o usa un preset. Por defecto arranca con lectura del CRM básico (contactos, agenda y notas); recursos sensibles como miembros o el inbox quedan apagados hasta que tú los prendas.
• Copia la key — empieza con lidia_sk_ y por seguridad solo se muestra una vez.

¿Quién puede crear keys? Solo el owner de la organización, o los miembros a quienes le des el permiso «Administrar conexiones externas» desde la pestaña Equipo.

Instálalo en tu agente de IA

El patrón siempre es el mismo: apuntas tu cliente a https://lidialabs.com/api/mcp y mandas tu key en el header Authorization como Bearer. Así se ve en cada cliente (sustituye YOUR_API_KEY por tu key):

• Claude Code — una línea en tu terminal: claude mcp add --transport http lidia https://lidialabs.com/api/mcp --header "Authorization: Bearer YOUR_API_KEY".
• Cursor — agrega el servidor en .cursor/mcp.json con url https://lidialabs.com/api/mcp y el header de autorización dentro de headers.
• Windsurf — en ~/.codeium/windsurf/mcp_config.json declara el servidor con serverUrl y el mismo header.
• Antigravity — abre Manage MCP Servers, edita el mcp_config.json y agrega el servidor con serverUrl y headers.
• GitHub Copilot (VS Code) — crea .vscode/mcp.json con type "http", la url del servidor y el header de autorización.
• Kiro — en .kiro/settings/mcp.json usa el puente mcp-remote: command npx con args [-y, mcp-remote, https://lidialabs.com/api/mcp, --header, Authorization: Bearer YOUR_API_KEY].
• Codex — desde la terminal: codex mcp add lidia -- npx -y mcp-remote https://lidialabs.com/api/mcp --header "Authorization: Bearer YOUR_API_KEY".
• Qoder — en la configuración de MCP agrega el servidor con url y headers, igual que en Cursor.

En todos los casos, al reiniciar el cliente verás las herramientas de Lidia disponibles. Pídele al agente que llame get_business_info como prueba: debe responder con el nombre de tu negocio.

Para que el agente lo entienda todo sin que le expliques nada, el MCP le envía instrucciones completas al conectarse. Y si quieres afinar aún más, publicamos guías listas para instalar: un skill para Claude Code (curl a https://lidialabs.com/mcp/claude-code/SKILL.md dentro de ~/.claude/skills/), un AGENTS.md para Codex y Antigravity, y reglas equivalentes para Cursor, Windsurf, Copilot, Kiro y Qoder. Todo el paso a paso está en https://lidialabs.com/mcp y la guía completa para agentes en https://lidialabs.com/mcp/lidia-labs.md.

Qué puedes pedirle una vez conectado

• Tu día de un vistazo: «¿qué citas tengo hoy y cuáles siguen pendientes de confirmar?».
• Contestar por ti: «responde en WhatsApp a Laura que sí hay lugar el jueves a las 5 y ciérrale la conversación».
• Capturar prospectos al vuelo: pega una lista de nombres y teléfonos y pide que los cree como contactos con su fuente.
• Afinar a Lidia: «cambia el system prompt para que mencione el 2x1 de esta semana» o «sube esta foto del local al catálogo».
• Gestionar el equipo: «invita a ana@correo.com como member» o «dale a Pedro el permiso de conexiones externas».
• Ajustar la organización: «cambia la zona horaria del negocio a America/Monterrey».
• Analizar: «lista las citas canceladas del mes y dime qué contactos deberíamos recuperar».

La gracia está en la combinación: el agente encadena varias herramientas solo. Un «prepárame el lunes» puede convertirse en listar citas, revisar notas de cada contacto, y dejar listos los mensajes de confirmación en el inbox — todo en una pasada.

También hay API REST

El MCP comparte credenciales y lógica con nuestra API REST pública en https://lidialabs.com/api/v1. Si lo tuyo son las integraciones clásicas — un Zapier casero, un script de reportes, tu propio sistema — tienes los mismos diez recursos vía HTTP: /contacts, /appointments, /notes, /agent, /agent/images, /inbox, /whatsapp, /members, /organization y /keys, más /me para verificar tu key. Autenticas igual, con Authorization: Bearer y tu lidia_sk_. Los errores regresan JSON consistente con código y mensaje, y la paginación usa limit y offset.

Seguridad: así cuidamos tus datos

• Tu key nunca se guarda en texto plano: almacenamos solo su hash SHA-256, como hacen los proveedores serios de APIs, y el token completo se muestra una única vez.
• Permisos mínimos de verdad: cada recurso tiene lectura y escritura por separado, y las herramientas fuera de alcance ni siquiera aparecen en la lista del agente.
• Sin escalada de privilegios: una key que puede crear otras keys no puede otorgar permisos que ella misma no tiene, así una key filtrada no se auto-amplía.
• Aislamiento por negocio: cada key ve únicamente el negocio al que pertenece, nunca otras organizaciones ni sucursales.
• Gestión de equipo segura: al administrar miembros por API no puedes dejar la organización sin owners.
• Subida de imágenes protegida: al traer una imagen por URL bloqueamos direcciones internas para que nadie use la API contra nuestra propia red.
• Revocación instantánea: desde el dashboard revocas cualquier key y las integraciones que la usaban dejan de funcionar en ese momento.
• Control de equipo: solo el owner — o miembros con el permiso explícito de conexiones externas — puede crear o revocar keys.

La IA más útil no es la que más sabe, sino la que puede actuar sobre tus datos reales — con permisos que tú controlas.

El MCP de Lidia Labs ya está disponible para todos los planes. Crea tu primera key en Configuración → Conexiones y conecta tu negocio al futuro — te toma menos tiempo que preparar un café.

Fuentes

• Model Context Protocol — https://modelcontextprotocol.io
• Anthropic, Introducing the Model Context Protocol — https://www.anthropic.com/news/model-context-protocol
• Claude Docs, Connect Claude Code to tools via MCP — https://docs.claude.com/en/docs/claude-code/mcp
• Cursor Docs, Model Context Protocol — https://docs.cursor.com/context/model-context-protocol
• Visual Studio Code Docs, MCP servers — https://code.visualstudio.com/docs/copilot/chat/mcp-servers