Windsurf

Collega l’API AstroWay a Windsurf tramite MCP. Il server viene usato dall’assistente Cascade.

Prerequisiti

Ottieni una chiave API nella dashboard. Per i test gratuiti usa una chiave sandbox aw_test_*: non consuma crediti.

Connessione

Modifica ~/.codeium/windsurf/mcp_config.json; è accessibile anche da Settings → Cascade → MCP. Attenzione: per un server remoto Windsurf usa la chiave serverUrl (non url). Incolla uno dei blocchi qui sotto e riavvia Windsurf.

Hosted (HTTP): nessuna installazione, autenticazione tramite token Bearer:

~/.codeium/windsurf/mcp_config.json

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

Stdio (npx): sottoprocesso locale, autenticazione tramite variabile d’ambiente, funziona offline:

~/.codeium/windsurf/mcp_config.json

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

Verifica

In Cascade scrivi: “Elenca gli strumenti di Astroway”, oppure chiedi di chiamare uno strumento reference gratuito, per esempio ottenere l’elenco dei segni zodiacali. Se ricevi un risultato, la connessione funziona.

Risoluzione dei problemi

• 401 / invalid key: verifica che la chiave abbia il prefisso aw_live_* o aw_test_* e non sia stata revocata. Puoi controllarlo nella dashboard.
• Gli strumenti non compaiono: riavvia completamente Windsurf e controlla il percorso ~/.codeium/windsurf/mcp_config.json (per hosted, la chiave serverUrl).
• Errori di validazione -32602 (per stdio): aggiorna il pacchetto con npm i @astroway/mcp@latest. Gli schemi vengono rigenerati dalla specifica aggiornata.

Tutti i client: Configurazione dell’agente.