HumanDesign.aiMCPOtwórz aplikację ↗
DLA TWOJEJ SZTUCZNEJ INTELIGENCJIDokumentacja
Szybki start

Połącz agenta w czterech krokach.

W przypadku Claude, ChatGPT lub Codex zalecanym sposobem połączenia jest OAuth, który może bezpiecznie udostępniać dozwolone narzędzia HumanDesign.ai zalogowanego użytkownika.

1. Dodaj hostowany punkt końcowy

Punkt końcowy

https://mcp.humandesign.ai/

Wybierz zdalny HTTP lub Streamable HTTP. Nie dodawaj ponownie /mcp : kanonicznym punktem końcowym jest główna domena.

2. Uwierzytelnij się

Użyj w kliencie opcji MCP Authenticate lub Connect i dokończ logowanie HumanDesign.ai w przeglądarce. Użytkownicy Claude Code mogą uruchomić claude mcp login human-design-ai, a użytkownicy Codex mogą uruchomić codex mcp login human_design_ai.

Jeśli potrzebujesz tylko sześciu narzędzi obliczeniowych i referencyjnych, nadal możesz użyć klucza API przez uwierzytelnianie Bearer lub X-Api-Key .

3. Wykryj dostępne narzędzia

JSON-RPC

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/list",
  "params": {}
}

Wyszukiwanie narzędzi jest bezpłatne. Widoczność narzędzi OAuth zależy od uprawnień nadanych przez serwer, członkostwa Free/Individual/Personal/Pro, roli w przestrzeni roboczej, własności i uprawnień produktu. Widoczność narzędzi z kluczem API zależy od odrębnego planu API Free/Creator/Startup/Business.

4. Zacznij od wykresu głównego

Poproś agenta o wywołanie chart_get_primary. Jeśli nie ma wykresu głównego, członkowie Free, Individual, Personal i Pro mogą użyć chart_generate: najpierw sprawdź jego znormalizowane dane o urodzeniu i podgląd za jedną jednostkę, a następnie potwierdź obliczenie. Zapisany wykres jest wyszukiwany na podstawie własności konta, nigdy po imieniu takim jak „Kyle” lub „My Chart”. Odczyt autoryzowanych wykresów innych osób wymaga Personal lub Pro.

Połączenie, initialize, ping, tools/list, odczyt biblioteki, sprawdzanie statusu i renderowanie istniejących wykresów nie zużywają kredytów. Obliczenie nowego wykresu głównego zużywa dokładnie jedną jednostkę obliczeniową; renderowanie nie powoduje drugiej opłaty.

Jak działa wiarygodność obliczeń

Agent nie oblicza wykresu samodzielnie. HumanDesign.ai sprawdza datę, lokalizację, strefę czasową IANA i kontekst zmiany czasu letniego przed zużyciem limitu, a następnie zwraca wersjonowany wynik ze swojej usługi obliczeniowej. Niejednoznaczne lokalizacje i nieprawidłowe dane powodują wyświetlenie jasnego komunikatu o błędzie bez zużycia jednostki. Jeśli godzina urodzenia jest nieznana, usługa zapisuje, że użyto lokalnego południa, i ostrzega, że szczegóły wykresu zależne od czasu mogą się różnić.

Bezpieczne ponawianie obliczeń

Narzędzia MCP zużywające limit generate_chart, generate_composite_chart, a także get_transits wymagają idempotencyKey. Do jednej planowanej ponownej próby użyj tego samego klucza i identycznych znormalizowanych argumentów; do nowych działań użyj nowego klucza. Dopasowana ponowna próba nie zużywa dodatkowego limitu i może deterministycznie przeliczyć wynik; nie odtwarza bajt po bajcie zapisanej odpowiedzi. Wywołania tranzytów MCP wymagają jawnej daty, aby ponowienie zawsze dotyczyło tego samego momentu. Klienci bezpośredniego REST i Agent HTTP mogą przesyłać Idempotency-Key w obsługiwanych, ograniczonych operacjach bez strumieniowania; w okresie wdrażania zgodności pozostaje to opcjonalne, więc wywołania bez tego klucza nie eliminują duplikatów przy ponowieniu transportowym. Operacje Batch i SSE odrzucają klucze ponowień klienta i nie podlegają tej umowie deduplikacji.

Testowanie surowego protokołu

Deweloperzy korzystający z klucza API mogą bezpośrednio zainicjować połączenie i wywołać narzędzie obliczeniowe:

Inicjalizacja

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-11-25",
    "capabilities": {},
    "clientInfo": {
      "name": "my-agent",
      "version": "1.0.0"
    }
  }
}

Wywołanie obliczeniowe

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

Wybierz klienta

Claude · Codex · Cursor · VS Code · Wtyczki do pobrania

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

Znajdź kolejną odpowiedź.