HumanDesign.aiPersonalÅpne appen ↗
FOR DEG SELVHjelpesenter

Koble til HumanDesign.ai MCP

APIOppdatert 28. aug. 20262 min lesing

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

  1. Konfigurer MCP-klienten med https://mcp.humandesign.ai/.
  2. Send initialize med protokollversjon 2025-11-25.
  3. Send notifications/initialized.
  4. Kall tools/list og 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.

Til toppen ↑Trenger du hjelp? Kontakt kundestøtte ↗

Finn ditt neste svar.