Windsurf

AstroWay API’yi MCP üzerinden Windsurf’e bağlayın. Sunucuyu Cascade asistanı kullanır.

Ön koşullar

API anahtarınızı panelden alın. Ücretsiz test için aw_test_* sandbox anahtarını kullanın: kredi düşmez.

Bağlantı

~/.codeium/windsurf/mcp_config.json dosyasını düzenleyin; Settings → Cascade → MCP üzerinden de erişilebilir. Dikkat: uzak sunucu için Windsurf serverUrl anahtarını kullanır (url değil). Aşağıdaki bloklardan birini ekleyin ve Windsurf’ü yeniden başlatın.

Hosted (HTTP): kurulum gerektirmez, kimlik doğrulama Bearer token ile yapılır:

~/.codeium/windsurf/mcp_config.json

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

Stdio (npx): yerel alt süreç, kimlik doğrulama ortam değişkeni ile yapılır, çevrim dışı çalışır:

~/.codeium/windsurf/mcp_config.json

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

Doğrulama

Cascade’e şunu yazın: “Astroway araçlarını listele” ya da ücretsiz bir referans aracını çağırmasını isteyin, örneğin burçların listesini almasını. Yanıt olarak bir sonuç geliyorsa bağlantı çalışıyor demektir.

Sorun giderme

• 401 / invalid key: anahtarın aw_live_* veya aw_test_* önekine sahip olduğundan ve iptal edilmediğinden emin olun. Bunu panelden kontrol edebilirsiniz.
• Araçlar görünmüyor: Windsurf’ü tamamen yeniden başlatın ve ~/.codeium/windsurf/mcp_config.json yolunu kontrol edin (hosted için serverUrl anahtarı).
• -32602 doğrulama hataları (stdio için): paketi güncelleyin: npm i @astroway/mcp@latest. Şemalar güncel spesifikasyondan yeniden üretilir.

Tüm istemciler: Ajan kurulumu.