OAuth pour votre compte. Clés API pour les calculs.
Human Design MCP prend volontairement en charge deux types d’identifiants aux pouvoirs distincts. Choisissez OAuth pour les outils privés du compte HumanDesign.ai et une clé API pour l’interface de calcul et de référence d’origine.
OAuth HumanDesign.ai
- Ajoutez
https://mcp.humandesign.ai/comme serveur MCP distant Streamable HTTP sans en-tête d’autorisation statique. - Utilisez l’action Authenticate, Connect,
/mcpou la connexion MCP du client. - Connectez-vous à la page HumanDesign.ai de marque et vérifiez le périmètre de compte sélectionné ainsi que les capacités disponibles.
- Reconnectez-vous après toute modification de l’adhésion, du rôle de l’espace de travail, des droits ou de l’autorisation.
L’accès OAuth est toujours limité par l’adhésion et la propriété. Les comptes Free et Individual peuvent créer, enregistrer, consulter et afficher leur graphique principal ; Individual inclut également la visibilité sur l’utilisation du compte. Personal ou Pro est nécessaire pour les graphiques autorisés d’autres personnes et les fonctions plus larges de la plateforme.
Accès au calcul par clé API
Les clés API Bearer et X-Api-Key restent prises en charge pour les six outils de calcul et de référence. Elles n’exposent pas les données du compte, de la bibliothèque, des rapports ou de Builder.
Authorization: Bearer $HDAI_API_KEY
# or
X-Api-Key: $HDAI_API_KEYSécurité des identifiants
- Les jetons OAuth sont gérés par le client MCP et le service d’autorisation ; ne les collez jamais dans des invites ou des fichiers source.
- Stockez les clés API dans une variable d’environnement ou un coffre de secrets protégé.
- Ne consignez jamais les en-têtes d’autorisation, jetons d’actualisation, clés API, URL de ressources signées ou résultats structurés de graphiques privés.
- Déconnectez le connecteur ou effacez l’authentification MCP pour révoquer l’accès délégué.
- Gérez les clés API et l’utilisation du forfait de calcul sur my.humandesign.ai.
Erreurs d’authentification
| Code | Signification | Action |
|---|---|---|
401 | Identifiant manquant, mal formé, expiré ou révoqué | Relancez la connexion OAuth du client ou restaurez le paramètre protégé de la clé API. |
403 | Origine, autorisation de capacité, adhésion, rôle, propriété ou droit refusé | Vérifiez le périmètre du compte et reconnectez-vous après une modification d’accès approuvée. |
429 | Le quota de calcul ou une limite de débit de sécurité a été atteint | Vérifiez l’utilisation ; évitez les tentatives répétées à intervalles rapprochés. |