Una connessione MCP, quattro superfici per agenti.
Usa direttamente l’endpoint ospitato, scarica i file di progetto per Claude Code oppure installa il pacchetto plugin a doppio formato, preparato per Claude Code e per il sistema universale di plugin ChatGPT/Codex.
Claude Code: configurazione più rapida
CLAUDE.md è una guida, non un programma di installazione. Claude Code deve avere una sessione attiva e un server MCP limitato al progetto .mcp.json deve essere considerato attendibile prima di avviare MCP OAuth.
- Apri la directory del progetto ed esegui
claude. - Se Claude Code indica che la sessione è scaduta, esegui
/login. - Approva il progetto e il suo
.mcp.jsonquando richiesto. - Esegui
/mcp, selezionahuman-design-aie completa l’accesso OAuth a HumanDesign.ai.
In alternativa, dopo aver effettuato l’accesso a Claude Code, aggiungi la connessione a livello utente:
claude mcp add --transport http --scope user human-design-ai https://mcp.humandesign.ai/
claude mcp login human-design-aiPer un progetto condiviso, salva quanto segue come .mcp.json nella cartella principale del progetto.
.mcp.json
{
"mcpServers": {
"human-design-ai": {
"type": "http",
"url": "https://mcp.humandesign.ai/"
}
}
}Claude.ai e Claude Desktop
- Apri Personalizza → Connettori.
- Seleziona Aggiungi connettore personalizzato.
- Usa
https://mcp.humandesign.ai/come URL MCP remoto. - Seleziona Collega e completa l’accesso OAuth a HumanDesign.ai.
- Attiva HumanDesign.ai dal menu dei connettori in una conversazione.
I proprietari Team ed Enterprise aggiungono prima il connettore nelle impostazioni dell’organizzazione; poi ogni membro collega il proprio account HumanDesign.ai.
Codex
~/.codex/config.toml
[mcp_servers.human_design_ai]
url = "https://mcp.humandesign.ai/"
auth = "oauth"
startup_timeout_sec = 30
tool_timeout_sec = 60Autenticati
codex mcp login human_design_aiChatGPT
- Attiva la modalità sviluppatore in Impostazioni → Sicurezza e accesso.
- Apri Plugin, seleziona il pulsante più e aggiungi l’URL MCP remoto
https://mcp.humandesign.ai/. - Esamina gli strumenti individuati e completa l’autenticazione OAuth.
- Abilita la connessione in una nuova conversazione Work e prova prima richieste rappresentative di sola lettura.
Cosa include il plugin
Il pacchetto include i manifesti plugin di Claude e OpenAI, la definizione MCP remota, risorse di branding e una skill di flusso di lavoro che insegna all’agente a usare grafici individuali e compositi relazionali salvati, renderizzare bodygraph autorizzati, rispettare i limiti Free, Individual, Personal e Pro e gestire in sicurezza conferme, idempotenza e segreti.
Grafici relazionali compositi
Con OAuth, i membri Personal e Pro possono recuperare e renderizzare i compositi salvati a cui sono autorizzati ad accedere. La creazione di un nuovo composito da due set di dati di nascita usa la superficie di calcolo separata e richiede quindi una chiave API HumanDesign.ai protetta; dopo la convalida consuma un’unità di calcolo. Il server attivo applica sempre le regole di proprietà, consenso, appartenenza, tipo di credenziale e quota.
Perché collegare un abbonamento?
Free offre a ogni membro un punto di partenza affidabile con il proprio grafico, mentre Individual aggiunge visibilità sull’utilizzo dell’account mantenendo lo stesso limite sul grafico personale. Personal apre l’accesso a una libreria più ampia di grafici autorizzati e compositi salvati, report di proprietà, professionisti, apprendimento nella community e contatti con persone che esplorano modelli di design simili. Pro estende tutto agli spazi di lavoro professionali. Gli strumenti Website Builder vengono mostrati solo se HumanDesign.ai ha abilitato Builder per il tuo account e soltanto quando tools/list li elenca. Le iscrizioni a HumanDesign.ai offrono anche un’esperienza più approfondita nella piattaforma, comprese le funzioni di transito idonee; lo strumento di calcolo MCP separato get_transits richiede una chiave API Startup o superiore. Le indicazioni scaricabili per l’agente restano neutrali: spiegano una volta la mancanza di un’autorizzazione e seguono il catalogo attivo, invece di inserire continue promozioni di upgrade nelle conversazioni.
Installare un plugin non aggira l’autorizzazione HumanDesign.ai. Il server restituisce solo gli strumenti consentiti per l’account connesso. Non incollare mai token OAuth o chiavi API in un prompt.