Codex CLI

Kết nối API AstroWay với Codex CLI qua MCP. Codex sử dụng gói stdio cục bộ, được cấu hình trong tệp TOML.

Yêu cầu trước

Lấy API-key tại bảng điều khiển. Để thử nghiệm miễn phí, dùng sandbox-key aw_test_* - nó không trừ credit.

Kết nối

Chỉnh sửa ~/.codex/config.toml. Thêm khối dưới đây và khởi động lại Codex CLI. Xác thực qua biến môi trường, hoạt động offline:

~/.codex/config.toml

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

Kiểm tra

Gõ cho Codex trong chat: «Liệt kê các công cụ Astroway» - hoặc yêu cầu gọi công cụ tham chiếu miễn phí, ví dụ lấy danh sách các cung hoàng đạo. Nếu nhận được kết quả, kết nối đã hoạt động.

Khắc phục sự cố

• 401 / invalid key: đảm bảo rằng key có tiền tố aw_live_* hoặc aw_test_* và chưa bị thu hồi. Có thể kiểm tra ở bảng điều khiển.
• Công cụ không hiển thị: khởi động lại hoàn toàn Codex CLI và kiểm tra đường dẫn tới ~/.codex/config.toml.
• Lỗi xác thực -32602: cập nhật gói: npm i @astroway/mcp@latest. Các schema được tạo lại từ đặc tả hiện tại.

Tất cả khách hàng - Cài đặt đại lý.