エージェントを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 · プラグインをダウンロード