Codex CLI

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

前提条件

ダッシュボード で API キーを取得して。無料テストには、クレジットを消費しない sandbox キー aw_test_* を使って。

接続方法

~/.codex/config.toml を編集して。以下のブロックを追加し、Codex CLI を再起動して。認証は env 変数経由で行われ、オフラインでも動作する：

~/.codex/config.toml

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

確認

チャットで Codex に「Astroway のツールをリストアップして」と書くか、無料の reference ツール（例：星座のリスト取得）を呼び出すよう依頼して。レスポンスが返ってくれば、接続は成功している。

トラブルシューティング

• 401 / invalid key: キーに aw_live_* または aw_test_* のプレフィックスが付いているか、また無効化されていないか確認して。ダッシュボード で確認できる。
• ツールが表示されない: Codex CLI を完全に再起動し、~/.codex/config.toml へのパスが正しいか確認して。
• バリデーションエラー -32602: パッケージを更新して：npm i @astroway/mcp@latest。スキーマは最新の仕様に基づいて再生成される。

すべてのクライアントについては - エージェントの設定 を参照して。