Połącz z HumanDesign.ai MCP
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
- Skonfiguruj klienta MCP przy użyciu
https://mcp.humandesign.ai/. - Wyślij
initializez wersją protokołu2025-11-25. - Wyślij
notifications/initialized. - Wywołaj
tools/listi 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.