HumanDesign.aiPersonalOtwórz aplikację ↗
DLA CIEBIECentrum pomocy

Połącz z HumanDesign.ai MCP

APIAktualizacja: 28 sierpnia 2026 r.2 min czytania

Zanim zaczniesz

MCP HumanDesign.ai udostępnia zgodnym klientom AI uporządkowane narzędzia Human Design. Ten przewodnik omawia katalog obliczeń i danych referencyjnych korzystający z klucza API. Jeśli Twój klient obsługuje połączenie OAuth HumanDesign.ai, wybierz tę metodę, gdy potrzebujesz dostępu powiązanego z kontem, na przykład do zapisanych danych platformy. Uprawnienia OAuth i dostępne funkcje wybiera się podczas logowania.

Kanoniczny punkt końcowy MCP to https://mcp.humandesign.ai/ . Użyj POST / do żądań MCP. GET / nie jest testem połączenia i zwraca 405 Method Not Allowed. POST /mcp jest aliasem zgodności.

Bezpiecznie dodaj klucz API

Użyj jednego z tych nagłówków żądania. Nie umieszczaj klucza API w adresie URL, repozytorium ani wiadomości na czacie.

Authorization: Bearer YOUR_HDAI_API_KEY

lub:

X-Api-Key: YOUR_HDAI_API_KEY

Połącz i odkryj dostępne narzędzia

  1. Skonfiguruj klienta MCP przy użyciu https://mcp.humandesign.ai/.
  2. Wyślij initialize z wersją protokołu 2025-11-25.
  3. Wyślij notifications/initialized.
  4. Wywołaj tools/list i korzystaj wyłącznie z narzędzi zwróconych dla Twojego klucza.
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-11-25",
    "capabilities": {},
    "clientInfo": { "name": "your-client", "version": "1.0.0" }
  }
}

Wywołania wyszukiwania, takie jak initialize, ping, a także tools/list nie zużywają limitu obliczeń. Pomyślne tools/call zużywa jedną wspólną jednostkę API; błędy walidacji i niedostępne narzędzia nie zużywają żadnej.

Wywołaj narzędzie

Użyj nazwy narzędzia i schematu danych wejściowych zwróconego przez tools/list. Na przykład podstawowe żądanie wykresu ma następującą postać:

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

Odczytaj wynik

Pomyślne wywołania zwracają krótkie czytelne podsumowanie, blok tekstu JSON oraz structuredContent. Uporządkowana odpowiedź korzysta z wersjonowanej koperty zawierającej version, tool, data, metai opcjonalne pole error .

Obecny katalog obliczeń i danych referencyjnych udostępnia wyłącznie narzędzia. Nie oczekuj z tego katalogu promptów ani zasobów MCP, narzędzi do tworzenia raportów, sesji serwera ani bloków obrazów wykresów.

Wróć na górę ↑Potrzebujesz pomocy? Skontaktuj się z pomocą techniczną ↗

Znajdź kolejną odpowiedź.