Connectez votre agent en quatre étapes.
Pour Claude, ChatGPT ou Codex, OAuth est la connexion recommandée : elle expose en toute sécurité les outils HumanDesign.ai autorisés pour l’utilisateur connecté.
1. Ajoutez le point de terminaison hébergé
Point de terminaison
https://mcp.humandesign.ai/Choisissez Remote HTTP ou Streamable HTTP. N’ajoutez pas /mcp à nouveau : le point de terminaison canonique est la racine du domaine.
2. Authentifiez-vous
Utilisez l’action MCP Authenticate ou Connect du client et terminez la connexion HumanDesign.ai dans le navigateur. Les utilisateurs de Claude Code peuvent exécuter claude mcp login human-design-ai; les utilisateurs de Codex peuvent exécuter codex mcp login human_design_ai.
Si seuls les six outils de calcul et de référence vous sont nécessaires, une clé API reste disponible via une authentification Bearer ou X-Api-Key une authentification.
3. Découvrez vos outils
JSON-RPC
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/list",
"params": {}
}La découverte est gratuite. La visibilité des outils OAuth dépend des autorisations de capacités dérivées par le serveur, de l’adhésion Free/Individual/Personal/Pro, du rôle dans l’espace de travail, de la propriété et des droits du produit. La visibilité par clé API dépend du forfait API distinct Free/Creator/Startup/Business.
4. Commencez par votre graphique principal
Demandez à l’agent d’appeler chart_get_primary. Si aucun graphique principal n’existe, les membres Free, Individual, Personal et Pro peuvent utiliser chart_generate: vérifiez d’abord les données de naissance normalisées et l’aperçu d’une unité, puis confirmez l’exécution. Le graphique enregistré est identifié par la propriété du compte, jamais par une recherche de nom comme « Kyle » ou « Mon graphique ». Personal ou Pro est nécessaire pour lire les graphiques autorisés d’autres personnes.
Connexion, initialize, ping, tools/list, lecture de la bibliothèque, vérifications d’état et affichage des graphiques existants ne consomment aucun crédit. Le calcul d’un nouveau graphique principal consomme exactement une unité ; son affichage n’entraîne aucun autre frais.
Fiabilité des calculs
L’agent ne calcule pas lui-même le graphique. HumanDesign.ai valide la date, le lieu, le fuseau horaire IANA et le contexte du changement d’heure avant de consommer le quota, puis renvoie le résultat versionné de son service de calcul. Les lieux ambigus et les données invalides renvoient une erreur explicite sans consommer d’unité. Si l’heure de naissance est inconnue, le service enregistre midi local et avertit que les détails sensibles à l’heure peuvent différer.
Réessais de calcul sûrs
Les outils MCP qui consomment des unités generate_chart, generate_composite_chart, et get_transits nécessitent une idempotencyKey. Réutilisez la même clé avec des arguments normalisés identiques pour un seul réessai prévu et utilisez une nouvelle clé pour toute nouvelle tâche. Un réessai correspondant ne consomme pas de quota supplémentaire et peut recalculer le résultat de façon déterministe ; il ne s’agit pas d’une relecture octet pour octet d’une réponse enregistrée. Les appels de transit MCP nécessitent une date explicite afin qu’un réessai concerne toujours le même instant. Les clients REST directs et Agent HTTP peuvent envoyer Idempotency-Key pour les opérations limitées sans flux qui le prennent en charge ; cette option reste facultative durant le déploiement de compatibilité, et les appels sans elle ne peuvent pas dédupliquer un réessai de transport. Les requêtes par lots et SSE refusent les clés de nouvelle tentative fournies par l’appelant et ne sont pas couvertes par le contrat de déduplication.
Tester le protocole brut
Les développeurs utilisant une clé API peuvent initialiser et appeler directement un outil de calcul :
Initialiser
{
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {
"protocolVersion": "2025-11-25",
"capabilities": {},
"clientInfo": {
"name": "my-agent",
"version": "1.0.0"
}
}
}Appel de calcul
{
"jsonrpc": "2.0",
"id": 3,
"method": "tools/call",
"params": {
"name": "generate_chart",
"arguments": {
"birthDateTime": "1990-05-15T14:30:00",
"timezone": "America/New_York",
"detailLevel": "core",
"idempotencyKey": "chart-1990-05-15-v1"
}
}
}Choisissez votre client
Claude · Codex · Cursor · VS Code · Téléchargements des plug-ins