Claude Desktop

Cài đặt API AstroWay vào Claude Desktop thông qua MCP. Có hai phương thức truyền tải: hosted (HTTP) và phương thức truyền tải cục bộ stdio.

Điều kiện tiên quyết

Lấy API-đường dẫn trong Dashboard. Để thử nghiệm miễn phí, hãy sử dụng khóa thử nghiệm aw_test_* - nó sẽ không trừ chi phí.

Cài đặt

Mở Settings → Developer → Edit Config - Claude Desktop sẽ hiển thị đường dẫn đến file claude_desktop_config.json. Thêm một trong các đoạn mã bên dưới và khởi động lại Claude Desktop.

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

{
"mcpServers": {
  "astroway": {
    "url": "https://mcp.astroway.info/mcp",
    "headers": { "Authorization": "Bearer aw_live_YOUR_KEY" }
  }
}
}

Stdio (npx): phương thức truyền tải cục bộ, xác thực thông qua biến môi trường, hoạt động ngoại tuyến:

{
"mcpServers": {
  "astroway": {
    "command": "npx",
    "args": ["-y", "@astroway/mcp"],
    "env": { "ASTROWAY_API_KEY": "aw_live_YOUR_KEY" }
  }
}
}

Kiểm tra

Gửi Claude trong chat: «Danh sách các công cụ Astroway» - hoặc yêu cầu gọi công cụ tham chiếu miễn phí, chẳng hạn như danh sách các dấu hiệu trong zodiac. Nếu kết quả được trả lại, thì cài đặt đã hoạt động.

Xử lý lỗi

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ị hủy. Kiểm tra có thể được thực hiện trong Dashboard.
Các công cụ không xuất hiện: hãy khởi động lại hoàn toàn Claude Desktop (thoát khỏi ứng dụng, không chỉ đóng cửa sổ) và kiểm tra lại đường dẫn đến claude_desktop_config.json.
Lỗi kiểm tra -32602 (cho stdio): hãy cập nhật gói: npm i @astroway/mcp@latest. Các schema được tái sinh từ phiên bản mới nhất của OpenAPI.

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

Hữu ích chứ?

Запропонувати правку

Cập nhật lần cuối: 7 thg 9, 2026