MCP - koneksi Claude / Cursor

Server Model Context Protocol AstroWay mengekspos semua 771 endpoint sebagai alat untuk agen AI. Dua mode - keduanya didukung secara native oleh semua klien yang kompatibel dengan MCP.

Mode	URL / perintah	Kapan memilih
Hosted HTTP	https://mcp.astroway.info/mcp	Claude Web (claude.ai di browser), Claude Desktop / Cursor / Code newcomers tanpa npm, atau ketika kamu ingin zero-install
Stdio (npm)	npx @astroway/mcp	Pengguna berat Cursor, pengembangan lokal, sadar privasi (kunci tidak pernah meninggalkan mesin kamu), siap offline

Endpoint yang di-host dan paket npm menggunakan katalog alat yang sama (dihasilkan dari satu /v1/openapi.json). Auth: kunci API aw_test_* / aw_live_* yang sama - di-host dikirim melalui header Authorization: Bearer …, di stdio - melalui variabel lingkungan ASTROWAY_API_KEY.

Sumber: github.com/astroway/astroway-mcp · npm: npmjs.com/package/@astroway/mcp · hosted: mcp.astroway.info/health

Hosted (mcp.astroway.info) - zero install

Mulai cepat tanpa npm - pilih klien kamu. Sebelum instalasi, dapatkan kunci di api.astroway.info/dashboard/sign-up (10.000 kredit/bulan gratis).

Cursor (one-click)

Klik tombol - Cursor akan terbuka, meminta konfirmasi, dan menambahkan entri secara otomatis:

Install in Cursor →

Langkah ke-2 yang wajib - jika tidak, tidak akan berfungsi

Cursor tidak dapat menyisipkan rahasia dari deeplink - di ~/.cursor/mcp.json akan tertulis literal Bearer YOUR_API_KEY, yang akan direspons server dengan 403 invalid_format.

Setelah mengklik tombol:

1. Pengaturan Cursor (⚙️ sudut kanan atas) → Tools & MCP → temukan astroway-hosted di daftar.
2. Klik tiga titik (⋯) di samping server → Edit configuration.
3. Di kolom Authorization, ganti Bearer YOUR_API_KEY dengan Bearer aw_test_… (atau aw_live_…) - kunci asli kamu dari Dashboard.
4. Simpan → buka kembali daftar MCP → pastikan status enabled + titik hijau + penghitung 780+ tools enabled.

Alternatifnya - edit file secara langsung: ~/.cursor/mcp.json (headers.Authorization).

Catatan

Cursor memberlakukan batas panjang nama: server_name:tool_name ≤ 60 karakter. Sekitar 90 dari 780+ alat (sebagian besar grup hellenistic_*, psychological_*, zi_wei_*, zodiac_* dan numerology_*) difilter oleh Cursor dan tidak akan tersedia melalui LLM. Sekitar ~690 lainnya berfungsi. Di Claude Desktop tidak ada batasan seperti itu - katalog lengkap.

Claude Desktop

Pengaturan → Developer → Edit Config membuka claude_desktop_config.json. File ini hanya menjalankan perintah lokal: entri dengan url itu sendiri dilewati dengan pesan “Some MCP servers couldn’t be loaded”. Server yang di-host terhubung melalui jembatan mcp-remote, yang membutuhkan Node.js:

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

Tutup sepenuhnya Claude Desktop (Cmd+Q) dan buka kembali. Kunci berada di env, karena Claude Desktop di Windows memutus argumen pada spasi setelah Bearer.

Dialog Add custom connector di Settings → Connectors hanya menerima nama dan URL, tidak ada kolom untuk header Authorization, jadi kunci AstroWay tidak dapat diteruskan melaluinya saat ini.

JSON config (manual)

Untuk Cursor, Cline, Continue, dan Windsurf, yang menerima url jarak jauh secara langsung:

{
  "mcpServers": {
    "astroway-hosted": {
      "url": "https://mcp.astroway.info/mcp",
      "headers": {
        "Authorization": "Bearer aw_live_..."
      }
    }
  }
}

