EN
メニュー

AIツールとの連携（Claude・ChatGPT）

星道のチャート機能を Claude や ChatGPT に接続し、対話の中でホロスコープを読むための設定と、呼び出せる全エンドポイントのリファレンスです。

星導き（ベータ期間中は無料）プランでは、星道のアカウントを Claude や ChatGPT などの AI ツールに接続できます。接続すると、AI があなたの出生図やトランジットを秒角単位の正確さで読み込み、対話の中でホロスコープを解釈します。計算は星道がおこない、解釈は接続した AI がおこないます。

接続には MCP（Model Context Protocol）という仕組みを使います。星道は MCP サーバーを https://app.hoshidou.com/api/mcp で公開していて、対応する AI クライアントからこの URL を登録すると、出生データの管理から各種チャート計算、メモの読み書きまでを会話の中から呼び出せるようになります。

必要なもの

  • 星導きプランの星道アカウント
  • カスタムコネクタ（リモート MCP）に対応した AI クライアント。Claude（Pro / Max など）または ChatGPT（Plus / Pro / Business / Enterprise / Edu）

Claude から接続する

Claude では「カスタムコネクタ」として星道を追加します。画面はプランによって少し違います。手順の詳細は公式ヘルプ Get started with custom connectors using remote MCP を参照してください。要点は次の通りです。

Pro / Max（個人プラン）の場合

  1. 「Customize（カスタマイズ）> Connectors（コネクタ）」を開きます。
  2. 「+」から「Add custom connector（カスタムコネクタを追加）」を選びます。
  3. リモート MCP サーバーの URL に https://app.hoshidou.com/api/mcp を入力します。
  4. 「Add（追加）」を押します。
  5. 星道のログイン画面が開くので、お使いのアカウントでログインし、共有内容を確認して許可します。

Team / Enterprise の場合は、オーナーが「Organization settings（組織設定）> Connectors」から同じ URL でコネクタを追加し、メンバーは「Customize > Connectors」で「Connect」を押して認証します。

接続後は、チャット左下の「+」ボタン →「Connectors」から、その会話で星道を有効にできます。

ChatGPT から接続する

ChatGPT では「デベロッパーモード（Developer mode）」を有効にし、カスタム MCP アプリとして星道を登録します。詳細は公式ガイド ChatGPT Developer mode と Developer mode and MCP apps in ChatGPT を参照してください。要点は次の通りです。

  1. 「Settings（設定）> Apps（アプリ）」を開きます。
  2. 「Advanced settings（詳細設定）> Developer mode」を有効にします。
  3. 「Create app（アプリを作成）」を選び、リモート MCP サーバーを登録します。
    • アプリ名（任意のわかりやすい名前。例: 星道）
    • MCP サーバー URL: https://app.hoshidou.com/api/mcp
    • 認証方式: OAuth
  4. 保存後、星道のログイン画面でログインし、共有内容を確認して許可します。

会話では、入力欄の「Developer mode」から星道を有効にして使います。データを書き換えるツール（プロフィールの編集・削除、メモの作成）は、実行前に確認を求められます。

できることの一覧（エンドポイント・リファレンス）

接続した AI は、以下のツールを会話の中から呼び出せます。ツール名は AI が内部で使う正式名です。あなたは自然な言葉で頼むだけで構いません。各ツールに、実際の頼み方の例を二つずつ添えました。

多くのチャート系ツールは、対象の人物（profileId）に加えて、ハウスシステム（プラシーダス、ホールサインなど）やゾディアック（トロピカル／サイデリアル）を指定できます。指定しなければ標準設定で計算されます。

出生プロフィールの管理

list_birth_profiles — 登録済みの人物一覧

星道に登録してある人物（出生プロフィール）をすべて返します。チャートを計算する前に、対象の人物を確かめるために使います。

  • 「星道に登録してる人の一覧を出して」
  • 「いま誰の出生データが入ってるか教えて」

create_birth_profile — 人物を新規登録

名前と生年月日、できれば出生時刻と出生地を渡すと、新しい出生プロフィールを作ります。出生地は地名（例: 東京）で渡せば緯度経度とタイムゾーンを解決します。出生時刻がわからない場合は省略できます。天体の位置は出生地の正午（12:00）で計算するため、一日におよそ13度動く月は6度から7度ほどずれることがあります。ハウスと感受点も同じ正午を仮定して計算しますが、こちらのずれ方は桁が違います。アセンダントは約2時間で星座を一つ進むため、正午から出した星座が実際と一致する見込みは、およそ12分の1です。仮定して計算したチャートには、レスポンスの meta.birthTimeAssumed に true が立ちます。ただしアストロマップだけは正確な出生時刻を必要とするため、時刻のないプロフィールでは計算せずエラーを返します。時刻を省いたプロフィールは、今のところアプリのチャート画面では開けません（出生データの管理）。

  • 「母を登録して。1962年3月4日、京都生まれ、朝7時すぎ」
  • 「友達のあやかを追加して。2000年11月20日 14:30、東京」

update_birth_profile — 登録済みの人物を修正

名前・生年月日・出生時刻・座標・出生地・メモなどを修正します。渡した項目だけが変わります。出生時刻を少し直すだけでも、ハウスや感受点の読みは変わります。

  • 「父の出生時刻を5時40分に直して」
  • 「さっき登録した人の生まれた場所を福岡に変えて」

delete_birth_profile — 人物を削除

