VS Code

Kết nối AstroWay API với VS Code qua MCP. File cấu hình được Copilot Chat đọc ở chế độ Agent.

Yêu cầu trước

Lấy API key trong dashboard. Để thử nghiệm miễn phí, hãy dùng sandbox key aw_test_*: key này không trừ credit.

Kết nối

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

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

.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 con cục bộ, xác thực qua biến môi trường, hoạt động offline:

.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 (Agent mode), hãy gõ: “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í, chẳng hạn 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: đả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 VS Code và kiểm tra đường dẫn .vscode/mcp.json (key servers, trường type).
• Lỗi validation -32602 (với stdio): cập nhật package: npm i @astroway/mcp@latest. Các schema được tạo lại từ đặc tả hiện hành.

Tất cả client: Thiết lập agent.