Windsurf

AstroWay API’sini Windsurf’e MCP aracılığıyla bağlayın. Sunucu Cascade yardımcıyı kullanıyor.

Öncülere

AstroWay API anahtarı dashboard’dan alın. Ücretsiz test için aw_test_* sandbox anahtarı kullanın - bu kredi tahsil etmez.

Bağlantı

~/.codeium/windsurf/mcp_config.json’ü düzenleyin; ayrıca Settings → Cascade → MCP aracılığıyla erişilebilir. Dikkat: uzak sunucuda Windsurf, serverUrl (değil url) anahtarı kullanır. Aşağıdaki bloklardan birini yerleştirin ve Windsurf’i yeniden başlatın.

Ağırlık (HTTP): kurulması gerekmez, Bearer token ile otomatik kimlik doğrulama:

~/.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ç, ortam değişkeni ile kimlik doğrulama, offline çalışır:

~/.codeium/windsurf/mcp_config.json

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

Kontrol

Cascade’da yazın: “AstroWay Araçları Listesi” - veya ücretsiz bir referans aracı çağırın, örneğin zodyak işaretleri listesini alın. Eğer cevapta sonuç gelirse, bağlantısı çalışıyor.

Sorunların Çözümü

• 401 / geçersiz anahtar: anahtarın aw_live_* veya aw_test_* ön ekine sahip olduğundan ve iptal edilmemiş olduğundan emin olun. Kontrol edebilirsiniz dashboard’da.
• Araçlar görünmez: Windsurf’i tamamen yeniden başlatın ve ~/.codeium/windsurf/mcp_config.json yolunu kontrol edin (hosted için serverUrl anahtarı).
• -32602 hatalı doğrulama (stdio için): paketi güncelleyin: npm i @astroway/mcp@latest. Schemas yenilenir ve güncel spesifikasyonla uyumlu hale gelir.

Tüm müşteriler - Ajan Ayarları.