Claude Code

AstroWay の API を Claude Code に MCP 経由で接続しよう。ファイルを編集する必要はないよ – 端末で一つのコマンドだけで全部設定できる。

前提条件

ダッシュボードで API キーを取得しよう。無料テストにはサンドボックスキー aw_test_* を使ってね – クレジットは消費されないよ。

接続

端末で以下のコマンドのどれかを実行してね。その後 Claude Code を再起動 して。

Hosted (HTTP): インストール不要、Bearer トークンで認証:

terminal

claude mcp add --transport http astroway https://mcp.astroway.info/mcp \
--header "Authorization: Bearer aw_live_YOUR_KEY"

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

terminal

claude mcp add astroway --env ASTROWAY_API_KEY=aw_live_YOUR_KEY -- npx -y @astroway/mcp

確認

Claude のチャットに『Astroway のツールを列挙して』と書くか、無料のリファレンスツール（例: 星座のリスト取得）を呼び出すように頼んでみて。返答に結果が返ってきたら、接続はうまくいっているよ。

トラブルシューティング

• 401 / invalid key: キーがプレフィックス aw_live_* または aw_test_* で、取り消されていないことを確認してね。確認は ダッシュボードでできる。
• ツールが表示されない: Claude Code を完全に再起動して、サーバーが追加されているか確認してね（claude mcp list）。
• バリデーションエラー -32602（stdio 用）: パッケージを更新しよう：npm i @astroway/mcp@latest。スキーマは最新の仕様から再生成されるよ。

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