Claude Desktop

AstroWay API’sini Claude Desktop ile MCP üzerinden bağlayın: tek tıklama uzantısıyla veya yapılandırmayı elle yaparak, barındırılan sunucu (HTTP) ile veya yerel stdio paketiyle.

Ön Koşullar

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

Tek Tıklama Uzantısı

1. astroway.mcpb dosyasını indirin.
2. Dosyayı açın. Claude Desktop yükleme iletişim kutusunu gösterecektir.
3. API anahtarını yapıştırın, araç gruplarını seçin (varsayılan olarak doğum haritaları, transitler, ilerlemeler, dönüşümler, sinastri ve takvim) ve uzantığı etkinleştirin.

Yapılandırmayı düzenlemenize gerek yok. Uzantı, bağımlılıklarıyla birlikte @astroway/mcp npm paketidir ve aynı sürümden derlenmiştir. Tüm 700+ aracı yüklemek için grup alanını temizleyin.

Manuel Bağlantı

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

Barındırılan (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 kaydı atlar, bu nedenle barındırılan sunucu 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 bulunur çü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’yi alan sunucusuyla değiştirin, ö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

Claude’a sohbette yazın: “Astroway araçlarını listeleyin” - veya ücretsiz bir reference aracı çağırmasını isteyin, örneğin burç listesini alın. Yanıtta bir sonuç alırsanız, bağlantı çalışıyor.

Sorun Giderme

• 401 / geçersiz anahtar: anahtarın aw_live_* veya aw_test_* önekine sahip olduğundan ve iptal edilmediğinden emin olun. Panoda kontrol edebilirsiniz.
• “Bazı MCP sunucuları yüklenemedi”: command yerine url kaydı. Yukarıdaki mcp-remote bloğunu kullanın.
• Araçlar görünmüyor: Claude Desktop’i tamamen yeniden başlatın (sadece pencereyi kapatmak yerine çıkın) ve claude_desktop_config.json 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 - Ayarlar.