Claude Desktop

Hubungkan API AstroWay ke Claude Desktop melalui MCP. Kedua transport tersedia: hosted (HTTP) dan paket stdio lokal.

Pra-syarat

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

Menghubungkan

Buka Settings → Developer → Edit Config - Claude Desktop akan menampilkan path ke file claude_desktop_config.json. Tempelkan salah satu blok di bawah ini dan restart Claude Desktop.

Hosted (HTTP): tanpa paket kami, otentikasi melalui Bearer-token. Konfigurasi Claude Desktop hanya menjalankan perintah lokal dan melewatkan entri dengan url itu sendiri, sehingga server hosted terhubung melalui bridge mcp-remote:

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" }
  }
}
}

Kunci berada di env, bukan di args, karena Claude Desktop di Windows memisahkan argumen pada spasi setelah Bearer. Untuk memuat satu topik saja alih-alih seluruh katalog, ganti /mcp dengan server domain, misalnya /mcp/core atau /mcp/vedic.

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

claude_desktop_config.json

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

Pemeriksaan

Ketik Claude di chat: “Daftar alat Astroway” - atau minta memanggil reference-tool gratis, misalnya mendapatkan daftar tanda zodiak. Jika respons berisi hasil, koneksi berhasil.

Pemecahan Masalah

• 401 / invalid key: pastikan kunci memiliki prefiks aw_live_* atau aw_test_* dan tidak dicabut. Kamu dapat memeriksanya di dasbor.
• “Some MCP servers couldn’t be loaded”: di entri url gunakan command. Gunakan blok dengan mcp-remote di atas.
• Alat tidak muncul: restart Claude Desktop sepenuhnya (keluar, bukan hanya menutup jendela) dan periksa path ke claude_desktop_config.json.
• Kesalahan validasi -32602 (untuk stdio): perbarui paket: npm i @astroway/mcp@latest. Skema akan diregenerasi dari spesifikasi terbaru.

Semua klien - Pengaturan agen.