Аутентификация
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 | Исчерпана квота расчётов или достигнуто ограничение частоты запросов | Проверьте использование; не повторяйте запрос слишком часто. |