認証
アカウントにはOAuth。計算にはAPIキー。
Human Design MCPは、権限の異なる2種類の認証情報を意図的にサポートしています。HumanDesign.aiの非公開アカウントツールにはOAuthを、従来の計算/リファレンス機能にはAPIキーを選択してください。
HumanDesign.ai OAuth
- 次を追加します:
https://mcp.humandesign.ai/静的な認証ヘッダーを設定せず、リモートStreamable HTTP MCPサーバーとして接続します。 - クライアントのAuthenticate、Connect、
/mcpまたはMCPログイン操作を使います。 - HumanDesign.aiのブランド付きページでサインインし、選択したアカウント範囲と利用可能な機能を確認します。
- メンバーシップ、ワークスペースのロール、利用権、認証内容を変更した後は再接続してください。
OAuthアクセスは常にメンバーシップと所有権によって制限されます。FreeおよびIndividualアカウントでは、自分のメインチャートを作成、保存、表示、レンダリングできます。Individualではアカウント利用状況も確認できます。他の人の許可されたチャートや広範なプラットフォーム機能にはPersonalまたはProが必要です。
APIキーによる計算アクセス
Bearer APIキーと X-Api-Key は、6種類の計算/リファレンスツールで引き続き利用できます。アカウント、ライブラリ、レポート、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 | 計算クォータまたは安全上のレート制限に達しました。 | 利用状況を確認してください。短時間に繰り返し再試行しないでください。 |