Cursor

Kết nối API AstroWay với Cursor qua MCP. Cả hai phương thức vận chuyển đều có sẵn: hosted (HTTP) và gói stdio cục bộ.

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

Nhận API key trên dashboard. Để thử nghiệm miễn phí, hãy sử dụng sandbox key aw_test_* - nó không trừ tín dụng.

Kết nối

Chỉnh sửa ~/.cursor/mcp.json (hoặc .cursor/mcp.json của dự án); cũng có thể truy cập qua Settings → MCP. Chèn một trong các khối bên dưới và khởi động lại Cursor.

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

~/.cursor/mcp.json

{
"mcpServers": {
  "astroway": {
    "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 env, hoạt động ngoại tuyến:

~/.cursor/mcp.json

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

Kiểm tra

Nhắn cho agent trong chat: “Liệt kê các công cụ Astroway” - hoặc yêu cầu gọi công cụ reference miễn phí, ví dụ như lấy danh sách cung hoàng đạo. Nếu nhận được kết quả trả về, kết nối đang 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 trên dashboard.
• Công cụ không xuất hiện: khởi động lại Cursor hoàn toàn và kiểm tra đường dẫn đến ~/.cursor/mcp.json (cho dự án - .cursor/mcp.json).
• Lỗi validation -32602 (cho stdio): cập nhật package: npm i @astroway/mcp@latest. Các schema được tạo lại từ đặc tả hiện tại.

Tất cả các client - Cấu hình agent.