Claude Desktop

Kết nối API AstroWay với Claude Desktop qua MCP: tiện ích mở rộng bằng một cú nhấp chuột hoặc thủ công qua cấu hình, với máy chủ được lưu trữ (HTTP) hoặc gói stdio cục bộ.

Điều kiện 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.

Mở rộng bằng một cú nhấp chuột

1. Tải xuống astroway.mcpb.
2. Mở tệp. Claude Desktop sẽ hiển thị hộp thoại cài đặt.
3. Nhập khóa API, chọn các nhóm công cụ (mặc định là bản đồ sinh, chuyển tiếp, tiến trình, hồi quy, hợp chiêm tinh và lịch) và bật tiện ích mở rộng.

Không cần chỉnh sửa cấu hình. Tiện ích mở rộng này là gói npm @astroway/mcp với các phụ thuộc của nó, được biên dịch từ cùng một bản phát hành. Xóa sạch trường nhóm để tải tất cả 700+ công cụ.

Kết nối thủ công

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

Hosted (HTTP): không có gói của chúng tôi, xác thực qua Bearer token. Cấu hình Claude Desktop chỉ chạy các lệnh cục bộ và bỏ qua mục có chứa url, vì vậy máy chủ được lưu trữ kết nối qua cầu nối mcp-remote:

claude_desktop_config.json

{
"mcpServers": {
  "astroway": {
    "command": "npx",
    "args": ["-y", "mcp-remote", "https://mcp.astroway.info/mcp", "--header", "Authorization:${AUTH_HEADER}"],
    "env": { "AUTH_HEADER": "Bearer aw_live_YOUR_KEY" }
  }
}
}

Khóa nằm trong env, không phải trong args, vì Claude Desktop trên Windows sẽ tách đối số sau khoảng trắng sau Bearer. Để tải một chủ đề thay vì toàn bộ danh mục, hãy thay thế /mcp bằng máy chủ miền, ví dụ /mcp/core hoặc /mcp/vedic.

Stdio (npx): quy trình con cục bộ, xác thực qua biến env, hoạt động ngoại tuyến:

claude_desktop_config.json

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

Kiểm tra

Gõ Claude vào trò chuyện: “Liệt kê các công cụ Astroway” - hoặc yêu cầu gọi công cụ miễn phí, ví dụ như nhận 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 / invalid key: đả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.
• “Some MCP servers couldn’t be loaded”: mục chứa url thay vì command. Sử dụng khối với mcp-remote ở trên.
• Công cụ không xuất hiện: khởi động lại hoàn toàn Claude Desktop (thoát, không chỉ đóng cửa sổ) và kiểm tra đường dẫn đến claude_desktop_config.json.
• Lỗi xác thực -32602 (cho stdio): 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 khách hàng - Cài đặt tác nhân.