Claude Desktop

Last updated 2026年10月19日 Markdownとして開くエージェント設定

AstroWay APIをClaude DesktopにMCP経由で接続する：ワンクリック拡張機能または手動設定で、ホストされたサーバー(HTTP)またはローカルstdioパッケージを使用します。

前提条件

APIキーをダッシュボードで取得してください。無料テストには、sandboxキーaw_test_*を使用してください - これはクレジットを消費しません。

ワンクリック拡張機能

astroway.mcpbをダウンロードします。
ファイルを開きます。Claude Desktopがインストールダイアログを表示します。
APIキーを貼り付け、ツールグループを選択（デフォルトでは出生図、トランジット、プログレッション、リターン、シナストリー、カレンダー）、拡張機能を有効にします。

設定を編集する必要はありません。この拡張機能は、同じリリースからビルドされた依存関係を持つnpmパッケージ@astroway/mcpです。すべての700以上のツールをロードするには、グループフィールドをクリアしてください。

手動接続

Settings → Developer → Edit Configを開く - Claude Desktopがファイルclaude_desktop_config.jsonへのパスを表示します。以下のブロックのいずれかを貼り付け、Claude Desktopを再起動してください。

Hosted (HTTP): 私たちのパッケージなし、Bearerトークンによる認証。Claude Desktopの設定はローカルコマンドのみを実行し、url自体の記録をスキップするため、hostedサーバーはmcp-remoteブリッジを介して接続されます：

{
"mcpServers": {
  "astroway": {
    "command": "npx",
    "args": ["-y", "mcp-remote", "https://mcp.astroway.info/mcp", "--header", "Authorization:${AUTH_HEADER}"],
    "env": { "AUTH_HEADER": "Bearer aw_live_YOUR_KEY" }
  }
}
}

キーはargsではなくenvにあります。なぜなら、Claude Desktop on WindowsはBearerの後にスペースがあると引数を分割してしまうからです。カタログ全体の代わりに1つのテーマをロードするには、/mcpをドメインサーバーに置き換えてください。例えば/mcp/coreや/mcp/vedicなどです。

Stdio (npx): ローカルサブプロセス、env変数による認証、オフラインで動作：

{
"mcpServers": {
  "astroway": {
    "command": "npx",
    "args": ["-y", "@astroway/mcp"],
    "env": { "ASTROWAY_API_KEY": "aw_live_YOUR_KEY" }
  }
}
}

確認

チャットでClaudeに書き込む: “Astrowayのツールをリストアップしてください” - または、無料のリファレンスツールを呼び出すように依頼してください。例えば、黄道十二宮のリストを取得します。応答に結果が返ってくれば、接続は正常に機能しています。

トラブルシューティング

401 / 無効なキー: キーにaw_live_*またはaw_test_*の接頭辞があること、および失効していないことを確認してください。ダッシュボードで確認できます。
“Some MCP servers couldn’t be loaded”: urlの代わりにcommandを使用します。上記のmcp-remoteブロックを使用してください。
ツールが表示されない: Claude Desktopを完全に再起動してください（ウィンドウを閉じるのではなく終了してください）し、claude_desktop_config.jsonへのパスを確認してください。
検証エラー -32602 (stdio用): パッケージを更新してください: npm i @astroway/mcp@latest。スキーマは最新の仕様から再生成されます。

すべてのクライアント - エージェント設定。