Collega un agente a HumanDesign.ai.
L’endpoint remoto canonico Streamable HTTP è https://mcp.humandesign.ai/. OAuth collega gli strumenti privati dell’account; le chiavi API mantengono la superficie API di calcolo e riferimento.
Regola di appartenenza: Gli utenti Free e Individual di HumanDesign.ai possono creare, salvare, visualizzare e renderizzare il proprio grafico principale; Individual mostra anche l’utilizzo dell’account. Personal o Pro è necessario per leggere grafici autorizzati di altre persone o usare funzioni più ampie dell’account. Gli strumenti Website Builder vengono mostrati solo se HumanDesign.ai ha abilitato Builder per il tuo account e soltanto quando tools/list li elenca.
Scegli una superficie di accesso
Strumenti della piattaforma OAuth →
19 strumenti attualmente esposti per account, grafici, libreria, operazioni, stato dei report e Builder.
Strumenti di calcolo con chiave API →
6 strumenti di calcolo e riferimento regolati dal piano API separato e dalla quota di calcolo.
Superficie del protocollo
Il server accetta JSON-RPC tramite HTTP POST alla radice del dominio. GET e DELETE vengono rifiutati intenzionalmente per il trasporto MCP; GET /health espone soltanto metadati sicuri sullo stato del servizio.
Endpoint canonico
POST https://mcp.humandesign.ai/
Content-Type: application/json
Accept: application/json, text/event-streamMetodi supportati
initializeMetodo di connessione o individuazione; non consuma quota né crediti IA.
notifications/initializedMetodo di connessione o individuazione; non consuma quota né crediti IA.
pingMetodo di connessione o individuazione; non consuma quota né crediti IA.
tools/listMetodo di connessione o individuazione; non consuma quota né crediti IA.
tools/callEsegue uno strumento autorizzato secondo la relativa politica di fatturazione e conferma.
Gli orari di nascita sono orari locali dell’orologio.
Invia la data e l’ora di nascita così come apparivano sull’orologio nel luogo di nascita, senza Z né offset UTC, e indica separatamente il fuso orario come identificatore IANA.
"birthDateTime": "1990-05-15T14:30:00" with "timezone": "America/New_York" means half past two in the afternoon in New York.
Un valore con Z o un offset non identifica da solo un orario locale. Occorre decidere quale fuso orario applicare e questa scelta modifica il grafico.
Z e gli offset UTC sono deprecati. I valori che terminano con Z o con un offset numerico sono deprecati. MCP li inoltra e per ora l’API li accetta ancora, interpretandoli come UTC; la risposta API segnala la deprecazione. In futuro non saranno più accettati e la data verrà comunicata in anticipo.
L’API rifiuta un orario locale che non identifica un singolo istante prima di utilizzare qualsiasi unità di calcolo:
| Codice di errore | Significato |
|---|---|
nonexistent_local_time | Il passaggio all’ora legale ha saltato quell’orario locale, che quindi non si è mai verificato in quel fuso. |
ambiguous_local_time | L’orario locale rientra nell’ora ripetuta del cambio di orario legale, quindi si è verificato due volte in quel fuso. |
future_birth_datetime | La data di nascita è nel futuro. |
invalid_birth_datetime_format | Il valore non è un orario locale. Dopo la modifica, questo include anche Z e gli offset numerici. |
Le date dei transiti usano lo stesso formato di orario locale, ma possono essere nel futuro.
Inizia qui
Per iniziare →
Connettiti tramite OAuth ed esegui una prima richiesta in sicurezza.
Appartenenza e autorizzazioni →
Scopri le concessioni di capacità, gli spazi di lavoro, la proprietà e le conferme.
Claude, ChatGPT e Codex →
Scarica i file di configurazione e il pacchetto plugin in due formati.
Autenticazione →
Scegli OAuth o l’accesso con chiave API solo per i calcoli.