Uwierzytelnianie
OAuth do Twojego konta. Klucze API do obliczeń.
Human Design MCP celowo obsługuje dwa rodzaje danych uwierzytelniających o odrębnych uprawnieniach. Wybierz OAuth do prywatnych narzędzi konta HumanDesign.ai, a klucz API do pierwotnego interfejsu obliczeniowego i referencyjnego.
OAuth HumanDesign.ai
- Dodaj
https://mcp.humandesign.ai/jako zdalny serwer MCP Streamable HTTP bez statycznego nagłówka autoryzacji. - Użyj w kliencie opcji Authenticate, Connect,
/mcplub logowania MCP. - Zaloguj się na oznaczonej stronie HumanDesign.ai i sprawdź wybrany zakres konta oraz dostępne możliwości.
- Po zmianie członkostwa, roli w przestrzeni roboczej, uprawnień lub autoryzacji połącz się ponownie.
Dostęp OAuth zawsze podlega ograniczeniom członkostwa i własności. Konta Free i Individual mogą tworzyć, zapisywać, wyświetlać i renderować własny wykres główny; Individual zapewnia również podgląd użycia konta. Dostęp do autoryzowanych wykresów innych osób i szerszych funkcji platformy wymaga Personal lub Pro.
Dostęp obliczeniowy z kluczem API
Klucze API typu Bearer i X-Api-Key nadal zapewniają dostęp do sześciu narzędzi obliczeniowych i referencyjnych. Nie udostępniają danych konta, biblioteki, raportów ani Buildera.
Authorization: Bearer $HDAI_API_KEY
# or
X-Api-Key: $HDAI_API_KEYBezpieczeństwo poświadczeń
- Tokenami OAuth zarządzają klient MCP i usługa autoryzacji; nigdy nie wklejaj ich do promptów ani plików źródłowych.
- Przechowuj klucze API w zmiennej środowiskowej lub chronionym magazynie sekretów.
- Nigdy nie zapisuj w dziennikach nagłówków autoryzacji, tokenów odświeżania, kluczy API, podpisanych adresów URL zasobów ani ustrukturyzowanych, prywatnych wyników wykresów.
- Odłącz łącznik lub wyczyść uwierzytelnianie MCP, aby cofnąć delegowany dostęp.
- Zarządzaj kluczami API i wykorzystaniem planu obliczeniowego pod adresem my.humandesign.ai.
Błędy uwierzytelniania
| Kod | Znaczenie | Działanie |
|---|---|---|
401 | Brakujące, nieprawidłowe, wygasłe lub cofnięte dane uwierzytelniające | Ponownie zaloguj się przez OAuth w kliencie lub przywróć chronione ustawienie klucza API. |
403 | Odmowa pochodzenia, uprawnienia, członkostwa, roli, własności lub dostępu | Sprawdź zakres konta; po zatwierdzonej zmianie dostępu połącz się ponownie. |
429 | Osiągnięto limit obliczeniowy lub bezpieczny limit szybkości | Sprawdź wykorzystanie; nie ponawiaj żądań szybko. |