Автентифікація
OAuth для облікового запису. Ключі API для розрахунків.
Human Design MCP навмисно підтримує два типи облікових даних із різними повноваженнями. Виберіть OAuth для приватних інструментів облікового запису HumanDesign.ai або ключ API для початкового інтерфейсу розрахунків і довідки.
OAuth HumanDesign.ai
- Додайте
https://mcp.humandesign.ai/як віддалений сервер MCP із транспортом Streamable HTTP без статичного заголовка авторизації. - Скористайтеся дією Authenticate, Connect,
/mcpабо входом MCP у клієнті. - Увійдіть на брендованій сторінці HumanDesign.ai й перевірте вибрані межі облікового запису та доступні функції.
- Підключіться знову після зміни членства, ролі в робочому просторі, доступних функцій або авторизації.
Доступ OAuth завжди обмежується членством і правами власності. Користувачі Free та Individual можуть створювати, зберігати, переглядати й візуалізувати власну основну карту; Individual також показує використання облікового запису. Для авторизованих карт інших людей і ширших функцій платформи потрібен Personal або Pro.
Доступ до розрахунків за ключем API
Ключі API Bearer і X-Api-Key залишаються доступними для шести інструментів розрахунку й довідки. Вони не надають доступу до даних облікового запису, бібліотеки, звітів або Builder.
Authorization: Bearer $HDAI_API_KEY
# or
X-Api-Key: $HDAI_API_KEYЗахист облікових даних
- Токени OAuth обробляються клієнтом MCP і службою авторизації; ніколи не вставляйте їх у запити або файли з вихідним кодом.
- Зберігайте ключі API у змінній середовища або захищеному сховищі секретів.
- Ніколи не занотовуйте в журналах заголовки авторизації, токени оновлення, ключі API, підписані URL-адреси ресурсів або структуровані приватні дані карт.
- Щоб відкликати делегований доступ, від’єднайте конектор або очистьте автентифікацію MCP.
- Керування ключами API й використанням тарифу розрахунків — на my.humandesign.ai.
Помилки автентифікації
| Код | Значення | Дія |
|---|---|---|
401 | Облікові дані відсутні, мають неправильний формат, строк їхньої дії минув або їх відкликано | Повторіть вхід OAuth у клієнті або відновіть захищене налаштування ключа API. |
403 | Походження запиту, дозвіл, членство, роль, право власності або доступна функція не дозволяють дію | Перевірте межі облікового запису; після схваленої зміни доступу підключіться знову. |
429 | Досягнуто квоту розрахунків або безпечне обмеження частоти запитів | Перевірте використання; не повторюйте запит надто швидко. |