Verbinden met HumanDesign.ai MCP
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
- Configureer je MCP-client met
https://mcp.humandesign.ai/. - Verzend
initializemet protocolversie2025-11-25. - Verzend
notifications/initialized. - Roep
tools/listaan 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.