HumanDesign.aiPersonalAbrir la aplicación ↗
PARA TICentro de ayuda

Conéctate al MCP de HumanDesign.ai

APIActualizado el 28 de agosto de 20262 min de lectura

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

  1. Configura tu cliente MCP con https://mcp.humandesign.ai/.
  2. Envía initialize con la versión de protocolo 2025-11-25.
  3. Envía notifications/initialized.
  4. Llama a tools/list y 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.

Volver arriba ↑¿Necesitas ayuda? Contacta con soporte ↗

Encuentra tu próxima respuesta.