Windsurf

Tham gia API AstroWay vào Windsurf thông qua MCP. Máy chủ sử dụng trợ lý Cascade.

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

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

Kết nối

Chỉnh sửa ~/.codeium/windsurf/mcp_config.json; cũng có thể truy cập thông qua Settings → Cascade → MCP. Lưu ý: máy chủ Windsurf sử dụng khóa serverUrl (không phải url). Chèn một trong các khối dưới đây và khởi động lại Windsurf.

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

~/.codeium/windsurf/mcp_config.json

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

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

~/.codeium/windsurf/mcp_config.json

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

Kiểm tra

Trong Cascade, nhập: «Danh sách công cụ Astroway» - hoặc yêu cầu công cụ tham chiếu miễn phí, chẳng hạn như nhận danh sách chòm sao. Nếu kết quả trả về, kết nối hoạt động.

Xử lý vấn đề

• 401 / key không hợp lệ: đảm bảo khóa có tiền tố aw_live_* hoặc aw_test_* và không bị hủy. Kiểm tra có thể thực hiện tại Dashboard.
• Công cụ không xuất hiện: khởi động lại hoàn toàn Windsurf và kiểm tra đường dẫn ~/.codeium/windsurf/mcp_config.json (cho hosted - khóa serverUrl).
• Lỗi xác thực -32602 (cho stdio): cập nhật gói: npm i @astroway/mcp@latest. Các schema được tái tạo từ phiên bản hiện tại của tiêu chuẩn.

Tất cả các khách hàng - Cài đặt đại diện.