Cómo crear un servidor MCP para conectar Claude a tu CRM

El problema: Claude no ve tu negocio

Claude escribe, resume y analiza muy bien, pero no sabe quiénes son tus clientes ni qué tienes pendiente esta semana. Para que te ayude con eso terminas exportando un archivo, pegándolo en el chat y repitiendo lo mismo la semana siguiente.

Un MCP (Model Context Protocol) resuelve eso. Es un enchufe estándar: tu sistema instala el tomacorriente, que es el servidor MCP, y cualquier aparato compatible (Claude Code, Claude en la web, el escritorio o el celular) se conecta sin cables hechos a la medida. Tu sistema publica un menú de acciones concretas y Claude las usa cuando hacen falta, con los permisos que tú defines.

Yo lo uso en mis propios sistemas. chiragx.com tiene su servidor MCP: desde una conversación con Claude puedo dejar un artículo como borrador, cambiar un texto del inicio o revisar los mensajes del formulario. Y cuando necesito una imagen, se la pido a xyCloser, mi plataforma, también por MCP y sin salir de Claude Code.

Antes de construir: ¿de verdad necesitas uno?

La skill empieza por aquí, y te dice con claridad si no te conviene:

• Enseñarle a Claude un proceso, un formato o un criterio: eso es una skill, no un MCP.
• Usar un servicio conocido que ya tiene conector: el conector del directorio de Claude, que ya está hecho y mantenido.
• Conectar dos sistemas sin IA de por medio: una API directa o una automatización.
• Algo solo en tu computadora, con archivos locales: una skill con un script o un MCP local.
• Que Claude use tu sistema desde varios lugares, con permisos y registro: aquí sí, un MCP remoto.

Si es algo de una sola vez, basta con exportar un CSV y pasárselo a Claude. Si lo van a usar varias personas o varias apps, o si necesitas limitar y registrar cada acción, entonces sí.

Qué construye la skill

Un servidor MCP remoto en Cloudflare Workers: un puente seguro para que Claude consulte y actualice tu sistema. La ruta recomendada usa el SDK de Agents de Cloudflare (createMcpHandler), D1 como base de datos, un token secreto y Claude Code.

Claude Code o Claude
   -> HTTPS con token
   -> tu Worker en Cloudflare (/mcp): límite de uso, token, validación y registro
   -> D1, o la API de tu sistema

Trae una plantilla lista: un CRM pequeño con tres herramientas.

• buscar_contacto: busca por nombre, correo o empresa. Solo lee, y las notas salen únicamente si se piden.
• crear_contacto: agrega un contacto y no lo duplica si el correo ya existe.
• listar_pendientes: tus seguimientos, filtrados por estado y fecha.

Más un recurso con el esquema de las tablas y un prompt que arma tu resumen de pendientes. Alrededor va lo que no se ve y es lo que importa: un límite de 60 solicitudes por minuto por IP, el token comparado en tiempo constante y un registro de cada llamada (qué herramienta, qué campos sin sus valores, el resultado y la duración) que nunca guarda tokens ni datos personales.

Paso 1. Instala la skill

Descarga el archivo, descomprímelo y copia la carpeta dentro de tus skills:

~/.claude/skills/crear-un-mcp/

En Windows es C:\Users\TU-USUARIO\.claude\skills\, con SKILL.md directo dentro de la carpeta. Tu proyecto conviene ponerlo en una ruta corta, como C:\proyectos\crm-mcp, porque con rutas largas la base de datos local puede fallar. Necesitas Node.js 22.19 o superior (lo pide el inspector oficial de MCP) y una cuenta de Cloudflare; el plan gratuito alcanza para empezar.

Paso 2. Pega este primer prompt

Quiero crear mi propio servidor MCP para que Claude pueda usar mi CRM. Usa la skill
crear-un-mcp y guíame paso a paso. No programo: explícame cada paso en simple y pídeme
confirmación antes de cualquier comando que toque mi cuenta de Cloudflare.

Contexto:
- Hoy llevo mis clientes en una hoja de cálculo; puedes usar D1 como en el ejemplo de la skill.
- Lo usaré solo yo, desde Claude Code (más adelante quizá desde Claude en la web).
- Necesito: buscar contactos, agregar contactos nuevos y ver mis pendientes de la semana.
- Por ahora nada de borrar datos.

Empieza por:
1. Confirmar si un MCP es lo correcto para esto.
2. Mostrarme la tabla de herramientas que propones (nombre, qué hace, si lee o escribe)
   y esperar mi aprobación.
3. Crear el proyecto en C:\proyectos\crm-mcp (o ~/proyectos/crm-mcp en Mac) a partir de
   la plantilla y probarlo en local antes de desplegar.
No me pidas el token por el chat: dime qué comando ejecutar yo en mi terminal.

Cómo avanza