出生プロフィールを完全に削除します。紐づくメモ・保存チャート・レポートも一緒に消えます。取り消せません。AI はまず削除内容を確認のうえ、あなたが明確に同意してから実行します。

  • 「テストで作ったプロフィールを消して」
  • 「もう使わない『元同僚』のデータを削除して」

ネイタルと経過のチャート

get_natal_chart — 一重円（ネイタル）

登録済みの人物の出生図を秒角単位で計算します。

  • 「私の出生図を出して、土星の配置を読んで」
  • 「ホールサインで私のネイタルを計算して」

get_transit_chart — トランジット（経過）

指定した日付の天体の位置を、出生図に対して計算します。

  • 「今日のトランジットを私の出生図に重ねて、目立つ点を挙げて」
  • 「2026年8月1日時点の経過を見て、気になるアスペクトを教えて」

get_progressed_chart — 二次進行

指定した日付までの二次進行（セカンダリープログレッション）を計算します。

  • 「私の今のプログレスを出して」
  • 「2027年の二次進行で月がどこにいるか教えて」

get_solar_arc_chart — ソーラーアーク

指定した日付までのソーラーアーク・ディレクションを計算します。

  • 「私のソーラーアークを今日付けで出して」
  • 「来年春のソーラーアークでMCに当たる天体ある？」

get_triple_chart — 三重円（ネイタル・進行・経過）

ネイタル、二次進行、トランジットの三つのリングを、クロスアスペクトつきで重ねて計算します。

  • 「ネイタル・進行・経過の三重円を今日付けで出して」
  • 「2026年12月の三重円で重なってるアスペクトを教えて」

リターン（回帰図）

get_solar_return_chart — ソーラーリターン

指定した年の太陽回帰図を、出生地で計算します。誕生日からの一年を読むときに使います。

  • 「私の2026年のソーラーリターンを出して」
  • 「今年の誕生日からの一年がどんな年か、ソーラーリターンで見て」

get_lunar_return_chart — ルナリターン

指定した日付以降で最初の月回帰図を計算します。

  • 「次のルナリターンを出して」
  • 「2026年7月以降で最初のルナリターンを計算して」

相性と二者間のチャート

get_synastry_chart — 相性（シナストリー）

登録済みの二人のネイタルを重ね、天体同士のクロスアスペクトを計算します。

  • 「私とパートナーの相性を見て、太陽と月のアスペクトを説明して」
  • 「あやかとの相性チャートを出して」

get_composite_chart — コンポジット

二人の中点から一枚の関係性チャートを作ります。

  • 「私と彼のコンポジットを出して」
  • 「二人の中点コンポジットでどんな関係性が出てるか読んで」

get_composite_transit_chart — コンポジットへのトランジット

二人のコンポジットに対する、指定日のトランジットを計算します。関係の「いま」を時間軸で読むときに使います。

  • 「私たちの今年の相性、コンポジットへのトランジットで見て」
  • 「2026年の二人の関係に効いてくる経過を教えて」

場所のチャート

get_astromap_chart — アストロマップ（リロケーション）

各天体の MC・IC・AC・DC のラインと、それらが交わるパランを地図上に計算します。出生時刻が必要です。

  • 「私のアストロマップを出して、金星のラインがどこを通るか教えて」
  • 「移住するならどの土地がいいか、リロケーションのラインで見て」

保存したチャートの参照

list_saved_charts — 保存チャートの一覧

保存済みのチャート・スナップショットを一覧します。

  • 「保存したチャートの一覧を出して」
  • 「前に保存したチャートある？」

get_saved_chart — 保存チャートの読み込み

保存したスナップショットを、計算データごと読み込みます。

  • 「さっき保存したチャートの計算結果を読み込んで」
  • 「あのスナップショットの中身をもう一回見せて」

レポートの参照

list_reports — レポートの一覧

作成済みの AI レポートを一覧します（読み取りのみ。新規生成はしません）。

  • 「作成済みのレポートの一覧を出して」
  • 「過去のレポートある？」

get_report — レポートの読み込み

指定したレポートの全文を読み込みます。

  • 「先月のレポートの全文を読み込んで」
  • 「あのレポートの内容を要約して」

暦（エフェメリス）

get_monthly_ephemeris — 月間エフェメリス

指定した年月の天体の位置と主要なイベントを返します。

  • 「2026年8月の天体の動きを出して」
  • 「来月の主要な天体イベントを教えて」

get_voc_moon — ボイドタイム

指定した年月のボイド・オブ・コース・ムーン（月のボイド）の期間を返します。

  • 「2026年8月のボイドタイムを教えて」
  • 「今月、月のボイドはいつ？」

メモ

create_memo — メモの保存

人物のノートにメモを保存します。天体やアスペクトに紐づけることも、人物全体への記録として残すこともできます。AI が書いたメモには印が付き、手動のメモと区別できます。

  • 「私の太陽×土星のアスペクトについて、このメモを残しておいて」
  • 「この人の全体メモとして『初対面は2025年の夏』と記録して」

list_memos — メモの一覧

人物に紐づくメモを一覧します。特定の天体やアスペクトで絞り込めます。

  • 「私に紐づいてるメモを一覧で出して」
  • 「この人の土星に付けたメモある？」

共有されるデータ

連携の解除

  1. アカウント設定の「連携アプリ」を開きます。
  2. 解除したい接続の「解除」を選びます。

解除すると、その接続のアクセス権はただちに無効になります。再び使うには、もう一度接続の手順をおこないます。Claude / ChatGPT 側のコネクタ一覧からも、それぞれの設定で接続を取り消せます。