HumanDesign.ai MCPに接続
開始前に
HumanDesign.ai MCPは、対応するAIクライアントに構造化されたHuman Designツールを提供します。このガイドでは、APIキーを使う計算およびリファレンスカタログについて説明します。クライアントがHumanDesign.aiのOAuth接続に対応している場合、保存済みのプラットフォームデータなど、アカウント接続型のアクセスが必要なときはその方法を利用してください。OAuthの権限と利用可否は、サインイン時に選択します。
標準のMCPエンドポイントは https://mcp.humandesign.ai/です。MCPリクエストには POST / 6種類の計算/リファレンスツールのみが必要な場合は、APIキーをBearerまたは GET / は接続テストではなく、 405 Method Not Allowed. POST /mcp は互換性のための別名です。
APIキーを安全に追加する
次のいずれかのリクエストヘッダーを使用してください。APIキーをURLに含めたり、リポジトリにコミットしたり、チャットに貼り付けたりしないでください。
Authorization: Bearer YOUR_HDAI_API_KEY
または:
X-Api-Key: YOUR_HDAI_API_KEY
接続してツールを確認する
- MCPクライアントを
https://mcp.humandesign.ai/. - で設定します。
initializeプロトコルバージョン付きで2025-11-25. - で設定します。
notifications/initialized. - を送信します。
tools/listを呼び出し、そのAPIキーに返されたツールのみを使用してください。
{
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {
"protocolVersion": "2025-11-25",
"capabilities": {},
"clientInfo": { "name": "your-client", "version": "1.0.0" }
}
}
などの検出呼び出し、 initialize, pingと tools/list は計算クォータを消費しません。成功した tools/call は共有APIユニットを1つ消費します。検証エラーや利用できないツールは消費しません。
ツールを呼び出す
次から返されたツール名と入力スキーマを使用してください: tools/list。たとえば、基本的なチャートリクエストは次の形式です:
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "generate_chart",
"arguments": {
"birthDateTime": "1990-05-15T14:30:00",
"timezone": "America/New_York",
"detailLevel": "core"
}
}
}
結果を読む
成功した呼び出しは、短い読みやすい概要、JSONテキストブロック、 structuredContentを返します。構造化レスポンスはバージョン付きのエンベロープを使用し、 version, tool, data, metaと任意の error フィールドを含みます。
現在の計算/リファレンスカタログが公開するのはツールのみです。MCPプロンプト、MCPリソース、レポート生成ツール、サーバーセッション、チャート画像ブロックは利用できません。