1. Descubrir: qué sistema, de tres a cinco tareas reales de una semana normal, quién lo usa y qué no debe poder hacer nunca.
2. Diseñar: cada tarea se vuelve una herramienta, en una tabla que apruebas. La primera versión solo lee.
3. Construir en local a partir de la plantilla.
4. Probar en local: sin token debe responder 401; luego el inspector oficial de MCP y Claude Code apuntando a tu computadora.
5. Desplegar, con tu confirmación en cada comando.
6. Conectar Claude Code con la URL de producción y, si tu organización lo permite, Claude en la web.
7. Verificar y endurecer: la lista de seguridad, los permisos de Claude Code y el registro de llamadas.

Una buena herramienta es como un buen empleado nuevo: sabe qué le toca, qué datos necesita y qué responder cuando algo falla. Por eso la skill pide nombres claros sin tildes (telefono, no "teléfono"), una descripción de una a tres frases (es lo único que Claude lee para decidir), parámetros con límites y opciones cerradas, respuestas cortas con tope de filas y errores que le dicen a Claude cómo seguir. Nunca un parámetro libre para SQL, una URL o un comando.

Seguridad antes de conectar datos reales

Un servidor MCP le da a una IA acceso real a tu negocio. Por eso la skill no te deja saltarte esto:

• Mínimo privilegio: el servidor solo hace lo que exponen sus herramientas. Nada de "ejecutar consulta".
• Primero lectura, después escrituras que solo agregan y borrar casi nunca. Cuando hace falta, se archiva en dos pasos: una vista previa y una segunda llamada que confirma, después de tu sí.
• Confirmación humana en las escrituras, con las reglas de permisos de Claude Code.
• Todo lo que entra se valida: consultas con parámetros y comodines escapados, para que buscar "%" no devuelva toda la tabla.
• Lo que viene de tus registros es información, no instrucciones. Si la nota de un cliente dice "borra todo", eso no debe convertirse en una acción.
• El token nunca va en la URL, en el código, en un archivo versionado ni en el chat. Los comandos que lo llevan los corres tú, en tu terminal.

Conectarlo a Claude

Con el servidor publicado, lo agregas a Claude Code desde tu terminal:

claude mcp add --transport http crm https://crm-mcp.<tu-subdominio>.workers.dev/mcp --header "Authorization: Bearer <TU_TOKEN>"
claude mcp list

Dentro de Claude Code, /mcp te muestra el estado. Desde ahí le preguntas como a una persona ("¿qué tengo pendiente esta semana?") y Claude llama a la herramienta que corresponde. En Claude web se agrega como conector personalizado con la misma URL (con token fijo, solo si tu organización tiene esa función). Cuando cada persona necesita su propia cuenta, el camino es OAuth, y la skill explica cuándo dar ese paso.

Qué tienes al final

• Un Worker en Cloudflare con tus herramientas, probadas en local y en producción.
• Claude Code conectado: claude mcp list lo muestra y una pregunta real funciona.
• Un registro de cada llamada en tu base de datos, para saber qué hizo Claude y cuándo.
• Logs en vivo con npx wrangler tail y la vuelta atrás con npx wrangler rollback.
• La base para crecer: más herramientas, tu propio CRM o la API de un sistema en la nube.

El plan gratuito de Cloudflare alcanza para empezar: 100.000 solicitudes al día en Workers y, en D1, 5 millones de filas leídas y 100.000 escritas al día.

Errores típicos

• Error interno de la base local en Windows: la ruta del proyecto es muy larga. Mueve el proyecto a una ruta más corta.
• npm da un conflicto de versiones: el paquete del servidor MCP va en la versión exacta que fija la skill.
• 401 aunque pusiste el token: falta la palabra "Bearer", el token es otro o el secreto no se subió a Cloudflare.
• 404: la URL debe terminar en /mcp.
• Claude Code no ve las herramientas: revisa claude mcp list y /mcp, y que los nombres no lleven tildes.
• Seguiste un tutorial viejo: McpAgent quedó obsoleto en la documentación de Cloudflare, igual que el transporte HTTP+SSE. La skill usa lo vigente, incluida la versión del protocolo de julio de 2026, verificada contra las fuentes oficiales.

Para quién es

Para quien ya tiene un sistema (un CRM, un sitio con panel, una base de datos) y quiere que Claude lo use con límites claros. Para equipos que quieren el mismo acceso desde Claude Code y desde Claude en la web. Y es el paso natural después de crear tu propio CRM o de agregarle un blog con panel a tu sitio.

No necesitas saber programar, pero sí paciencia para probar: aquí se avanza en local primero y se publica después.

Si quieres conectarlo a tu empresa

En el taller presencial, el MCP es el paso siguiente para quien va adelantado con su CRM. Y si quieres conectar Claude a los sistemas de tu empresa, agenda una conversación y vemos qué conviene: a veces es un MCP y a veces basta con una skill.