Cline

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

Tiền đề

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

Kết nối

Mở Cline → MCP Servers → Configure để chỉnh sửa cline_mcp_settings.json. Dán một trong các khối dưới đây 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 offline. 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 trong chat: “Liệt kê các công cụ Astroway” - hoặc yêu cầu gọi công cụ tham chiếu miễn phí, ví dụ 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: chắc chắn rằng key có tiền tố aw_live_* hoặc aw_test_* và chưa bị thu hồi. Kiểm tra tại dashboard.
• Công cụ không xuất hiện: khởi động lại Cline hoàn toàn và kiểm tra đường dẫn tới cline_mcp_settings.json.
• Lỗi xác thực -32602 (đối với stdio): cập nhật gói: npm i @astroway/mcp@latest. Các schema sẽ được tái tạo từ đặc tả hiện tại.

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