HumanDesign.aiPersonalDeschide aplicația ↗
PENTRU DVS.Centru de ajutor

Conectați‑vă la HumanDesign.ai MCP

APIActualizat la 28 aug. 20262 min de citire

Înainte de a începe

HumanDesign.ai MCP oferă clienților AI compatibili instrumente structurate Human Design. Acest ghid prezintă catalogul de calcul și referință care folosește o cheie API. Dacă clientul dumneavoastră acceptă conexiunea OAuth HumanDesign.ai, folosiți acel flux când aveți nevoie de acces conectat la cont, de exemplu la datele salvate pe platformă; permisiunile OAuth și disponibilitatea se aleg la autentificare.

Endpointul MCP canonic este https://mcp.humandesign.ai/. Folosiți POST / pentru solicitările MCP. GET / nu este un test de conexiune și returnează 405 Method Not Allowed. POST /mcp este un alias de compatibilitate.

Adăugați cheia API în siguranță

Folosiți unul dintre aceste antete de solicitare. Nu introduceți cheia API într-un URL, nu o adăugați în controlul versiunilor și nu o copiați într-un chat.

Authorization: Bearer YOUR_HDAI_API_KEY

sau:

X-Api-Key: YOUR_HDAI_API_KEY

Conectați-vă și descoperiți instrumentele

  1. Configurați clientul MCP cu https://mcp.humandesign.ai/.
  2. Trimiteți initialize cu versiunea de protocol 2025-11-25.
  3. Trimiteți notifications/initialized.
  4. Apelați tools/list și folosiți numai instrumentele returnate pentru cheia dumneavoastră.
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-11-25",
    "capabilities": {},
    "clientInfo": { "name": "your-client", "version": "1.0.0" }
  }
}

Apelurile de descoperire precum initialize, ping, iar tools/list nu consumă cotă de calcul. Un apel tools/call reușit consumă o unitate API comună; erorile de validare și instrumentele indisponibile nu consumă unități.

Apelați un instrument

Folosiți numele instrumentului și schema de intrare returnate de tools/list. De exemplu, o solicitare pentru o diagramă core are această structură:

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

Citiți rezultatul

Apelurile reușite returnează un rezumat ușor de citit, un bloc de text JSON și structuredContent. Răspunsul structurat folosește un format versionat cu version, tool, data, metași un câmp error opțional.

Catalogul actual de calcul și referință oferă doar instrumente. Nu vă așteptați la prompturi MCP, resurse MCP, instrumente de generare a rapoartelor, sesiuni pe server sau blocuri de imagini ale diagramelor din acest catalog.

Înapoi sus ↑Ai nevoie de ajutor? Contactează echipa de asistență ↗

Găsește următorul răspuns.