Una conexión MCP, cuatro superficies de agente.
Usa directamente el endpoint alojado, descarga los archivos del proyecto para Claude Code o instala el paquete de plugin en dos formatos, preparado para Claude Code y para el sistema universal de plugins de ChatGPT/Codex.
Claude Code: configuración más rápida
CLAUDE.md es una guía, no un instalador. Claude Code debe tener una sesión iniciada y un servidor MCP limitado al proyecto .mcp.json debe marcarse como de confianza antes de iniciar OAuth de MCP.
- Abre el directorio del proyecto y ejecuta
claude. - Si Claude Code indica que no has iniciado sesión, ejecuta
/login. - Aprueba el proyecto y su
.mcp.jsoncuando se te solicite. - Ejecuta
/mcp, seleccionahuman-design-aiy completa la autorización OAuth de HumanDesign.ai.
También puedes, tras iniciar sesión en Claude Code, añadir la conexión vinculada al usuario:
claude mcp add --transport http --scope user human-design-ai https://mcp.humandesign.ai/
claude mcp login human-design-aiPara un proyecto compartido, guarda lo siguiente como .mcp.json en la raíz del proyecto.
.mcp.json
{
"mcpServers": {
"human-design-ai": {
"type": "http",
"url": "https://mcp.humandesign.ai/"
}
}
}Claude.ai y Claude Desktop
- Abre Personalizar → Conectores.
- Selecciona Añadir conector personalizado.
- Usa
https://mcp.humandesign.ai/como URL remota de MCP. - Selecciona Conectar y completa la autorización OAuth de HumanDesign.ai.
- Activa HumanDesign.ai desde el menú de conectores en una conversación.
Los propietarios de Team y Enterprise añaden primero el conector en los ajustes de la organización; después, cada miembro conecta su propia cuenta de HumanDesign.ai.
Codex
~/.codex/config.toml
[mcp_servers.human_design_ai]
url = "https://mcp.humandesign.ai/"
auth = "oauth"
startup_timeout_sec = 30
tool_timeout_sec = 60Autentícate
codex mcp login human_design_aiChatGPT
- Activa el modo de desarrollador en Ajustes → Seguridad e inicio de sesión.
- Abre Plugins, selecciona el botón más y añade la URL remota de MCP
https://mcp.humandesign.ai/. - Revisa las herramientas detectadas y completa OAuth.
- Activa la conexión en una conversación nueva de Work y prueba primero solicitudes representativas de solo lectura.
Qué incluye el plugin
El paquete contiene manifiestos de plugin para Claude y OpenAI, la definición remota de MCP, recursos de marca y una skill de flujo de trabajo que enseña al agente a usar cartas individuales y cartas compuestas de relación guardadas, representar bodygraphs autorizados, respetar los límites de Free, Individual, Personal y Pro, y gestionar de forma segura las confirmaciones, la idempotencia y los secretos.
Cartas compuestas de relación
Con OAuth, los miembros Personal y Pro pueden recuperar y representar composiciones guardadas a las que tienen permiso de acceso. Crear una composición nueva a partir de dos conjuntos de datos de nacimiento utiliza la superficie de cálculo independiente y, por tanto, requiere una clave API protegida de HumanDesign.ai; consume una unidad de cálculo tras la validación. El servidor activo siempre aplica las reglas de propiedad, consentimiento, membresía, tipo de credencial y cupo.
¿Por qué conectar una membresía?
Free ofrece a cada miembro un punto de partida fiable con su propia carta, mientras que Individual añade visibilidad sobre el uso de la cuenta dentro del mismo límite de carta propia. Personal abre el acceso a una biblioteca más amplia de cartas y composiciones autorizadas, informes propios, profesionales, aprendizaje comunitario y conexiones con personas que exploran patrones de diseño similares. Pro amplía esto a espacios de trabajo profesionales. Las herramientas de Website Builder solo aparecen cuando HumanDesign.ai ha habilitado Builder para tu cuenta y únicamente cuando tools/list las anuncia. Las membresías de HumanDesign.ai también ofrecen una experiencia más profunda en la plataforma, incluidas algunas funciones de tránsito; la herramienta de cálculo independiente de MCP get_transits requiere una clave API de nivel Startup o superior. La guía descargable para agentes mantiene una postura neutral: explica una vez que falta un permiso y sigue el catálogo activo en lugar de insertar promociones de mejora repetidas en las conversaciones.
Instalar un plugin no evita la autorización de HumanDesign.ai. El servidor solo devuelve las herramientas permitidas para la cuenta con sesión iniciada. Nunca pegues un token OAuth ni una clave API en una instrucción.