HumanDesign.aiにエージェントを接続する
標準のリモートStreamable HTTPエンドポイントは https://mcp.humandesign.ai/です。OAuthではアカウントの非公開ツールに接続し、APIキーでは計算/リファレンスAPIを利用できます。
メンバーシップのルール: FreeとIndividualのHumanDesign.aiユーザーは、自分のメインチャートを作成、保存、表示、レンダリングできます。Individualではアカウント利用状況も確認できます。他の人の許可されたチャートを読む場合や、より広範なアカウント機能を使う場合はPersonalまたはProが必要です。Website Builderツールは、HumanDesign.aiがお客様のアカウントでBuilderを有効にした場合にのみ表示され、さらに tools/list でその機能が公開されている場合に限ります。
接続方法を選択
OAuthプラットフォームツール →
現在公開されている19種類のアカウント、チャートレンダリング、ライブラリ、操作、レポート状況、Builderツール。
APIキー計算ツール →
別個のAPIプランと計算クォータで管理される6種類の計算/リファレンスツール。
プロトコルの概要
サーバーはドメインのルートでHTTP POSTによるJSON-RPCを受け付けます。 GET および DELETE はMCPトランスポートでは意図的に拒否されます。 GET /health は安全なサービス稼働情報のみを公開します。
標準エンドポイント
POST https://mcp.humandesign.ai/
Content-Type: application/json
Accept: application/json, text/event-stream対応メソッド
initialize接続または検出用メソッドです。クォータやAIクレジットは消費しません。
notifications/initialized接続または検出用メソッドです。クォータやAIクレジットは消費しません。
ping接続または検出用メソッドです。クォータやAIクレジットは消費しません。
tools/list接続または検出用メソッドです。クォータやAIクレジットは消費しません。
tools/call請求および確認ポリシーに従って、許可されたツールを実行します。
出生時刻には現地の時計時刻を指定
出生地で時計に表示された日時をそのまま送信してください。ZやUTCオフセットは付けず、IANA識別子のタイムゾーンを別途指定します。
"birthDateTime": "1990-05-15T14:30:00" with "timezone": "America/New_York" means half past two in the afternoon in New York.
Zまたはオフセットが付いた値だけでは現地の時計時刻を表せません。どのタイムゾーンで解釈するかによってチャートが変わります。
ZおよびUTCオフセットは非推奨です。 Zまたは数値オフセットで終わる値は非推奨です。MCPは値を転送し、APIは現在UTCとして受け付け、レスポンスで非推奨化を通知します。今後は受け付けなくなり、日程は事前に発表します。
単一の時点を示さない現地時刻は、計算単位を消費する前にAPIで拒否されます:
| エラーコード | 返される条件 |
|---|---|
nonexistent_local_time | 夏時間への切り替えでその現地時刻が飛ばされ、そのタイムゾーンでは存在しなかった場合。 |
ambiguous_local_time | 現地時刻が夏時間の重複時間帯に入り、そのタイムゾーンで2回発生した場合。 |
future_birth_datetime | 出生時刻が未来の場合。 |
invalid_birth_datetime_format | 現地の時計時刻ではない値です。移行後はZや数値オフセットも対象となります。 |
トランジット日付も同じ現地時刻形式を使いますが、未来の日付を指定できます。