HumanDesign.aiPersonalアプリを開く ↗
あなた自身のためにヘルプセンター

HumanDesign.ai MCPに接続

API2026年8月28日更新読了時間:約2分

開始前に

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

接続してツールを確認する

  1. MCPクライアントを https://mcp.humandesign.ai/.
  2. で設定します。 initialize プロトコルバージョン付きで 2025-11-25.
  3. で設定します。 notifications/initialized.
  4. を送信します。 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リソース、レポート生成ツール、サーバーセッション、チャート画像ブロックは利用できません。

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

次の答えを見つける。