Jalur ke konfigurasi:

• Cursor: ~/.cursor/mcp.json (secara global) atau .cursor/mcp.json (di workspace)
• Cline (VS Code): .cline/mcp.json di workspace
• Continue: ~/.continue/config.json (blok mcpServers)
• Windsurf: ~/.codeium/windsurf/mcp_config.json

Setelah mengedit, mulai ulang klien sepenuhnya (Cmd+Q → buka kembali).

Verifikasi

curl https://mcp.astroway.info/health
# {"status":"ok","version":"…","uptime_sec":…,"mcp_protocol_version":"…"}

Di klien - minta: “List 5 AstroWay tool names from astroway-hosted”. Seharusnya mengembalikan nama-nama seperti astroway_western_chart, astroway_horoscope_daily, astroway_vedic_panchang_full, …

Batas Tingkat

Endpoint yang di-host dilindungi oleh batasan 3 tingkat: lapisan DDoS Cloudflare + proxy edge 120 req/min/IP + bucket in-memory 60/60s/(IP+key). Klien MCP yang sebenarnya (Claude Desktop, Cursor) tidak mendekati batas ini - mereka tidak membuat permintaan burst. Jika otomatisasi / CI kamu membutuhkan > 120 req/min - gunakan mode stdio (tidak ada batasan di sana, langsung melalui api.astroway.info/v1/* dengan rate-limit tarif kamu).

Bagaimana jika mcp.astroway.info sementara tidak tersedia

Jika endpoint yang di-host mengembalikan 5xx, klien MCP akan melihat kesalahan saat tools/list. Ini tidak memengaruhi klien stdio - mereka menjalankan paket npm lokal yang langsung menuju api.astroway.info/v1/* tanpa lapisan host perantara.

Fallback untuk integrasi kritis: tambahkan server MCP kedua ke konfigurasi dengan mode stdio - klien akan secara otomatis menggunakannya jika yang di-host tidak merespons tools/list:

{
  "mcpServers": {
    "astroway": {
      "url": "https://mcp.astroway.info/mcp",
      "headers": { "Authorization": "Bearer aw_live_..." }
    },
    "astroway-fallback": {
      "command": "npx",
      "args": ["-y", "@astroway/mcp"],
      "env": { "ASTROWAY_API_KEY": "aw_live_..." }
    }
  }
}

Uptime sebenarnya dari endpoint yang di-host dapat dilihat di status.astroway.info. Insiden > 5 menit kami publikasikan sebagai postmortem dalam waktu 5 hari kerja (sesuai /sla/).

Stdio (npm) - untuk pengembangan lokal

@astroway/mcp - paket npm yang berjalan secara lokal sebagai subprocess. Satu paket npm, integrasi native dengan Claude Desktop, Cursor, dan klien yang kompatibel dengan MCP lainnya.

Bagaimana cara kerjanya

Daftar alat dihasilkan pada saat build dari spesifikasi OpenAPI live (api.astroway.info/v1/openapi.json). Setiap rilis paket secara otomatis mengambil semua endpoint baru - tidak perlu pemeliharaan manual.

Setiap endpoint menjadi alat jenis:

• tools/list mengembalikan deskripsi dan skema input (dengan contoh body permintaan)
• tools/call melakukan HTTP POST ke https://api.astroway.info/v1/<path> dengan ASTROWAY_API_KEY kamu
• Respons dikembalikan ke agen sebagai JSON terstruktur

Setiap rilis juga dikirimkan dengan SLSA provenance (Sigstore-attested) - ini adalah jaminan bahwa paket npm dibangun dari commit di repo publik.

Instalasi

Claude Desktop (macOS)

Tambahkan ke ~/Library/Application Support/Claude/claude_desktop_config.json:

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

Mulai ulang Claude Desktop. Di bilah di bawah obrolan akan muncul indikator 🛠️ dengan jumlah alat yang dimuat.

Cursor

Tambahkan ke ~/.cursor/mcp.json:

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

Cline / Continue / Windsurf / Copilot / VS Code MCP

Perintah npx @astroway/mcp yang sama berfungsi di setiap klien yang kompatibel dengan MCP. Konfigurasi identik - hanya jalur ke file yang berubah:

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

Klien	Jalur ke konfigurasi
Cline (VS Code)	.cline/mcp.json di root workspace
Continue	~/.continue/config.json (di bawah mcpServers)
Windsurf	~/.codeium/windsurf/mcp_config.json
GitHub Copilot Chat (VS Code)	preview-flag → mcp.json di workspace
VS Code MCP extension	~/.vscode/mcp.json

Klien MCP lainnya

Jalankan sebagai server stdio:

ASTROWAY_API_KEY=aw_live_... npx @astroway/mcp

Tips

Dapatkan kunci - di api.astroway.info/dashboard/sign-up. Tingkat gratis - 10 000 kredit/bulan, tanpa kartu.

Privasi - sejak v1.0.0+

Server MCP ini tidak mengirimkan apa pun kembali ke AstroWay kecuali panggilan API yang kamu berikan untuk dieksekusi. Tidak ada telemetri, tidak ada analitik, tidak ada sakelar opt-in/opt-out - keheningan secara default.

Permintaan keluar membawa dua header identifikasi agar backend AstroWay dapat membedakan lalu lintas MCP dari HTTP langsung di log-nya sendiri:

• User-Agent: astroway-mcp/<version> (Node/<node-version>)
• X-Astroway-Channel: mcp

Tidak satu pun dari mereka berisi ID sesi, sidik jari mesin, atau apa pun yang bersifat pribadi. Ini adalah semantik User-Agent standar - setiap alat CLI mengirimkan informasi serupa.

Pendaftaran Subset - sejak v1.0.0+

Jika kamu hanya menggunakan sebagian dari katalog - daftarkan subset agar jendela konteks LLM tetap ringkas:

{
  "env": {
    "ASTROWAY_API_KEY": "aw_live_...",
    "ASTROWAY_TOOL_GROUPS": "western,vedic,relational",   // only these prefixes
    "ASTROWAY_READONLY": "1"                               // skip ai/horoscope/reports (LLM-backed, costs credits)
  }
}

Grup umum: western, vedic, tarot, numerology, hd (Human Design), relational (synastry/composite/davison), prognostics (transits/progressions/returns), aspects, horary, geo, chinese, bazi, mayan, iching, runes, geomancy. Jalankan npx @astroway/mcp --list-tools untuk melihat set lengkapnya.

ASTROWAY_READONLY=1 melewati tiga grup yang secara internal memanggil LLM (ai, horoscope, reports) - berguna jika kamu menginginkan matematika bagan yang murni deterministik tanpa menghabiskan kredit untuk pembuatan teks.

Komitmen Stabilitas - sejak v1.0.0+

• Katalog dibekukan selama sesi. 780+ alat, 12 prompt, 14 sumber daya tertanam dalam paket npm yang diterbitkan pada saat build - tidak ada yang berubah selama koneksi. Jika klien kamu menyimpan tools/list setelah panggilan pertama - itu tetap benar untuk seluruh sesi.
• Pengidentifikasi alat stabil dalam versi mayor. Nama di bawah astroway_<group>_<tool> tidak akan diganti nama atau dihapus dalam v1.x tanpa catatan deprecation di CHANGELOG.md dan ketersediaan paralel satu minor.
• Bentuk input alat stabil dalam versi minor. Pengetatan (regex, range, enum) datang dalam patch; penambahan bidang wajib memerlukan minor bump.
• Penyegaran katalog: dengan instalasi ulang. npm i -g @astroway/mcp@latest (atau bentuk npx -y @astroway/mcp dalam konfigurasi kamu) mengambil set saat ini pada startup berikutnya.

Contoh Prompt

Setelah menghubungkan server, minta AI:

Bagan Kelahiran

Hitung bagan kelahiran saya - lahir 15 Maret 1990, 14:30, Kyiv. Jelaskan Matahari, Bulan, Ascendant, dan temukan aspek-aspek yang erat.

Claude akan memanggil alat chart dengan parameter kamu, menerima JSON terstruktur, dan menjelaskan bagan tersebut dengan kata-kata.

Transit

Transit planet lambat signifikan apa yang akan memengaruhi bagan kelahiran saya sepanjang tahun 2027?

Claude melakukan dua panggilan alat: pertama transits (snapshot saat ini), lalu transit-calendar (rentang). Menginterpretasikan tren.

Mahadasha Veda

Jalankan Vimshottari Mahadasha untuk seseorang yang lahir 22.07.1985 06:45 di Mumbai. Dalam periode apa orang ini sekarang?

Melalui alat vedic/dashas/vimshottari/maha - timestamp UTC yang tepat dari periode saat ini.

Sinastri

Bandingkan dua bagan: A - 10.06.1988 09:15 London, B - 22.11.1991 22:40 Berlin. Apa aspek silang terkuatnya?

alat synastry dengan dua blok chart + interpretasi skor kompatibilitas.

Tarot

Tarik 3 kartu Rider-Waite-Smith: Masa Lalu - Masa Kini - Masa Depan. Pertanyaan: “apakah saya harus menerima pekerjaan baru?”. Seed = 42.

tarot/rider-waite/spread dengan seed tetap untuk reproduktifitas.

Daftar semua alat

Setelah menghubungkan, tanyakan pada Claude:

Daftarkan semua alat astroway.

Atau dari baris perintah:

ASTROWAY_API_KEY=aw_test_smoke npx @astroway/mcp 2>&1 | head -1
# (starts the stdio server; tool-list calls come from the MCP client over the protocol)

Konfigurasi

Variabel	Default	Deskripsi	Sejak versi
ASTROWAY_API_KEY	(wajib)	Live: aw_live_.... Sandbox: aw_test_....	0.1.0
ASTROWAY_BASE_URL	https://api.astroway.info/v1	Override untuk lingkungan self-hosted/staging.	0.1.0
ASTROWAY_TOOL_GROUPS	(semua grup)	Prefiks yang dipisahkan koma untuk membatasi katalog (western,vedic,relational).	1.0.0
ASTROWAY_READONLY	0	1 melewati grup yang didukung LLM (ai, horoscope, reports).	1.0.0
LOG_LEVEL	error	silent/error/warn/info/debug - tingkat logging ke stderr.	0.8.0
LOG_FILE	(tidak ditulis)	Jalur ke file untuk menduplikasi log.	0.8.0
MCP_FLAT_TOOLS	0	1 mengembalikan nama flat pre-v0.9 (chart alih-alih astroway_western_chart). Legacy.	0.9.0

Mengapa MCP, bukan integrasi langsung

LLM generik (tanpa grounding) akan mengatakan “sekitar bulan Juli Saturnus akan membentuk trine dengan Jupiter kamu” - tanpa tanggal pasti, dengan penyimpangan ±15 hari. Agen MCP melakukan tool_use POST /v1/transits dan mengembalikan timestamp UTC hingga detik, berdasarkan Swiss Ephemeris yang asli.

Keuntungannya bukan pada LLM, tetapi pada jaminan bahwa matematika itu nyata - bukan fiktif.

Distribusi Paket

• mcp.so listing: mcp.so/server/astroway-mcp/astroway
• mcpservers.org: menunggu persetujuan (per Mei 2026)
• awesome-mcp-servers (punkpeye): PR #5972

Tautan

• 📦 npm: npmjs.com/package/@astroway/mcp
• 📘 Dokumentasi API: /docs/api/
• 🔑 Daftar: /dashboard/sign-up
• 💰 Harga: /pricing/
• 🌐 Repo Publik (MIT): github.com/astroway/astroway-mcp