Windsurf

Conectează API-ul AstroWay la Windsurf prin MCP. Serverul este folosit de asistentul Cascade.

Cerințe preliminare

Obține o cheie API din dashboard. Pentru teste gratuite folosește o cheie sandbox aw_test_*: nu consumă credite.

Conectare

Editează ~/.codeium/windsurf/mcp_config.json; este accesibil și din Settings → Cascade → MCP. Atenție: pentru un server la distanță, Windsurf folosește cheia serverUrl (nu url). Inserează unul dintre blocurile de mai jos și repornește Windsurf.

Hosted (HTTP): fără instalare, autentificare prin token Bearer:

~/.codeium/windsurf/mcp_config.json

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

Stdio (npx): subproces local, autentificare prin variabilă de mediu, funcționează offline:

~/.codeium/windsurf/mcp_config.json

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

Verificare

În Cascade scrie: “Listează instrumentele Astroway” sau cere-i să apeleze un instrument de referință gratuit, de exemplu să obțină lista semnelor zodiacale. Dacă primești un rezultat, conexiunea funcționează.

Depanare

• 401 / invalid key: verifică dacă cheia are prefixul aw_live_* sau aw_test_* și nu a fost revocată. Poți verifica în dashboard.
• Instrumentele nu apar: repornește complet Windsurf și verifică calea ~/.codeium/windsurf/mcp_config.json (pentru hosted, cheia serverUrl).
• Erori de validare -32602 (pentru stdio): actualizează pachetul cu npm i @astroway/mcp@latest. Schemele sunt regenerate din specificația actuală.

Toți clienții: Configurarea agentului.