Windsurf

Συνδέστε το API του AstroWay στο Windsurf μέσω MCP. Ο διακομιστής χρησιμοποιεί τον βοηθό Cascade.

Προαπαιτούμενα

Λάβτε το κλειδί API από το dashboard. Για δωρεάν δοκιμές, χρησιμοποιήστε το κλειδί sandbox aw_test_* - δεν αφαιρεί πιστώσεις.

Σύνδεση

Επεξεργαστείτε το ~/.codeium/windsurf/mcp_config.json; επίσης διαθέσιμο μέσω Settings → Cascade → MCP. Σημείωση: για απομακρυσμένο διακομιστή, το Windsurf χρησιμοποιεί το κλειδί serverUrl (όχι url). Εισάγετε ένα από τα παρακάτω μπλοκ και επαναεκκινήστε το Windsurf.

Hosted (HTTP): χωρίς εγκατάσταση, αυθεντικοποίηση μέσω Bearer token:

~/.codeium/windsurf/mcp_config.json

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

Stdio (npx): τοπική υποδιεργασία, αυθεντικοποίηση μέσω μεταβλητής περιβάλλοντος, λειτουργεί offline:

~/.codeium/windsurf/mcp_config.json

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

Έλεγχος

Στο Cascade, γράψτε: «Παραθέστε τα εργαλεία του Astroway» - ή ζητήστε να καλέσετε ένα δωρεάν εργαλείο αναφοράς, για παράδειγμα να λάβετε μια λίστα με τα ζώδια. Αν λάβετε απάντηση, η σύνδεση λειτουργεί.

Αντιμετώπιση προβλημάτων

• 401 / invalid key: βεβαιωθείτε ότι το κλειδί έχει πρόθεμα aw_live_* ή aw_test_* και δεν έχει ανακληθεί. Μπορείτε να το ελέγξετε στο dashboard.
• Τα εργαλεία δεν εμφανίζονται: επανεκκινήστε πλήρως το Windsurf και ελέγξτε τη διαδρομή ~/.codeium/windsurf/mcp_config.json (για hosted - το κλειδί serverUrl).
• Σφάλματα επικύρωσης -32602 (για stdio): ενημερώστε το πακέτο: npm i @astroway/mcp@latest. Τα σχήματα regenerates με την τρέχουσα προδιαγραφή.

Όλοι οι πελάτες - Ρύθμιση agent.