NatalAI MCPドキュメント

Model Context Protocol（MCP）を通じて、AIエージェントをプロフェッショナルな占星術計算に接続します。

1. APIキーを取得する

NatalAIにサインインし、キャビネット → MCP APIキーを開きます。
「APIキーを生成」をクリックし、ボットに名前を付けて、キーをすぐにコピーします。
完全なキーが表示されるのは一度だけです。安全に保管してください。

2. エンドポイント

MCP JSON-RPCエンドポイント（Streamable HTTP）：

https://natalai.io/mcp/v1/

ツールマニフェスト（キー不要）：https://natalai.io/mcp/v1/schema/

3. 認証

2つのオプション：（1）X-API-KeyまたはAuthorization: Bearer your-keyによるAPIキー；（2）OAuth 2.1 — クライアントは/.well-known/openid-configurationでメタデータを検出し、NatalAIでサインインしてアクセスを承認します。OAuthのアクセストークンもAuthorization: Bearerとして送信されます。

4. Perplexity

カスタムコネクタ — OAuth（推奨）

Perplexityを開き → カスタムコネクタを追加。
サーバーURL：https://natalai.io/mcp/v1/
認証：OAuth。
トランスポート：Streaming HTTP。
NatalAIでログインを完了し、同意画面で「許可」をクリックします。

カスタムコネクタ — APIキー

Perplexityを開き → カスタムコネクタを追加（またはConnectors / MCP）。
サーバーURL：https://natalai.io/mcp/v1/
認証：APIキー — NatalAI MCPキーを貼り付け（生の値、「Bearer 」プレフィックスなし）。
トランスポート：Streaming HTTP（Streamable HTTP）。
ネットワークアクセス：Public。
リスクに関する通知に同意し、「追加」をクリックします。

NatalAIはキーをAuthorization: Bearer …として受け取ります。これはPerplexityがAPIキーコネクタで送信する形式です。OAuth有効化後にコネクタを作成してOAuthを要求され続ける場合は、削除して認証：APIキーで追加し直してください。

エージェントAPI

NatalAIキーをMCPツールのauthorizationフィールドに渡します（生のトークン）。PerplexityがBearerとしてサーバーに送信します。

curl https://api.perplexity.ai/v1/agent \
  -H "Authorization: Bearer $PERPLEXITY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-5.6-sol",
    "input": "Build a natal chart for 1991-04-26 10:30 in Minsk using NatalAI.",
    "tools": [
      {
        "type": "mcp",
        "server_label": "natalai",
        "server_url": "https://natalai.io/mcp/v1/",
        "authorization": "YOUR_NATALAI_API_KEY"
      }
    ]
  }'

5. OpenAI（Responses API）

OpenAI Responses APIでリモートMCPツールを使用します。NatalAIキーをauthorizationに入れます（生のトークン）。

curl https://api.openai.com/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -d '{
    "model": "gpt-5.6",
    "input": "Build a natal chart for 1991-04-26 10:30 in Minsk using NatalAI.",
    "tools": [
      {
        "type": "mcp",
        "server_label": "natalai",
        "server_description": "Western and Vedic astrology calculations",
        "server_url": "https://natalai.io/mcp/v1/",
        "authorization": "YOUR_NATALAI_API_KEY",
        "require_approval": "never"
      }
    ]
  }'

ChatGPTウェブコネクタは、当社の認可サーバー（/.well-known/openid-configuration）へのOAuthをサポートします。PerplexityエージェントAPIはOAuth UIフローを実行しません — コネクタUIを使うか、authorizationにトークン/キーを渡してください。

6. Claude Desktop

{
  "mcpServers": {
    "natalai": {
      "url": "https://natalai.io/mcp/v1/",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

7. Cursor / Windsurf

{
  "mcp": {
    "servers": [
      {
        "name": "NatalAI",
        "url": "https://natalai.io/mcp/v1/",
        "headers": { "X-API-Key": "YOUR_API_KEY" }
      }
    ]
  }
}

8. curlの例

curl -X POST https://natalai.io/mcp/v1/ \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "natal_chart",
      "arguments": {
        "birth_date": "1991-04-26",
        "birth_time": "10:30",
        "latitude": 53.9,
        "longitude": 27.57,
        "timezone": "Europe/Minsk",
        "gender": "male"
      }
    }
  }'

9. JSON-RPCメソッド

メソッド	説明
`initialize`	ハンドシェイク、サーバー情報
`tools/list`	利用可能なツールの一覧
`tools/call`	引数を付けてツールを実行

10. 利用可能なツール

natal_chart
ephemeris_day
transits
transit_strength
progressions
solar_return
synastry
vedic_natal
aspect_patterns
named_sky_event

11. 制限

キーごとのデフォルトのレート制限：1分あたり60リクエスト、1日あたり1000リクエスト。キーはキャビネットでいつでも無効化できます。

← MCP概要に戻る