OAuth per il tuo account. Chiavi API per i calcoli.
Human Design MCP supporta deliberatamente due tipi di credenziali con autorizzazioni diverse. Scegli OAuth per gli strumenti privati dell’account HumanDesign.ai; scegli una chiave API per l’insieme originale di calcolo e consultazione.
OAuth di HumanDesign.ai
- Aggiungi
https://mcp.humandesign.ai/come server MCP remoto Streamable HTTP senza un’intestazione di autorizzazione statica. - Usa l’azione di autenticazione, connessione,
/mcp, o accesso MCP del client. - Accedi alla pagina brandizzata HumanDesign.ai e verifica i limiti dell’account selezionato e le funzionalità disponibili.
- Riconnetti dopo una modifica all’iscrizione, al ruolo nell’area di lavoro, ai diritti di accesso o all’autorizzazione.
L’accesso OAuth è sempre limitato in base all’iscrizione e alla proprietà. Gli account Free e Individual possono creare, salvare, visualizzare e rendere il proprio grafico principale; Individual include anche la visibilità sull’utilizzo dell’account. Per i grafici autorizzati di altre persone e le funzionalità più ampie della piattaforma è necessario Personal o Pro.
Accesso ai calcoli con chiave API
Le chiavi API Bearer e X-Api-Key restano supportate per i sei strumenti di calcolo e consultazione. Non consentono l’accesso ai dati dell’account, della libreria, dei report o di Builder.
Authorization: Bearer $HDAI_API_KEY
# or
X-Api-Key: $HDAI_API_KEYSicurezza delle credenziali
- I token OAuth vengono gestiti dal client MCP e dal servizio di autorizzazione; non inserirli mai nei prompt o nei file sorgente.
- Conserva le chiavi API in una variabile d’ambiente o in un archivio protetto di segreti.
- Non registrare mai intestazioni di autorizzazione, token di aggiornamento, chiavi API, URL di risorse firmati o risultati strutturati di grafici privati.
- Disconnetti il connettore o cancella l’autenticazione MCP per revocare l’accesso delegato.
- Gestisci le chiavi API e l’utilizzo del piano di calcolo su my.humandesign.ai.
Errori di autenticazione
| Codice | Significato | Azione |
|---|---|---|
401 | Credenziale mancante, malformata, scaduta o revocata | Esegui di nuovo l’accesso OAuth del client oppure ripristina l’impostazione protetta della chiave API. |
403 | Origine, concessione delle funzionalità, iscrizione, ruolo, proprietà o diritto di accesso non autorizzati | Verifica i limiti dell’account; riconnetti dopo una modifica di accesso approvata. |
429 | È stato raggiunto il limite della quota di calcolo o della frequenza di sicurezza | Verifica l’utilizzo; non riprovare rapidamente. |