Conectați agentul în patru pași.
Pentru Claude, ChatGPT sau Codex, metoda recomandată este conexiunea OAuth, deoarece poate expune în siguranță instrumentele HumanDesign.ai permise utilizatorului autentificat.
1. Adăugați endpointul găzduit
Endpoint
https://mcp.humandesign.ai/Alegeți HTTP la distanță sau Streamable HTTP. Nu adăugați din nou /mcp ; endpointul oficial este domeniul rădăcină.
2. Autentificați-vă
Folosiți acțiunea Authenticate sau Connect din clientul MCP și finalizați autentificarea HumanDesign.ai în browser. Utilizatorii Claude Code pot executa claude mcp login human-design-ai; utilizatorii Codex pot executa codex mcp login human_design_ai.
Dacă aveți nevoie doar de cele șase instrumente de calcul și referință, cheia API este disponibilă în continuare prin autentificare Bearer sau X-Api-Key .
3. Descoperiți instrumentele
JSON-RPC
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/list",
"params": {}
}Descoperirea este gratuită. Vizibilitatea instrumentelor OAuth respectă permisiunile acordate de server pentru utilizator, abonamentul Free/Individual/Personal/Pro, rolul în spațiul de lucru, proprietatea și drepturile produsului. Vizibilitatea cu cheie API respectă planul API separat Free/Creator/Startup/Business.
4. Începeți cu diagrama principală
Solicitați agentului să apeleze chart_get_primary. Dacă nu există o diagramă principală, membrii Free, Individual, Personal și Pro pot folosi chart_generate: examinați mai întâi datele de naștere normalizate și previzualizarea de o unitate, apoi confirmați execuția. Diagrama salvată este identificată pe baza proprietății contului, nu prin căutarea unui nume precum „Kyle” sau „My Chart”. Citirea diagramelor autorizate ale altor persoane necesită Personal sau Pro.
Conectarea, initialize, ping, tools/list, citirea bibliotecii, verificările de stare și redarea diagramelor existente nu consumă credite. Calcularea unei noi diagrame principale consumă exact o unitate de calcul; redarea acesteia nu adaugă o a doua taxă.
Cum funcționează încrederea în calcule
Agentul nu calculează singur diagrama. HumanDesign.ai validează data, locația, fusul orar IANA și contextul orei de vară înainte de consumarea cotei, apoi returnează rezultatul versionat de serviciul său de calcul. Locațiile ambigue și datele nevalide returnează o eroare clară fără să consume unități. Dacă ora nașterii nu este cunoscută, serviciul înregistrează folosirea orei locale 12:00 și avertizează că detaliile diagramei sensibile la oră pot fi diferite.
Reîncercări sigure de calcul
Instrumentele MCP care consumă cotă generate_chart, generate_composite_chart, iar get_transits necesită o idempotencyKey. Reutilizați aceeași cheie cu argumente normalizate identice pentru o singură reîncercare intenționată și folosiți o cheie nouă pentru lucrări noi. O reîncercare potrivită nu consumă cotă suplimentară și poate recalcula determinist rezultatul; nu redă octet cu octet un răspuns stocat. Apelurile MCP pentru tranzite necesită o dată explicită, astfel încât fiecare reîncercare să se refere la același moment. Clienții REST și Agent HTTP direcți pot trimite Idempotency-Key pentru operațiunile acceptate, limitate și fără flux continuu; este opțională în timpul lansării compatibile, astfel că apelurile fără aceasta nu pot deduplica o reîncercare de transport. Procesarea în lot și SSE resping cheile de reîncercare furnizate de apelant și nu fac parte din acest contract de deduplicare.
Testarea protocolului brut
Dezvoltatorii care folosesc o cheie API pot inițializa conexiunea și apela direct un instrument de calcul:
Inițializare
{
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {
"protocolVersion": "2025-11-25",
"capabilities": {},
"clientInfo": {
"name": "my-agent",
"version": "1.0.0"
}
}
}Apel de calcul
{
"jsonrpc": "2.0",
"id": 3,
"method": "tools/call",
"params": {
"name": "generate_chart",
"arguments": {
"birthDateTime": "1990-05-15T14:30:00",
"timezone": "America/New_York",
"detailLevel": "core",
"idempotencyKey": "chart-1990-05-15-v1"
}
}
}Alegeți clientul
Claude · Codex · Cursor · VS Code · Descărcări pluginuri