VS Code

Cài đặt API AstroWay vào VS Code thông qua MCP. Cấu hình đọc Copilot Chat ở chế độ Agent.

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

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

Cài đặt

Tạo file .vscode/mcp.json ở gốc dự án. Lưu ý: trong VS Code, khóa là servers (không phải mcpServers), và mỗi server cần có trường type. Chèn một trong các đoạn dưới đây và reboot lại VS Code.

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

.vscode/mcp.json

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

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

.vscode/mcp.json

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

Kiểm tra

Trong Copilot Chat (chế độ Agent) gõ: «Danh sách các công cụ Astroway» - hoặc yêu cầu công cụ tham chiếu miễn phí, chẳng hạn như liệt kê các dấu hiệu zodiac. Nếu có kết quả, kết nối hoạt động.

Xử lý lỗi

• 401 / khóa không hợp lệ: đả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ể trong dashboard.
• Công cụ không xuất hiện: hãy reboot lại VS Code và kiểm tra đường dẫn .vscode/mcp.json (khóa servers, trường type).
• Lỗi xác thực -32602 (cho stdio): cập nhật gói: npm i @astroway/mcp@latest. Các schema được cập nhật lại từ phiên bản mới nhất của tài liệu tham chiếu.

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