Des réponses claires sur le serveur MCP en production.
Le transport MCP canonique est le point de terminaison racine https://mcp.humandesign.ai/. L’API HumanDesign.ai reste l’autorité de calcul.
Qu’est-ce que Human Design MCP ?
Il s’agit de l’interface distante officielle pour agents de HumanDesign.ai. Les clients IA compatibles peuvent utiliser des outils de compte tenant compte de l’adhésion via OAuth, ou six outils de calcul et de référence via une clé API.
S’agit-il d’un moteur de calcul Human Design distinct ?
Non. MCP, Agent HTTP, REST et HumanDesign.ai délèguent tous les calculs de thème au même service faisant autorité. OAuth et les clés API donnent accès à des fonctionnalités différentes, mais les versions de calcul et les décisions de quota restent centralisées.
Qu’est-ce qui garantit la fiabilité des données du thème ?
Avant le calcul, le service valide les données de naissance, le lieu, le fuseau horaire IANA et le contexte du changement d’heure. Il renvoie un résultat structuré et versionné, et rejette les données ambiguës ou non valides avant toute facturation. Les agents doivent éviter d’approximer les calculs astrologiques.
Comment un agent doit-il formater une date et une heure de naissance ?
Comme une heure locale, exactement telle qu’elle s’affichait sur l’horloge du lieu de naissance, sans Z ni décalage UTC, en indiquant séparément le fuseau dans timezone sous la forme d’un identifiant IANA. "birthDateTime": "1990-05-15T14:30:00" avec "timezone": "America/New_York" signifie 14 h 30 à New York. Une valeur avec Z ou un décalage ne désigne pas à elle seule une heure locale ; le fuseau utilisé pour la lire modifie le thème. Ne convertissez jamais l’heure de naissance en UTC avant de l’envoyer.
Mon client envoie Z ou un décalage UTC. Cela va-t-il poser problème ?
Pas encore. MCP transmet la valeur et l’API l’accepte toujours en la lisant comme UTC ; la réponse annonce la dépréciation. Ces valeurs ne seront plus acceptées, et la date sera annoncée à l’avance. Passez à une heure locale sans suffixe accompagnée d’un fuseau horaire IANA : c’est la solution sûre et, si la valeur ne désignait pas réellement l’UTC, cela corrigera aussi le thème.
Combien d’outils de calcul sont disponibles ?
Six : resolve_timezone, generate_chart, generate_composite_chart, get_reference_item, get_transits et search_celebrities. OAuth ajoute un catalogue de comptes filtré séparément selon l’adhésion, la propriété, le rôle, les autorisations dérivées du serveur et les droits associés.
Quels clients peuvent se connecter ?
Tout client MCP compatible avec Streamable HTTP peut se connecter. La documentation propose des guides pour Claude, ChatGPT, Codex, Cursor et VS Code.
Qu’est-ce qui consomme le quota de calcul ?
generate_chart, generate_composite_chart et get_transits consomment chacun une unité dès qu’une demande validée atteint l’étape de calcul. resolve_timezone, get_reference_item, search_celebrities, initialize, ping, tools/list, les entrées invalides, les accès refusés, les lectures de bibliothèque, les vérifications de statut et le rendu d’un thème existant ne consomment rien.
Comment effectuer des tentatives de calcul sans risque ?
Les trois outils MCP payants exigent une idempotencyKey stable. Réutilisez-la uniquement avec les mêmes arguments normalisés pour une nouvelle tentative prévue. Une correspondance ne consomme aucun quota supplémentaire et peut recalculer le résultat de façon déterministe ; il ne s’agit pas de rejouer à l’identique une réponse stockée. Les appels MCP pour les transits exigent également une date explicite.
Un membre HumanDesign.ai du forfait Free peut-il créer un thème ?
Oui. Avec OAuth, un membre Free peut prévisualiser, confirmer, créer, enregistrer, consulter et afficher son propre thème principal. Le nouveau calcul consomme exactement une unité et son rendu n’entraîne aucun second prélèvement.
Peut-il créer des thèmes composites ?
L’interface de calcul par clé API peut générer un nouveau composite pour deux personnes. Les comptes OAuth éligibles peuvent récupérer et afficher les composites enregistrés auxquels ils sont autorisés. Le serveur fait toujours respecter les limites de propriété et d’adhésion.
Que se passe-t-il lorsqu’une image ne peut pas s’afficher directement ?
Le serveur vérifie le PNG ou le SVG avant de confirmer la réussite et fournit aussi un lien de téléchargement sécurisé et temporaire en solution de repli.
Où gérer les accès et la facturation ?
Connectez-vous à HumanDesign.ai pour gérer votre adhésion à la plateforme et l’accès à votre compte, ou à my.humandesign.ai pour les clés API, l’utilisation du forfait API et la facturation.
Besoin d’aide avec votre compte ? Consultez my.humandesign.ai.