HumanDesign.aiMCPアプリを開く ↗
AI向けドキュメント
クイックスタート

エージェントを4つの手順で接続します。

Claude、ChatGPT、Codexでは、サインイン中のユーザーが許可したHumanDesign.aiツールを安全に公開できるOAuth接続を推奨します。

1. ホストされたエンドポイントを追加

エンドポイント

https://mcp.humandesign.ai/

リモートHTTPまたはStreamable HTTPを選択します。 /mcp は追加しないでください。標準エンドポイントはドメインのルートです。

2. 認証する

クライアントのMCP AuthenticateまたはConnect操作を使い、HumanDesign.aiのブラウザーログインを完了します。Claude Codeユーザーは claude mcp login human-design-aiを実行できます。Codexユーザーは codex mcp login human_design_ai.

を実行できます。 X-Api-Key 認証で引き続き利用できます。

3. ツールを確認する

JSON-RPC

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/list",
  "params": {}
}

による検出は無料です。OAuthで表示されるツールは、サーバー側で決まるユーザーの機能付与、Free/Individual/Personal/Pro会員資格、ワークスペースのロール、所有権、製品の利用権に基づきます。APIキーでの表示は別個のFree/Creator/Startup/Business APIプランに従います。

4. メインチャートから始める

エージェントに chart_get_primaryを呼び出すよう依頼します。メインチャートがない場合、Free、Individual、Personal、Proの会員は chart_generateを利用できます。まず標準化された出生情報と1単位のプレビューを確認し、その後に実行を確定してください。保存済みチャートはアカウントの所有権で特定されます。「Kyle」や「My Chart」などの名前を検索して特定することはありません。他の人の許可されたチャートを読むにはPersonalまたはProが必要です。

接続、 initialize, ping, tools/list、ライブラリの読み取り、ステータス確認、既存チャートのレンダリングではクレジットを消費しません。新しいメインチャートの計算は計算単位を正確に1つ消費します。レンダリングで追加料金はかかりません。

計算の信頼性を支える仕組み

エージェント自身がチャートを計算することはありません。クォータを消費する前に、HumanDesign.aiが日付、場所、IANAタイムゾーン、夏時間の状況を検証し、計算サービスからバージョン付きの結果を返します。場所が曖昧な場合や入力が無効な場合は、単位を消費せず明確なエラーを返します。出生時刻が不明な場合、サービスは現地時間の正午を使用したことを記録し、時刻に左右されるチャート情報が異なる可能性を警告します。

安全に計算を再試行する

クォータを消費するMCPツール generate_chart, generate_composite_chartと get_transits には idempotencyKeyが必要です。意図した1回の再試行では、同じキーを同一の正規化済み引数とともに再利用し、新しい処理には新しいキーを使います。一致する再試行では追加クォータを消費せず、決定論的に結果を再計算する場合があります。保存済みレスポンスをバイト単位で再生する機能ではありません。MCPでトランジットを呼び出す場合、同じ時点を再試行できるよう明示的な日付が必要です。直接RESTおよびAgent HTTPクライアントは、対応する制限付きの非ストリーミング操作で Idempotency-Key を送信できます。互換性移行中は任意項目のため、指定しない呼び出しではトランスポートの再試行を重複排除できません。バッチとSSEは呼び出し側が指定する再試行キーを拒否し、この再試行重複排除契約の対象外です。

プロトコルを直接テストする

APIキーを使う開発者は、初期化して計算ツールを直接呼び出せます:

初期化

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-11-25",
    "capabilities": {},
    "clientInfo": {
      "name": "my-agent",
      "version": "1.0.0"
    }
  }
}

計算呼び出し

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "generate_chart",
    "arguments": {
      "birthDateTime": "1990-05-15T14:30:00",
      "timezone": "America/New_York",
      "detailLevel": "core",
      "idempotencyKey": "chart-1990-05-15-v1"
    }
  }
}

クライアントを選ぶ

Claude · Codex · Cursor · VS Code · プラグインをダウンロード

ページ上部へ ↑お困りですか?サポートにお問い合わせください ↗

次の答えを見つける。