Cline

Kết nối API AstroWay với Cline thông qua MCP. Đối với Cline, phương thức đáng tin cậy nhất là stdio.

Yêu cầu tiên quyết

Lấy API key từ dashboard. Để thử nghiệm miễn phí, hãy sử dụng sandbox key aw_test_* - nó không trừ điểm tín dụng.

Kết nối

Mở Cline → MCP Servers → Configure để chỉnh sửa cline_mcp_settings.json. Chèn một trong các khối bên dưới và khởi động lại Cline.

Stdio (npx): tiến trình con cục bộ, xác thực qua biến môi trường, hoạt động ngoại tuyến. Lựa chọn được đề xuất cho Cline:

cline_mcp_settings.json

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

Hosted (HTTP): nếu phiên bản Cline của bạn hỗ trợ máy chủ từ xa:

cline_mcp_settings.json

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

Kiểm tra

Gửi tin nhắn cho Cline: «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í, 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 / 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 Cline và kiểm tra đường dẫn đến cline_mcp_settings.json.
• Lỗi validation -32602 (cho stdio): 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ả các client - Cài đặt agent.