Windsurf

Csatlakoztasd az AstroWay API-t a Windsurf-höz MCP-n keresztül. A szerver a Cascade asszisztenst használja.

Előfeltételek

Szerezz be egy API-kulcsot a műszerfalon. Ingyenes teszteléshez használd az aw_test_* sandbox kulcsot – ez nem von le krediteket.

Csatlakozás

Szerkeszd a ~/.codeium/windsurf/mcp_config.json fájlt; ez elérhető a Beállítások → Cascade → MCP menüpontban is. Figyelem: távoli szerver esetén a Windsurf a serverUrl kulcsot használja (nem az url-t). Illessz be az alábbi blokkok egyikét, és indítsd újra a Windsurföt.

Hosted (HTTP): telepítés nélkül, Bearer token alapú hitelesítés:

~/.codeium/windsurf/mcp_config.json

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

Stdio (npx): helyi alfolyamat, env-változó alapú hitelesítés, offline is működik:

~/.codeium/windsurf/mcp_config.json

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

Ellenőrzés

A Cascade-ben írd be: „Sorold fel az Astroway eszközöket” – vagy kérd meg, hogy hívjon meg egy ingyenes referenciaeszközt, például a csillagjegyek listájának lekérését. Ha válaszként eredményt kapsz, a csatlakozás működik.

Hibaelhárítás

• 401 / invalid key: győződj meg róla, hogy a kulcs aw_live_* vagy aw_test_* előtaggal rendelkezik, és nincs visszavonva. Ezt a műszerfalon ellenőrizheted.
• Az eszközök nem jelennek meg: indítsd újra teljesen a Windsurföt, és ellenőrizd a ~/.codeium/windsurf/mcp_config.json útvonalat (hosted esetén a serverUrl kulcsot).
• -32602 érvényesítési hibák (stdio esetén): frissítsd a csomagot: npm i @astroway/mcp@latest. A sémák az aktuális specifikációból generálódnak újra.

Minden kliens – Ügynök beállítása.