Claude Desktop

Hubungkan API AstroWay ke Claude Desktop melalui MCP: ekstensi satu klik atau secara manual melalui konfigurasi, dengan server yang dihosting (HTTP) atau package stdio lokal.

Prasyarat

Dapatkan API key di dashboard. Untuk pengujian gratis, gunakan sandbox key aw_test_* - ini tidak akan mengurangi kredit.

Ekstensi Satu Klik

1. Unduh astroway.mcpb.
2. Buka file. Claude Desktop akan menampilkan dialog instalasi.
3. Masukkan API key, pilih kelompok alat (secara default: peta kelahiran, transit, progresi, return, sinastri, dan kalender) dan aktifkan ekstensi.

Tidak perlu mengedit konfigurasi. Ekstensi ini adalah npm package @astroway/mcp dengan dependensinya, dibangun dari rilis yang sama. Kosongkan field grup untuk memuat semua 700+ alat.

Koneksi Manual

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

Hosted (HTTP): tanpa package kami, autentikasi melalui Bearer token. Konfigurasi Claude Desktop hanya menjalankan perintah lokal dan melewati entri dengan url itu sendiri, sehingga server terhubung melalui jembatan 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" }
  }
}
}

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

Stdio (npx): proses lokal, autentikasi 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" }
  }
}
}

Verifikasi

Tulis ke Claude di chat: “Daftarkan alat Astroway” - atau minta untuk memanggil alat referensi gratis, misalnya mendapatkan daftar tanda zodiak. Jika mendapatkan respons, koneksi berfungsi.

Pemecahan Masalah

• 401 / invalid key: pastikan key memiliki prefix aw_live_* atau aw_test_* dan tidak dicabut. Anda dapat memeriksa di dashboard.
• “Some MCP servers couldn’t be loaded”: ada entri url bukan 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.
• Error validasi -32602 (untuk stdio): perbarui package: npm i @astroway/mcp@latest. Skema akan digenerasi ulang dari spesifikasi terkini.

Semua klien - Pengaturan Agent.