La documentación más actualizada de las APIs de Cloud Humans está en docs.cloudhumans.com/api-reference. En caso de diferencias entre este artículo y la referencia, prevalece lo que está allí.
Cuándo usarlo
- Quieres gestionar el contenido de tu base de conocimiento directamente desde Claude — listar, crear y editar sin salir de la conversación
- Quieres dejar de mantener la misma base de conocimiento en varios lugares
- Usas otro cliente MCP (Claude Code, Cursor, VS Code) y quieres conectarlo a Cloud Humans
El MCP Server de Cloud Humans está en Beta. Las funcionalidades de gestión de contenido ya están disponibles y se están agregando nuevas. Si algo no funciona como esperabas, habla con tu equipo de atención de Cloud Humans.
Requisitos previos
- Una cuenta de Cloud Humans activa — el inicio de sesión del conector se hace con el mismo correo electrónico y contraseña que ya usas en la plataforma
- Un cliente MCP que acepte conectores personalizados (en Claude, esto depende de tu plan)
- No es necesario generar, solicitar a Cloud Humans ni pegar en ningún lugar ningún token ni clave de API — la autorización ocurre en la pantalla de inicio de sesión
Sobre este artículo
El MCP Server de Cloud Humans es la dirección que le da a tu asistente de IA acceso a las herramientas de Cloud Humans. Una vez conectado, conversas normalmente con Claude y este puede consultar y modificar tu contenido en Cloud Humans.
La dirección del servidor es:
https://mcp.cloudhumans.com/openapi/cloudhumans/mcp
Esta dirección no es una página para abrir en el navegador. Si pegas esta URL en la barra de direcciones, verás el mensaje {"detail":"missing_token"}.
Esto es esperado y no es un error: no significa que te falten permisos ni que necesites un token. La dirección solo funciona cuando se agrega como conector dentro de tu cliente de IA, que es lo que explican los pasos a continuación.
Este artículo trata sobre conectar tu asistente de IA a Cloud Humans. Si lo que buscas es el camino inverso — conectar los agentes de ClaudIA a servidores MCP externos —, consulta Cómo configurar servidores MCP para los agentes de ClaudIA.
Paso a paso
Etapa 1 — Abrir la configuración de conectores
-
En Claude, abre la Configuración
-
Ve a la sección Conectores
Etapa 2 — Agregar como conector personalizado
- Haz clic en Agregar conector personalizado
Tiene que ser un conector personalizado (custom connector). Cloud Humans no aparece en la lista de conectores predefinidos — si la buscas allí, no la vas a encontrar.
-
En Nombre, escribe algo que reconozcas después (por ejemplo,
Cloud Humans) -
En URL, pega la dirección del servidor:
https://mcp.cloudhumans.com/openapi/cloudhumans/mcp
- Confirma para agregarlo
Etapa 3 — Iniciar sesión y autorizar
-
Haz clic en Conectar en el conector que acabas de crear
-
Se abrirá una pantalla de inicio de sesión de Cloud Humans, que te pedirá correo electrónico y contraseña
-
Inicia sesión con tu cuenta de Cloud Humans — la misma que usas en la plataforma
-
Después de iniciar sesión, el navegador vuelve automáticamente a Claude y el conector pasa a aparecer como conectado
Tienes cerca de 10 minutos para completar el inicio de sesión después de hacer clic en Conectar. Si tardas más, la pantalla expira — solo haz clic en Conectar de nuevo y vuelve a empezar.
Etapa 4 — Probar
Vuelve a una conversación y pide algo simple, como:
Lista los contenidos de mi base de conocimiento en Cloud Humans.
Si Claude responde con tus contenidos, todo está bien.
Si tu usuario tiene acceso a más de una cuenta o proyecto en Cloud Humans, indica en la conversación cuál quieres usar. Sin eso, el asistente no tiene cómo adivinar en cuál actuar y te pedirá que lo especifiques.
Observaciones
-
La conexión es válida por 30 días y se renueva automáticamente mientras la uses. Pasado ese plazo, Claude te pide iniciar sesión de nuevo — solo repite la Etapa 3.
-
Cambiar la contraseña o perder el acceso a tu cuenta termina la conexión de inmediato. Es el comportamiento esperado: quien pierde el acceso a la plataforma también pierde el acceso a través del conector.
-
Los permisos son exactamente los de tu cuenta. El conector no amplía ni reduce lo que ya podías ver y editar en Cloud Humans, y cada persona que se conecta usa su propia cuenta.
-
Funciona con otros clientes MCP. La dirección y el flujo de inicio de sesión son los mismos en cualquier cliente que admita servidores MCP remotos con inicio de sesión — lo único que cambia es dónde está la opción para agregar el conector.
-
Si la pantalla de inicio de sesión no se abre y sigues viendo
{"detail":"missing_token"}, casi siempre la dirección se abrió en el navegador en lugar de agregarse como conector personalizado. Repite la Etapa 2.