HumanDesign.aiMCPアプリを開く ↗
AI向けドキュメント
認証

アカウントにはOAuth。計算にはAPIキー。

Human Design MCPは、権限の異なる2種類の認証情報を意図的にサポートしています。HumanDesign.aiの非公開アカウントツールにはOAuthを、従来の計算/リファレンス機能にはAPIキーを選択してください。

HumanDesign.ai OAuth

  1. 次を追加します: https://mcp.humandesign.ai/ 静的な認証ヘッダーを設定せず、リモートStreamable HTTP MCPサーバーとして接続します。
  2. クライアントのAuthenticate、Connect、 /mcpまたはMCPログイン操作を使います。
  3. HumanDesign.aiのブランド付きページでサインインし、選択したアカウント範囲と利用可能な機能を確認します。
  4. メンバーシップ、ワークスペースのロール、利用権、認証内容を変更した後は再接続してください。

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計算クォータまたは安全上のレート制限に達しました。利用状況を確認してください。短時間に繰り返し再試行しないでください。
ページ上部へ ↑お困りですか?サポートにお問い合わせください ↗

次の答えを見つける。