Mit HumanDesign.ai MCP verbinden
Bevor Sie beginnen
HumanDesign.ai MCP stellt kompatiblen KI-Clients strukturierte Human-Design-Tools bereit. Diese Anleitung behandelt den Berechnungs- und Referenzkatalog, der einen API-Schlüssel verwendet. Wenn Ihr Client die HumanDesign.ai-OAuth-Verbindung unterstützt, nutzen Sie diesen Ablauf für kontogebundene Funktionen wie gespeicherte Plattformdaten. OAuth-Berechtigungen und Verfügbarkeit werden bei der Anmeldung festgelegt.
Der kanonische MCP-Endpunkt lautet https://mcp.humandesign.ai/. Verwenden Sie POST / für MCP-Anfragen. GET / ist kein Verbindungstest und gibt 405 Method Not Allowed. POST /mcp ist ein Kompatibilitätsalias.
API-Schlüssel sicher hinzufügen
Verwenden Sie einen dieser Anfrage-Header. Fügen Sie einen API-Schlüssel nicht in eine URL ein, übertragen Sie ihn nicht in ein Repository und senden Sie ihn nicht in einem Chat.
Authorization: Bearer YOUR_HDAI_API_KEY
oder:
X-Api-Key: YOUR_HDAI_API_KEY
Verbinden und Tools entdecken
- Konfigurieren Sie Ihren MCP-Client mit
https://mcp.humandesign.ai/. - Senden Sie
initializemit der Protokollversion2025-11-25. - Senden Sie
notifications/initialized. - Rufen Sie
tools/listauf und verwenden Sie nur die Tools, die für Ihren Schlüssel zurückgegeben werden.
{
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {
"protocolVersion": "2025-11-25",
"capabilities": {},
"clientInfo": { "name": "your-client", "version": "1.0.0" }
}
}
Entdeckungsaufrufe wie initialize, pingund tools/list verbrauchen kein Berechnungskontingent. Ein erfolgreicher Aufruf von tools/call verbraucht eine gemeinsame API-Einheit; Validierungsfehler und nicht verfügbare Tools verbrauchen keine.
Ein Tool aufrufen
Verwenden Sie den Tool-Namen und das Eingabeschema, die von tools/listzurückgegeben werden. Eine Anfrage für einen Basis-Chart sieht beispielsweise so aus:
{
"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"
}
}
}
Ergebnis lesen
Erfolgreiche Aufrufe geben eine kurze lesbare Zusammenfassung, einen JSON-Textblock und structuredContentzurück. Die strukturierte Antwort verwendet eine versionierte Hülle mit version, tool, data, metaKontingentmetadaten error sowie einem optionalen Feld.
Der aktuelle Berechnungs- und Referenzkatalog stellt ausschließlich Tools bereit. Erwarten Sie darin keine MCP-Prompts, MCP-Ressourcen, Tools zur Berichtserstellung, Serversitzungen oder Chart-Bildblöcke.