Connectez un agent à HumanDesign.ai.
Le point de terminaison distant canonique Streamable HTTP est https://mcp.humandesign.ai/. OAuth connecte les outils privés du compte ; les clés API préservent l’interface de calcul et de référence.
Règle d’adhésion : Les utilisateurs Free et Individual de HumanDesign.ai peuvent créer, enregistrer, consulter et afficher leur propre graphique principal ; Individual permet également de consulter l’utilisation du compte. Personal ou Pro est nécessaire pour lire les graphiques autorisés d’autres personnes ou utiliser des fonctions de compte plus étendues. Les outils Website Builder ne s’affichent que si HumanDesign.ai a activé Builder pour votre compte, et uniquement lorsque tools/list les annonce.
Choisissez un mode d’accès
Outils de la plateforme OAuth →
19 outils actuellement exposés pour le compte, les graphiques, la bibliothèque, les opérations, l’état des rapports et Builder.
Outils de calcul par clé API →
6 outils de calcul et de référence régis par le forfait API distinct et le quota de calcul.
Interface du protocole
Le serveur accepte JSON-RPC sur HTTP POST à la racine du domaine. GET et la DELETE sont volontairement rejetés pour le transport MCP ; GET /health n’expose que des métadonnées de santé du service non sensibles.
Point de terminaison canonique
POST https://mcp.humandesign.ai/
Content-Type: application/json
Accept: application/json, text/event-streamMéthodes prises en charge
initializeMéthode de connexion ou de découverte ; elle ne consomme ni quota ni crédits IA.
notifications/initializedMéthode de connexion ou de découverte ; elle ne consomme ni quota ni crédits IA.
pingMéthode de connexion ou de découverte ; elle ne consomme ni quota ni crédits IA.
tools/listMéthode de connexion ou de découverte ; elle ne consomme ni quota ni crédits IA.
tools/callExécute un outil autorisé conformément à sa politique de facturation et de confirmation.
Les heures de naissance sont des heures locales telles qu’affichées par l’horloge.
Indiquez la date et l’heure de naissance telles qu’elles apparaissaient sur l’horloge du lieu de naissance, sans Z ni décalage UTC, et indiquez séparément le fuseau horaire sous forme d’identifiant IANA.
"birthDateTime": "1990-05-15T14:30:00" with "timezone": "America/New_York" means half past two in the afternoon in New York.
Une valeur comportant Z ou un décalage n’indique pas à elle seule une heure locale. Il faut choisir le fuseau horaire d’interprétation, et ce choix modifie le thème.
Z et les décalages UTC sont obsolètes. Les valeurs se terminant par Z ou par un décalage numérique sont obsolètes. MCP les transmet et l’API les accepte encore pour le moment en les interprétant comme UTC ; la dépréciation est signalée dans la réponse de l’API. Elles ne seront plus acceptées, et la date sera annoncée à l’avance.
L’API refuse avant tout calcul une heure locale qui ne correspond à aucun instant unique :
| Code d’erreur | Signification |
|---|---|
nonexistent_local_time | Le changement d’heure a sauté cette heure locale : elle n’a donc jamais existé dans ce fuseau. |
ambiguous_local_time | L’heure locale se situe dans une répétition liée au changement d’heure : elle s’est donc produite deux fois dans ce fuseau. |
future_birth_datetime | La date de naissance est dans le futur. |
invalid_birth_datetime_format | La valeur n’est pas une heure locale. Après la transition, cela s’applique également à Z et aux décalages numériques. |
Les dates de transit utilisent le même format d’heure locale, mais peuvent être dans le futur.
Commencez ici
Premiers pas →
Connectez-vous avec OAuth et effectuez une première requête en toute sécurité.
Adhésion et autorisations →
Comprenez les autorisations de capacité, les espaces de travail, la propriété et les confirmations.
Claude, ChatGPT et Codex →
Téléchargez les fichiers de configuration et le package de plug-in à deux formats.
Authentification →
Choisissez OAuth ou l’accès par clé API réservé aux calculs.