Windsurf

Hubungkan API AstroWay ke Windsurf melalui MCP. Server menggunakan asisten Cascade.

Persyaratan

Dapatkan API-key di dasbor. Untuk pengujian gratis gunakan sandbox-key aw_test_* - tidak mengurangi kredit.

Menghubungkan

Edit ~/.codeium/windsurf/mcp_config.json; juga tersedia melalui Settings → Cascade → MCP. Perhatikan: untuk server remote Windsurf menggunakan kunci serverUrl (bukan url). Tempelkan salah satu blok di bawah ini dan restart Windsurf.

Hosted (HTTP): tanpa instalasi, otentikasi melalui Bearer-token:

~/.codeium/windsurf/mcp_config.json

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

Stdio (npx): proses sub lokal, otentikasi melalui variabel env, bekerja offline:

~/.codeium/windsurf/mcp_config.json

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

Pemeriksaan

Di Cascade ketik: «Daftar alat Astroway» - atau minta memanggil alat referensi gratis, misalnya mendapatkan daftar tanda zodiak. Jika respons berisi hasil, koneksi berfungsi.

Pemecahan Masalah

• 401 / invalid key: pastikan kunci memiliki prefiks aw_live_* atau aw_test_* dan tidak dicabut. Bisa dicek di dasbor.
• Alat tidak muncul: restart Windsurf sepenuhnya dan periksa jalur ~/.codeium/windsurf/mcp_config.json (untuk hosted - kunci serverUrl).
• Kesalahan validasi -32602 (untuk stdio): perbarui paket: npm i @astroway/mcp@latest. Skema akan diregenerasi dari spesifikasi terbaru.

Semua klien - Pengaturan agen.