Conéctate al MCP de HumanDesign.ai
Antes de empezar
HumanDesign.ai MCP proporciona herramientas estructuradas de Human Design a clientes de IA compatibles. Esta guía abarca los cálculos y el catálogo de referencia que utilizan una clave API. Si tu cliente admite la conexión OAuth de HumanDesign.ai, utiliza ese flujo cuando necesites acceso vinculado a la cuenta, como datos guardados en la plataforma; los permisos y la disponibilidad de OAuth se determinan durante el inicio de sesión.
El endpoint MCP canónico es https://mcp.humandesign.ai/. Usa POST / para las solicitudes MCP. GET / no es una prueba de conexión y devuelve 405 Method Not Allowed. POST /mcp es un alias de compatibilidad.
Añade tu clave API de forma segura
Usa uno de estos encabezados de solicitud. No incluyas la clave API en una URL, no la guardes en un repositorio ni la pegues en un chat.
Authorization: Bearer YOUR_HDAI_API_KEY
o bien:
X-Api-Key: YOUR_HDAI_API_KEY
Conecta y descubre tus herramientas
- Configura tu cliente MCP con
https://mcp.humandesign.ai/. - Envía
initializecon la versión de protocolo2025-11-25. - Envía
notifications/initialized. - Llama a
tools/listy utiliza solo las herramientas que se devuelvan para tu clave.
{
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {
"protocolVersion": "2025-11-25",
"capabilities": {},
"clientInfo": { "name": "your-client", "version": "1.0.0" }
}
}
Las llamadas de descubrimiento, como initialize, pingy tools/list no consumen cuota de cálculos. Una llamada exitosa a tools/call consume una unidad API compartida; los errores de validación y las herramientas no disponibles no consumen ninguna.
Llama a una herramienta
Utiliza el nombre de herramienta y el esquema de entrada devueltos por tools/list. Por ejemplo, una solicitud de carta principal tiene esta estructura:
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "generate_chart",
"arguments": {
"birthDateTime": "1990-05-15T14:30:00",
"timezone": "America/New_York",
"detailLevel": "core"
}
}
}
Lee el resultado
Las llamadas exitosas devuelven un resumen breve y legible, un bloque de texto JSON y structuredContent. La respuesta estructurada utiliza un contenedor versionado con version, tool, data, metay un campo error opcional.
El catálogo actual de cálculos y referencias solo expone herramientas. No esperes prompts MCP, recursos MCP, herramientas de generación de informes, sesiones de servidor ni bloques de imágenes de cartas en este catálogo.