Claude Desktop

Claude Desktop経由でMCPを使用してAstroWay APIに接続します。ホスト型（HTTP）とローカルstdioパッケージの両方のトランスポートが利用可能です。

前提条件

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

接続

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の後にスペースがあると引数を分割してしまうからです。カタログ全体ではなく特定のトピックのみをロードするには、/mcpをドメインサーバー（例: /mcp/coreや/mcp/vedic）に置き換えてください。

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

{
"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”: commandの代わりにurlの記述があります。上記のmcp-remoteを使用したブロックを使用してください。
ツールが表示されない: Claude Desktopを完全に再起動（ウィンドウを閉じるだけでなく、ログアウトしてください）し、claude_desktop_config.jsonへのパスを確認してください。
検証エラー -32602 (stdioの場合): パッケージを更新してください: npm i @astroway/mcp@latest。スキーマは最新の仕様から再生成されます。

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

参考になりましたか？

編集を提案

最終更新日: 2026/10/05