Codex CLI

AstroWay APIをCodex CLIにMCP経由で接続します。CodexはTOMLファイルで設定されたローカルstdioパッケージを使用します。

前提条件

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

接続

~/.codex/config.toml を編集してください。以下のブロックを追加し、Codex CLIを再起動してください。環境変数による認証はオフラインでも動作します：

~/.codex/config.toml

[mcp_servers.astroway]
command = "npx"
args = ["-y", "@astroway/mcp"]
env = { ASTROWAY_API_KEY = "aw_live_YOUR_KEY" }

確認

チャットでCodexに「Astrowayのツールを一覧表示してください」と書くか、無料のリファレンストール（例えば、十二宮の一覧を取得する）を呼び出すように依頼してください。応答に結果が返ってくれば、接続は正常に動作しています。

トラブルシューティング

• 401 / 無効なキー: キーに aw_live_* または aw_test_* の接頭辞があり、取り消されていないことを確認してください。ダッシュボードで確認できます。
• ツールが表示されない: Codex CLIを完全に再起動し、~/.codex/config.tomlへのパスを確認してください。
• 検証エラー -32602: パッケージを更新してください: npm i @astroway/mcp@latest。スキーマは最新の仕様から再生成されます。

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