HumanDesign.aiMCPApri l'app ↗
PER LA TUA IAProdotto e azienda
Domande frequenti

Risposte chiare sul server MCP attivo.

Il trasporto MCP canonico è l’endpoint radice all’indirizzo https://mcp.humandesign.ai/. L’autorità di calcolo rimane l’API HumanDesign.ai.

Che cos’è Human Design MCP?

È l’interfaccia ufficiale per agenti remoti di HumanDesign.ai. I client AI compatibili possono usare strumenti per gli account basati sull’iscrizione tramite OAuth oppure sei strumenti di calcolo e riferimento tramite chiave API.

È un motore di calcolo Human Design separato?

No. MCP, Agent HTTP, REST e HumanDesign.ai delegano il calcolo dei grafici allo stesso servizio autorevole. OAuth e le chiavi API espongono funzionalità diverse, ma le versioni di calcolo e le decisioni sulle quote sono centralizzate.

Cosa rende affidabili i dati del grafico?

Prima del calcolo, il servizio convalida i dati di nascita, la località, il fuso orario IANA e il contesto dell’ora legale; restituisce un risultato strutturato e versionato e rifiuta input ambigui o non validi prima di addebitare. Agli agenti viene indicato di non approssimare i calcoli dei grafici.

Come deve formattare un agente la data e l’ora di nascita?

Come ora locale dell’orologio: esattamente come appariva sull’orologio nel luogo di nascita, senza Z né offset UTC, indicando il fuso separatamente nel campo timezone come identificatore IANA. "birthDateTime": "1990-05-15T14:30:00" con "timezone": "America/New_York" significa le due e trenta del pomeriggio a New York. Un valore con Z o un offset non identifica da solo un’ora locale e il fuso usato per interpretarlo cambia il grafico. Non convertire mai l’ora di nascita in UTC prima di inviarla.

Il mio client invia Z o un offset UTC. Si interromperà?

Non ancora. MCP inoltra il valore e l’API lo accetta ancora, interpretandolo come UTC e segnalando la deprecazione nella risposta. Questi valori non saranno più accettati e la data sarà annunciata in anticipo. Il passaggio a un’ora locale senza suffissi e a un fuso orario IANA è la modifica più sicura; se il valore non indicava davvero UTC, corregge anche il grafico.

Quanti strumenti di calcolo sono disponibili?

Sei: resolve_timezone, generate_chart, generate_composite_chart, get_reference_item, get_transits e search_celebrities. OAuth aggiunge un catalogo account filtrato in base a iscrizione, titolarità, ruolo, autorizzazioni alle funzionalità concesse dal server e diritti di accesso.

Quali client possono connettersi?

Può connettersi qualsiasi client MCP compatibile con Streamable HTTP. La documentazione include guide per Claude, ChatGPT, Codex, Cursor e VS Code.

Cosa consuma la quota di calcolo?

generate_chart, generate_composite_chart e get_transits consumano ciascuno un’unità quando una richiesta convalidata raggiunge il calcolo. resolve_timezone, get_reference_item, search_celebrities, initialize, ping, tools/list, input non validi, accessi negati, letture della libreria, controlli dello stato e visualizzazione di un grafico esistente non consumano nulla.

Come funzionano i nuovi tentativi sicuri di calcolo?

I tre strumenti MCP che consumano quota richiedono una idempotencyKey stabile. Riutilizzala solo con gli stessi argomenti normalizzati per un singolo tentativo previsto. Una corrispondenza non consuma ulteriore quota e può ricalcolare il risultato in modo deterministico; non riproduce byte per byte una risposta memorizzata. Anche le chiamate MCP ai transiti richiedono una data esplicita.

Un membro Free di HumanDesign.ai può creare un grafico?

Sì. OAuth consente a un membro Free di visualizzare un’anteprima, confermare, creare, salvare, visualizzare e generare il proprio grafico principale. Il nuovo calcolo usa esattamente un’unità e la generazione non comporta un secondo addebito.

Può creare grafici compositi?

La superficie di calcolo con chiave API può generare un nuovo grafico composito di due persone. Gli account OAuth idonei possono recuperare e generare compositi salvati e autorizzati. Il server applica sempre i limiti di titolarità e iscrizione.

Cosa succede quando un’immagine non può essere visualizzata in linea?

Prima di confermare il successo, il server verifica il PNG o SVG e restituisce anche un link sicuro per il download, valido per breve tempo, come alternativa.

Dove posso gestire accesso e fatturazione?

Accedi a HumanDesign.ai per gestire l’iscrizione alla piattaforma e l’account, oppure a my.humandesign.ai per chiavi API, utilizzo del piano API e fatturazione.

Hai bisogno di aiuto con l’account? Visita my.humandesign.ai.

Torna all'inizio ↑Ti serve aiuto? Contatta l'assistenza ↗

Trova la prossima risposta.