Windsurf

Kết nối AstroWay API với Windsurf qua MCP. Server được trợ lý Cascade sử dụng.

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

Chỉnh sửa ~/.codeium/windsurf/mcp_config.json; bạn cũng có thể mở nó qua Settings → Cascade → MCP. Lưu ý: với server từ xa, Windsurf dùng key serverUrl (không phải url). Dá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 bằng 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 con cục bộ, xác thực qua biến môi trường, hoạt động offline:

~/.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, 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 Windsurf và kiểm tra đường dẫn ~/.codeium/windsurf/mcp_config.json (với hosted: key serverUrl).
• 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.