Claude Code

Last updated 25 thg 9, 2026 Xem dưới dạng Markdown Thiết lập tác nhân

Kết nối AstroWay API với Claude Code qua MCP. Không cần sửa file nào: mọi thứ được cấu hình bằng một lệnh trong terminal.

Yêu cầu trước

Lấy API key trong dashboard. Để thử nghiệm miễn phí, hãy dùng sandbox key aw_test_*: key này không trừ credit.

Kết nối

Chạy một trong các lệnh dưới đây trong terminal. Sau đó khởi động lại Claude Code.

Hosted (HTTP): không cần cài đặt, xác thực bằng Bearer token:

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

Stdio (npx): tiến trình con cục bộ, xác thực qua biến môi trường, hoạt động offline:

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

Kiểm tra

Gõ cho Claude trong chat: “Liệt kê các công cụ Astroway”, hoặc yêu cầu gọi một công cụ reference miễn phí, chẳng hạn 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 key có tiền tố aw_live_* hoặc aw_test_* và chưa bị thu hồi. Bạn có thể kiểm tra trong dashboard.
Công cụ không xuất hiện: khởi động lại hoàn toàn Claude Code và kiểm tra rằng server đã được thêm (claude mcp list).
Lỗi validation -32602 (với stdio): cập nhật package: npm i @astroway/mcp@latest. Các schema được tạo lại từ đặc tả hiện hành.

Tất cả client: Thiết lập agent.