HumanDesign.aiPersonalApp öffnen ↗
FÜR DICHHilfe-Center

Mit HumanDesign.ai MCP verbinden

APIAktualisiert am 28. August 20262 Min. Lesezeit

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

  1. Konfigurieren Sie Ihren MCP-Client mit https://mcp.humandesign.ai/.
  2. Senden Sie initialize mit der Protokollversion 2025-11-25.
  3. Senden Sie notifications/initialized.
  4. Rufen Sie tools/list auf 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.

Zurück nach oben ↑Brauchst du Hilfe? Support kontaktieren ↗

Finde deine nächste Antwort.