Se connecter au MCP HumanDesign.ai
Avant de commencer
MCP HumanDesign.ai fournit aux clients IA compatibles des outils Human Design structurés. Ce guide présente le catalogue de calcul et de référence qui utilise une clé API. Si votre client prend en charge la connexion OAuth HumanDesign.ai, utilisez ce flux pour accéder aux données associées à votre compte, comme les données enregistrées sur la plateforme ; les autorisations et la disponibilité OAuth sont déterminées lors de la connexion.
Le point de terminaison MCP canonique est https://mcp.humandesign.ai/. Utilisez POST / pour les requêtes MCP. GET / ne constitue pas un test de connexion et renvoie 405 Method Not Allowed. POST /mcp est un alias de compatibilité.
Ajouter votre clé API en toute sécurité
Utilisez l’un de ces en-têtes de requête. Ne placez pas une clé API dans une URL, ne l’enregistrez pas dans un dépôt et ne la collez pas dans une conversation.
Authorization: Bearer YOUR_HDAI_API_KEY
ou :
X-Api-Key: YOUR_HDAI_API_KEY
Se connecter et découvrir vos outils
- Configurez votre client MCP avec
https://mcp.humandesign.ai/. - Envoyez
initializeavec la version du protocole2025-11-25. - Envoyez
notifications/initialized. - Appelez
tools/listet utilisez uniquement les outils renvoyés pour votre clé.
{
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {
"protocolVersion": "2025-11-25",
"capabilities": {},
"clientInfo": { "name": "your-client", "version": "1.0.0" }
}
}
Les appels de découverte tels que initialize, ping, et tools/list ne consomment pas de quota de calcul. Un appel réussi à tools/call consomme une unité API partagée ; les échecs de validation et les outils indisponibles n’en consomment aucune.
Appeler un outil
Utilisez le nom de l’outil et le schéma d’entrée renvoyés par tools/list. Par exemple, une requête de schéma principal suit cette structure :
{
"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"
}
}
}
Lire le résultat
Les appels réussis renvoient un résumé lisible, un bloc de texte JSON et structuredContent. La réponse structurée utilise une enveloppe versionnée avec version, tool, data, metales métadonnées de quota error et un champ facultatif.
Le catalogue actuel de calcul et de référence n’expose que des outils. Ne vous attendez pas à trouver des invites MCP, des ressources MCP, des outils de génération de rapports, des sessions serveur ou des blocs d’images de schémas dans ce catalogue.