OAuth para tu cuenta. Claves API para cálculos.
Human Design MCP admite deliberadamente dos tipos de credenciales con distintos permisos. Elige OAuth para las herramientas privadas de la cuenta de HumanDesign.ai y una clave API para la superficie original de cálculo y referencia.
OAuth de HumanDesign.ai
- Añade
https://mcp.humandesign.ai/como servidor MCP remoto Streamable HTTP sin un encabezado de autorización estático. - Usa la acción Authenticate, Connect,
/mcpo el inicio de sesión MCP del cliente. - Inicia sesión en la página de marca de HumanDesign.ai y revisa el límite de cuenta seleccionado y las capacidades disponibles.
- Vuelve a conectar tras cambiar la membresía, el rol del espacio de trabajo, los permisos o la autorización.
El acceso OAuth siempre se limita por la membresía y la propiedad. Las cuentas Free e Individual pueden crear, guardar, ver y representar su propia carta principal; Individual también incluye visibilidad del uso de la cuenta. Para acceder a cartas autorizadas de otras personas y a más funciones de la plataforma se requiere Personal o Pro.
Acceso de cálculo con clave API
Las claves API Bearer y X-Api-Key siguen siendo compatibles con las seis herramientas de cálculo y referencia. No exponen datos de la cuenta, la biblioteca, los informes ni Builder.
Authorization: Bearer $HDAI_API_KEY
# or
X-Api-Key: $HDAI_API_KEYSeguridad de las credenciales
- El cliente MCP y el servicio de autorización gestionan los tokens OAuth; nunca los pegues en instrucciones ni archivos de código fuente.
- Guarda las claves API en una variable de entorno o en un almacén de secretos protegido.
- Nunca registres encabezados de autorización, tokens de actualización, claves API, URL de recursos firmados ni resultados estructurados de cartas privadas.
- Desconecta el conector o borra la autenticación de MCP para revocar el acceso delegado.
- Gestiona las claves API y el uso del plan de cálculo en my.humandesign.ai.
Errores de autenticación
| Código | Significado | Acción |
|---|---|---|
401 | Credencial ausente, mal formada, caducada o revocada | Vuelve a iniciar la sesión OAuth del cliente o restaura el ajuste protegido de la clave API. |
403 | Origen, concesión de capacidad, membresía, rol, propiedad o permiso denegado | Revisa el límite de la cuenta y vuelve a conectarte tras un cambio de acceso aprobado. |
429 | Se alcanzó el cupo de cálculo o un límite de frecuencia de seguridad | Revisa el uso; no lo reintentes rápidamente. |