Verbinde deinen Agenten in vier Schritten.
Für Claude, ChatGPT oder Codex wird OAuth empfohlen, da es sicher die für den angemeldeten Benutzer zulässigen HumanDesign.ai-Tools verfügbar machen kann.
1. Gehosteten Endpunkt hinzufügen
Endpunkt
https://mcp.humandesign.ai/Wähle Remote HTTP oder Streamable HTTP. Füge /mcp nicht erneut hinzu: Der kanonische Endpunkt ist die Domainwurzel.
2. Authentifizieren
Verwende im Client die MCP-Aktion Authenticate oder Connect und melde dich im Browser bei HumanDesign.ai an. Claude-Code-Benutzer können claude mcp login human-design-aiausführen; Codex-Benutzer können codex mcp login human_design_ai.
Wenn du nur die sechs Berechnungs- und Referenztools benötigst, ist weiterhin ein API-Schlüssel über Bearer- oder X-Api-Key Authentifizierung verfügbar.
3. Tools entdecken
JSON-RPC
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/list",
"params": {}
}Die Erkennung ist kostenlos. Die OAuth-Tool-Sichtbarkeit richtet sich nach serverseitigen Fähigkeitsfreigaben, der Mitgliedschaft Free/Individual/Personal/Pro, der Arbeitsbereichsrolle, dem Eigentum und den Produktberechtigungen. Die Sichtbarkeit über API-Schlüssel folgt dem separaten API-Plan Free/Creator/Startup/Business.
4. Beginne mit deinem primären Chart
Bitte den Agenten, aufzurufen chart_get_primary. Falls kein primäres Chart vorhanden ist, können Mitglieder von Free, Individual, Personal und Pro chart_generate: Prüfe zuerst die normalisierten Geburtsangaben und die Vorschau über eine Einheit. Bestätige anschließend die Ausführung. Das gespeicherte Chart wird anhand des Kontoeigentums ermittelt, niemals über eine Namenssuche wie „Kyle“ oder „Mein Chart“. Um autorisierte Charts anderer Personen zu lesen, ist Personal oder Pro erforderlich.
Verbindung, initialize, ping, tools/list, Bibliothekszugriffe, Statusprüfungen und das Rendern vorhandener Charts verbrauchen keine Credits. Die Berechnung eines neuen primären Charts verbraucht genau eine Berechnungseinheit; das Rendern kostet keine weitere Einheit.
So funktionieren zuverlässige Berechnungen
Der Agent berechnet das Chart nicht selbst. HumanDesign.ai validiert Datum, Ort, IANA-Zeitzone und Sommerzeitkontext, bevor das Kontingent verbraucht wird, und gibt anschließend das versionierte Ergebnis des Berechnungsdienstes zurück. Mehrdeutige Orte und ungültige Eingaben erzeugen einen eindeutigen Fehler, ohne eine Einheit zu verbrauchen. Ist die Geburtszeit unbekannt, vermerkt der Dienst lokale Mittagszeit und weist darauf hin, dass zeitabhängige Chartdetails abweichen können.
Sichere Wiederholungen von Berechnungen
Die kontingentverbrauchenden MCP-Tools generate_chart, generate_composite_chartund get_transits benötigen einen idempotencyKey. Verwende für einen vorgesehenen erneuten Versuch denselben Schlüssel mit identischen normalisierten Argumenten und für neue Arbeiten einen neuen Schlüssel. Ein übereinstimmender erneuter Versuch verbraucht kein zusätzliches Kontingent und kann das Ergebnis deterministisch neu berechnen; er ist keine bytegenaue Wiedergabe einer gespeicherten Antwort. MCP-Transitaufrufe benötigen ein explizites Datum, damit ein erneuter Versuch immer denselben Zeitpunkt betrifft. Direkte REST- und Agent-HTTP-Clients können Idempotency-Key bei unterstützten begrenzten Nicht-Streaming-Vorgängen senden. Während der Kompatibilitätsumstellung bleibt dies optional; Aufrufe ohne den Schlüssel können einen Transportwiederholungsversuch nicht deduplizieren. Batch- und SSE-Aufrufe lehnen vom Aufrufer angegebene Wiederholungsschlüssel ab und fallen nicht unter diese Deduplizierungsvereinbarung.
Rohprotokoll testen
Entwickler mit API-Schlüssel können ein Berechnungstool direkt initialisieren und aufrufen:
Initialisieren
{
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {
"protocolVersion": "2025-11-25",
"capabilities": {},
"clientInfo": {
"name": "my-agent",
"version": "1.0.0"
}
}
}Berechnungsaufruf
{
"jsonrpc": "2.0",
"id": 3,
"method": "tools/call",
"params": {
"name": "generate_chart",
"arguments": {
"birthDateTime": "1990-05-15T14:30:00",
"timezone": "America/New_York",
"detailLevel": "core",
"idempotencyKey": "chart-1990-05-15-v1"
}
}
}Wähle deinen Client
Claude · Codex · Cursor · VS Code · Plugin-Downloads