Windsurf

Connetti l’API AstroWay a Windsurf tramite MCP. Il server utilizza l’assistente Cascade.

Premesse

Ottieni l’API-key sul dashboard. Per il test gratuito utilizza il sandbox-key aw_test_* - non inciderà sui crediti.

Connettività

Modifica ~/.codeium/windsurf/mcp_config.json; anche disponibile tramite Settings → Cascade → MCP. Nota: per il server remoto Windsurf utilizza la chiave serverUrl (non url). Inserisci uno dei blocchi sotto e riavvia Windsurf.

Hosted (HTTP): senza 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): processo locale, autenticazione tramite variabile 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

Nella Cascade scrivi: «Elenco gli strumenti Astroway» - o chiedi l’invio di uno strumento di riferimento gratuito, ad esempio il elenco dei segni zodiacali. Se viene restituito un risultato, la connessione funziona.

Risoluzione dei problemi

• 401 / chiave non valida: assicurati che la chiave abbia il prefisso aw_live_* o aw_test_* e non sia stata revocata. Verifica possibile sul dashboard.
• Gli strumenti non appaiono: riavvia completamente Windsurf e verifica il percorso ~/.codeium/windsurf/mcp_config.json (per hosted - la chiave serverUrl).
• Errori di validazione -32602 (per stdio): aggiorna il pacchetto: npm i @astroway/mcp@latest. Le schemi vengono ricreati con la specifica attuale.

Tutti i clienti - Impostazioni dell’agente.