Claude Desktop

AstroWay API’sini Claude Desktop üzerinden MCP aracılığıyla bağlayın. Hem hosted (HTTP) hem de yerel stdio paketi olmak üzere iki taşıma seçeneği mevcuttur.

Önkoşullar

API anahtarını dashboard’da alın. Ücretsiz testler için sandbox anahtarını aw_test_* kullanın - bu kredileri düşürmez.

Bağlantı

Ayarlar → Geliştirici → Yapılandırma Düzenle’yi açın - Claude Desktop claude_desktop_config.json dosyasının yolunu gösterecektir. Aşağıdaki bloklardan birini ekleyin ve Claude Desktop’ı yeniden başlatın.

Hosted (HTTP): Paketimiz olmadan, Bearer token ile kimlik doğrulama. Claude Desktop yapılandırması yalnızca yerel komutları çalıştırır ve url ile olan girdiyi atlar, bu nedenle hosted sunucusu mcp-remote köprüsü üzerinden bağlanır:

claude_desktop_config.json

{
"mcpServers": {
  "astroway": {
    "command": "npx",
    "args": ["-y", "mcp-remote", "https://mcp.astroway.info/mcp", "--header", "Authorization:${AUTH_HEADER}"],
    "env": { "AUTH_HEADER": "Bearer aw_live_YOUR_KEY" }
  }
}
}

Anahtar env içinde değil args içinde olmalıdır çünkü Claude Desktop Windows’ta Bearer sonrasındaki boşlukta argümanı böler. Tüm katalog yerine tek bir konu yüklemek için /mcp yerine alan adı sunucusunu kullanın, örneğin /mcp/core veya /mcp/vedic.

Stdio (npx): Yerel alt süreç, env değişkeni ile kimlik doğrulama, çevrimdışı çalışır:

claude_desktop_config.json

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

Doğrulama

Chate Claude’a yazın: “Astroway araçlarını listeleyin” - veya ücretsiz bir reference aracı çağırın, örneğin burç listesini alın. Yanıtta bir sonuç alırsanız, 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. Dashboard’da kontrol edebilirsiniz.
• “Some MCP servers couldn’t be loaded”: Girdide url yerine command kullanılmış. Yukarıdaki mcp-remote bloğunu kullanın.
• Araçlar görünmüyor: Claude Desktop’ı tamamen yeniden başlatın (sadece pencereyi kapatmak yerine çıkın) ve claude_desktop_config.json dosyasının yolunu kontrol edin.
• Doğrulama hataları -32602 (stdio için): Paketi güncelleyin: npm i @astroway/mcp@latest. Şemalar güncel spesifikasyondan yeniden oluşturulur.

Tüm istemciler - Ajan Ayarları.