Connettiti a MCP di HumanDesign.ai
Prima di iniziare
HumanDesign.ai MCP offre strumenti strutturati di Human Design ai client IA compatibili. Questa guida illustra i calcoli e il catalogo di riferimento che utilizza una chiave API. Se il client supporta la connessione OAuth HumanDesign.ai, usala quando hai bisogno di funzionalità collegate all’account, come i dati salvati sulla piattaforma; i permessi e la disponibilità OAuth vengono scelti durante l’accesso.
L’endpoint MCP canonico è https://mcp.humandesign.ai/. Usa POST / per le richieste MCP. GET / non è un test di connessione e restituisce 405 Method Not Allowed. POST /mcp è un alias per la compatibilità.
Aggiungi la chiave API in modo sicuro
Usa una di queste intestazioni di richiesta. Non inserire la chiave API in un URL, non caricarla in un repository e non incollarla in una chat.
Authorization: Bearer YOUR_HDAI_API_KEY
oppure:
X-Api-Key: YOUR_HDAI_API_KEY
Connettiti e scopri gli strumenti
- Configura il client MCP con
https://mcp.humandesign.ai/. - Invia
initializecon la versione del protocollo2025-11-25. - Invia
notifications/initialized. - Chiama
tools/liste usa solo gli strumenti restituiti per la tua chiave.
{
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {
"protocolVersion": "2025-11-25",
"capabilities": {},
"clientInfo": { "name": "your-client", "version": "1.0.0" }
}
}
Le chiamate di individuazione, come initialize, pinge tools/list non consumano la quota di calcolo. Una chiamata riuscita a tools/call consuma un’unità API condivisa; gli errori di convalida e gli strumenti non disponibili non ne consumano.
Chiama uno strumento
Usa il nome dello strumento e lo schema di input restituiti da tools/list. Ad esempio, una richiesta per un grafico principale ha questa forma:
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "generate_chart",
"arguments": {
"birthDateTime": "1990-05-15T14:30:00",
"timezone": "America/New_York",
"detailLevel": "core"
}
}
}
Leggi il risultato
Le chiamate riuscite restituiscono un breve riepilogo leggibile, un blocco di testo JSON e structuredContent. La risposta strutturata utilizza un contenitore versionato con version, tool, data, metae un campo error facoltativo.
Il catalogo attuale di calcoli e riferimenti espone solo strumenti. Non aspettarti prompt MCP, risorse MCP, strumenti per generare report, sessioni del server o blocchi di immagini dei grafici da questo catalogo.