Windsurf

Připojte API AstroWay k Windsurf přes MCP. Server používá asistenta Cascade.

Předpoklady

Získejte API klíč na dashboardu. Pro bezplatné testování použijte sandbox klíč aw_test_* – neodečítá kredity.

Připojení

Upravte ~/.codeium/windsurf/mcp_config.json; také je dostupné přes Settings → Cascade → MCP. Všimněte si: pro vzdálený server Windsurf používá klíč serverUrl (ne url). Vložte jeden z bloků níže a restartujte Windsurf.

Hosted (HTTP): bez instalace, autentizace přes Bearer token:

~/.codeium/windsurf/mcp_config.json

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

Stdio (npx): lokální podproces, autentizace přes env proměnnou, funguje offline:

~/.codeium/windsurf/mcp_config.json

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

Kontrola

V Cascade napište: „Vyjmenuj nástroje Astroway“ – nebo požádejte o volání bezplatného reference nástroje, například získat seznam znamení zvěrokruhu. Pokud odpověď obsahuje výsledek, připojení funguje.

Odstraňování problémů

• 401 / invalid key: ujistěte se, že klíč má prefix aw_live_* nebo aw_test_* a není odvolán. Ověřit můžete na dashboardu.
• Nástroje se nezobrazují: úplně restartujte Windsurf a zkontrolujte cestu ~/.codeium/windsurf/mcp_config.json (pro hosted – klíč serverUrl).
• Chyby validace -32602 (pro stdio): aktualizujte balíček: npm i @astroway/mcp@latest. Schémata se přegenerují z aktuální specifikace.

Všichni klienti – Nastavení agenta.