Koble til HumanDesign.ai MCP
Før du begynner
HumanDesign.ai MCP gir kompatible AI-klienter strukturerte Human Design-verktøy. Denne veiledningen dekker beregnings- og referansekatalogen som bruker en API-nøkkel. Hvis klienten din støtter HumanDesign.ai OAuth-tilkobling, kan du bruke den for kontotilknyttet tilgang, for eksempel lagrede plattformdata. OAuth-tillatelser og tilgjengelighet velges under innlogging.
Det kanoniske MCP-endepunktet er https://mcp.humandesign.ai/ . Bruk POST / for MCP-forespørsler. GET / er ikke en tilkoblingstest og returnerer 405 Method Not Allowed. POST /mcp er et kompatibilitetsalias.
Legg til API-nøkkelen på en sikker måte
Bruk en av disse forespørselshodene. Ikke legg API-nøkkelen i en URL, i et kodearkiv eller i en chat.
Authorization: Bearer YOUR_HDAI_API_KEY
eller:
X-Api-Key: YOUR_HDAI_API_KEY
Koble til og finn verktøyene dine
- Konfigurer MCP-klienten med
https://mcp.humandesign.ai/. - Send
initializemed protokollversjon2025-11-25. - Send
notifications/initialized. - Kall
tools/listog bruk bare verktøyene som returneres for nøkkelen din.
{
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {
"protocolVersion": "2025-11-25",
"capabilities": {},
"clientInfo": { "name": "your-client", "version": "1.0.0" }
}
}
Oppdagelseskall som initialize, ping, og tools/list bruker ikke beregningskvoten. Et vellykket tools/call bruker én delt API-enhet; valideringsfeil og utilgjengelige verktøy gjør ikke det.
Kall et verktøy
Bruk verktøynavnet og inndataskjemaet som returneres av tools/list . En grunnleggende diagramforespørsel ser for eksempel slik ut:
{
"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"
}
}
}
Les resultatet
Vellykkede kall returnerer et kort, lesbart sammendrag, en JSON-tekstblokk og structuredContent . Det strukturerte svaret bruker en versjonsstyrt konvolutt med version, tool, data, metaog et valgfritt error -felt.
Den gjeldende katalogen for beregning og referanser inneholder bare verktøy. Ikke forvent MCP-ledetekster, MCP-ressurser, rapportgenereringsverktøy, serversesjoner eller bildefelt for diagrammer fra denne katalogen.