HumanDesign.aiPersonalApp openen ↗
VOOR JEZELFHelpcentrum

Verbinden met HumanDesign.ai MCP

APIBijgewerkt op 28 aug. 2026Leestijd 2 min.

Voordat je begint

HumanDesign.ai MCP biedt compatibele AI-clients gestructureerde Human Design-tools. Deze handleiding behandelt de berekenings- en referentiecatalogus die een API-sleutel gebruikt. Als je client de OAuth-verbinding van HumanDesign.ai ondersteunt, gebruik die dan wanneer je toegang nodig hebt die aan je account is gekoppeld, zoals opgeslagen platformgegevens. OAuth-machtigingen en beschikbaarheid kies je tijdens het aanmelden.

Het canonieke MCP-eindpunt is https://mcp.humandesign.ai/ . Gebruik POST / voor MCP-aanvragen. GET / is geen verbindingstest en retourneert 405 Method Not Allowed. POST /mcp is een compatibiliteitsalias.

Voeg je API-sleutel veilig toe

Gebruik een van deze aanvraagheaders. Plaats een API-sleutel niet in een URL, commit deze niet in een repository en plak hem niet in een chat.

Authorization: Bearer YOUR_HDAI_API_KEY

of:

X-Api-Key: YOUR_HDAI_API_KEY

Verbind je tools en ontdek ze

  1. Configureer je MCP-client met https://mcp.humandesign.ai/.
  2. Verzend initialize met protocolversie 2025-11-25.
  3. Verzend notifications/initialized.
  4. Roep tools/list aan en gebruik alleen de tools die voor jouw sleutel worden geretourneerd.
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-11-25",
    "capabilities": {},
    "clientInfo": { "name": "your-client", "version": "1.0.0" }
  }
}

Ontdekkingsaanroepen zoals initialize, ping, en tools/list verbruiken geen berekeningsquotum. Een geslaagde tools/call verbruikt één gedeelde API-eenheid; validatiefouten en niet-beschikbare tools verbruiken niets.

Een tool aanroepen

Gebruik de toolnaam en het invoerschema dat wordt geretourneerd door tools/list . Een kernverzoek voor een diagram heeft bijvoorbeeld deze vorm:

{
  "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"
    }
  }
}

Het resultaat bekijken

Geslaagde aanroepen retourneren een korte, leesbare samenvatting, een JSON-tekstblok en structuredContent . Het gestructureerde antwoord gebruikt een versiegebonden envelop met version, tool, data, metaen een optioneel error -veld.

De huidige catalogus voor berekeningen en referenties bevat alleen tools. Verwacht geen MCP-prompts, MCP-resources, rapportgeneratietools, serversessies of afbeeldingsblokken voor diagrammen uit deze catalogus.

Terug naar boven ↑Hulp nodig? Neem contact op met support ↗

Vind je volgende antwoord.