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 tiên quyết

Nhận khóa API tại bảng điều khiển. Để kiểm thử miễn phí, hãy sử dụng khóa sandbox aw_test_* - khóa này không trừ tín dụng.

Kết nối

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

~/.codex/config.toml

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

Kiểm tra

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

Khắc phục sự cố

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

Tất cả các client - Cấu hình agent.