MCP - Claude / Cursor Bağlantısı

Model Context Protocol sunucusu AstroWay tüm 771 uç noktalarını AI ajanı için araçlar olarak sunar. İki mod - ikisi de tüm MCP uyumlu istemciler tarafından yerel olarak desteklenir.

Mod	URL / komut	Ne zaman seçilir
Hosted HTTP	https://mcp.astroway.info/mcp	Claude Web (claude.ai tarayıcıda), Claude Desktop / Cursor / Code yeni başlayanlar npm olmadan, ya da zero-install istediğinde
Stdio (npm)	npx @astroway/mcp	Cursor güç kullanıcıları, yerel geliştirme, gizlilik odaklı (anahtar asla makinenizden çıkmaz), çevrim dışı hazır

Hosted uç noktası ve npm paketi aynı araç kataloğunu (/v1/openapi.json’dan üretilir) kullanır. Auth: aynı aw_test_* / aw_live_* API anahtarı - hosted’ta Authorization: Bearer … başlığıyla gönderilir, stdio’da ise ASTROWAY_API_KEY ortam değişkeniyle.

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

Hosted (mcp.astroway.info) - sıfır kurulum

npm olmadan hızlı başlangıç - kendi istemceni seç. Kurulumdan önce api.astroway.info/dashboard/sign-up adresinden anahtar al (ayda 10 000 kredi ücretsiz).

Cursor (one-click)

Butona tıkla - Cursor açılacak, onaylamanı isteyecek, kaydı otomatik olarak ekleyecek:

Cursor’a Kur →

Zorunlu 2. adım - aksi takdirde çalışmaz

Cursor, deeplink’ten gizli anahtarı ekleyemez - ~/.cursor/mcp.json dosyasına literal Bearer YOUR_API_KEY yazar, bu da sunucunun 403 invalid_format yanıt vermesine neden olur.

Butona tıkladıktan sonra:

1. Cursor Settings (⚙️ sağ üst köşe) → Tools & MCP → listede astroway-hosted bul.
2. Sunucunun yanındaki üç noktaya (⋯) tıkla → Edit configuration.
3. Authorization alanında Bearer YOUR_API_KEY yerine Bearer aw_test_… (veya aw_live_…) koy - gerçek anahtarın Dashboard üzerinden.
4. Kaydet → MCP listesini tekrar aç → durumun enabled + yeşil nokta + 780+ tools enabled sayacını kontrol et.

Alternatif olarak - dosyayı doğrudan düzenle: ~/.cursor/mcp.json (headers.Authorization).

Not

Cursor, isim uzunluğuna limit koyar: server_name:tool_name ≤ 60 karakter. 780+ araçtan yaklaşık 90’ı (çoğunlukla hellenistic_*, psychological_*, zi_wei_*, zodiac_* ve numerology_* grupları) Cursor tarafından filtrelenir ve LLM üzerinden erişilemez. Diğer ~690 çalışır. Claude Desktop’ta böyle bir limit yok - tam katalog.

Claude Desktop

Settings → Developer → Edit Config, claude_desktop_config.json dosyasını açar. Bu dosya yalnızca yerel komutları çalıştırır: url kaydı, “Some MCP servers couldn’t be loaded” mesajı ile atlanır. Hosted sunucu mcp-remote köprüsü üzerinden bağlanır ve Node.js gerekir:

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

Claude Desktop’ı tamamen kapat (Cmd+Q) ve tekrar aç. Anahtar env içinde bulunur, çünkü Claude Desktop Windows’ta Bearer sonrası boşlukta argümanı bölüyor.

Settings → Connectors içindeki Add custom connector diyaloğu sadece isim ve URL alır, Authorization başlığı için bir alan yok, bu yüzden AstroWay anahtarını şu anda bu yolla iletemezsin.

JSON config (manual)

Cursor, Cline, Continue ve Windsurf için, uzaktan url doğrudan kabul edenler:

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

Yapılandırma yolları:

• Cursor: ~/.cursor/mcp.json (global) veya .cursor/mcp.json (workspace içinde)
• Cline (VS Code): .cline/mcp.json workspace içinde
• Continue: ~/.continue/config.json (mcpServers bloğu)
• Windsurf: ~/.codeium/windsurf/mcp_config.json

Düzenlemeden sonra istemciyi tamamen yeniden başlat (Cmd+Q → tekrar aç).

Kontrol

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

İstemcide - şunu sor: “List 5 AstroWay tool names from astroway-hosted”. astroway_western_chart, astroway_horoscope_daily, astroway_vedic_panchang_full gibi isimler döndürmeli…

Oran limitleri

Hosted uç noktası 3 katmanlı bir sınırlama ile korunur: Cloudflare DDoS katmanı + edge proxy 120 req/min/IP + bellek içi bucket 60/60s/(IP+key). Gerçek MCP istemcileri (Claude Desktop, Cursor) bu limitlere yaklaşmaz - burst istek yapmazlar. Otomasyonun / CI’n 120 req/min’den fazla ihtiyaç duyuyorsa stdio modunu kullan (orada limit yok, doğrudan api.astroway.info/v1/* üzerinden senin tarifeli rate-limit’inle gider).

mcp.astroway.info geçici olarak erişilemezse

Eğer hosted uç noktası 5xx döndürürse, MCP istemcisi tools/list sırasında hatayı görür. Bu stdio istemcilerini etkilemez - onlar yerel npm paketini çalıştırır ve api.astroway.info/v1/*’a doğrudan, ara hosted katmanı olmadan gider.

Kritik entegrasyonlar için yedek: stdio modunda bir ikinci MCP sunucusu ekle - istemci, hosted tools/list’e yanıt vermediğinde otomatik olarak onu kullanır:

{
  "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_..." }
    }
  }
}

Gerçek uptime, hosted uç noktasının status.astroway.info adresinde görülebilir. 5 dakikadan uzun süren olayları 5 iş günü içinde postmortem olarak yayınlarız (per /sla/).

Stdio (npm) - yerel geliştirme için

@astroway/mcp - yerel olarak bir subprocess olarak çalışan npm paketi. Tek bir npm paketi, Claude Desktop, Cursor ve herhangi bir MCP uyumlu istemciyle yerel entegrasyon.

Nasıl çalışır

Araç listesi derleme anında canlı OpenAPI-spec’ten (api.astroway.info/v1/openapi.json) üretilir. Paketin her sürümü otomatik olarak tüm yeni uç noktaları yakalar - manuel bir şey tutmana gerek yok.

• tools/list açıklama ve giriş şemasını (istek gövdesi örneğiyle) döndürür
• tools/call https://api.astroway.info/v1/<path> adresine ASTROWAY_API_KEY ile HTTP POST yapar
• Yanıt, ajanına yapılandırılmış JSON olarak döner

Her sürüm ayrıca SLSA provenance (Sigstore-attested) ile gönderilir - bu, npm paketinin halka açık repodaki commit’ten derlendiğinin garantisidir.

Kurulum

Claude Desktop (macOS)

~/Library/Application Support/Claude/claude_desktop_config.json dosyasına ekle:

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

Claude Desktop’ı yeniden başlat. Sohbetin altındaki çubukta 🛠️ yüklenmiş araç sayısını gösteren bir gösterge belirecek.

Cursor

~/.cursor/mcp.json dosyasına ekle:

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

Cline / Continue / Windsurf / Copilot / VS Code MCP

Aynı npx @astroway/mcp komutu her MCP uyumlu istemcide çalışır. Yapılandırma aynı - sadece dosya yolu değişir:

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

İstemci	Yapılandırma yolu
Cline (VS Code)	workspace kökünde .cline/mcp.json
Continue	~/.continue/config.json (mcpServers altında)
Windsurf	~/.codeium/windsurf/mcp_config.json
GitHub Copilot Chat (VS Code)	preview flag → workspace içinde mcp.json
VS Code MCP extension	~/.vscode/mcp.json

Diğer MCP istemcileri

stdio sunucusu olarak çalıştır:

ASTROWAY_API_KEY=aw_live_... npx @astroway/mcp

İpucu

Anahtar al - api.astroway.info/dashboard/sign-up. Ücretsiz katman - 10 000 kredi/ay, kart gerektirmez.

Privacy - v1.0.0+ ile

Bu MCP sunucusu AstroWay’e hiçbir şey göndermez; sadece senin ona çalıştırmasını verdiğin API çağrılarını gönderir. Hiç telemetri, analytics, opt‑in/opt‑out anahtarı yok - varsayılan olarak sessiz.

Çıktı istekleri, AstroWay backend’in MCP trafiğini doğrudan HTTP’den ayırabilmesi için iki tanımlayıcı başlık taşır:

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

Hiçbiri session ID, makine parmak izi veya kişisel bir şey içermez. Bu standart User-Agent semantiğidir - her CLI aracı benzer bilgi gönderir.

Subset registration - v1.0.0+ ile

Eğer sadece kataloğun bir kısmını kullanıyorsan, LLM bağlam penceresinin kompakt kalması için alt küme kaydet:

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

Yaygın gruplar: western, vedic, tarot, numerology, hd (Human Design), relational (synastry/composite/davison), prognostics (transits/progressions/returns), aspects, horary, geo, chinese, bazi, mayan, iching, runes, geomancy. Tam seti görmek için npx @astroway/mcp --list-tools çalıştır.

ASTROWAY_READONLY=1 LLM’yi içten çağıran üç grubu (ai, horoscope, reports) atlar - kredi harcamadan sadece saf belirlenmiş kart matematiği istediğinde faydalı.

Stability commitment - v1.0.0+ ile

• Katalog oturum süresince dondurulmuştur. 780+ araç, 12 prompt, 14 kaynak, derleme anında yayınlanan npm paketine gömülüdür - bağlantı sırasında hiçbir şey değişmez. İstemcin tools/list’i ilk çağrıdan sonra önbelleğe alırsa, tüm oturum boyunca geçerli kalır.
• Araç tanımlayıcıları major sürüm içinde sabittir. astroway_<group>_<tool> altındaki isim, v1.x içinde bir deprecation notu CHANGELOG.md’de ve aynı minor paralel erişilebilirlik olmadan yeniden adlandırılmaz veya silinmez.
• Araç giriş şekli minor sürüm içinde sabittir. Sıkılaştırmalar (regex, range, enum) patch’lerde gelir; zorunlu bir alan eklemek minor bump gerektirir.
• Katalogu yenile: yeniden kurarak. npm i -g @astroway/mcp@latest (ya da npx -y @astroway/mcp senin konfigürasyonunda) bir sonraki başlangıçta güncel seti çeker.

Prompt örnekleri

Sunucuya bağlandıktan sonra AI’ye sor:

Doğum haritası

Doğum haritamı hesapla - 15 Mart 1990, 14:30, Kiev doğumlu. Güneş, Ay, Yükselen’i tanımla ve yakın açıları bul.

Transitler

2027 yılı boyunca doğum haritamda yavaş gezegenlerin hangi önemli transitleri olacak?

Vedic Mahadasha

Mumbai’de 22.07.1985 06:45 doğumlu bir kişi için Vimshottari Mahadasha’yı çalıştır. Bu kişi şu anda hangi dönemde?

Synastry

İki haritayı karşılaştır: A - 10.06.1988 09:15 Londra, B - 22.11.1991 22:40 Berlin. En güçlü çapraz açılar hangileri?

Tarot

Rider-Waite-Smith’ten 3 kart çek: Geçmiş - Şimdiki - Gelecek. Soru: “Yeni bir işi kabul etmeli miyim?”. Seed = 42.

Tüm araçların listesi

Bağlandıktan sonra Claude’a sor:

“Tüm astroway araçlarını listele.”

Veya komut satırından:

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)

Yapılandırma

Değişken	Varsayılan	Açıklama	Sürümden
ASTROWAY_API_KEY	(gerekli)	Live: aw_live_.... Sandbox: aw_test_....	0.1.0
ASTROWAY_BASE_URL	https://api.astroway.info/v1	Self‑hosted/staging ortamları için geçersiz kılma.	0.1.0
ASTROWAY_TOOL_GROUPS	(tüm gruplar)	Katalogu sınırlamak için virgülle ayrılmış önekler (western,vedic,relational).	1.0.0
ASTROWAY_READONLY	0	1 LLM‑destekli grupları atlar (ai, horoscope, reports).	1.0.0
LOG_LEVEL	error	silent/error/warn/info/debug - stderr üzerindeki log seviyesi.	0.8.0
LOG_FILE	(yazılmaz)	Logları çoğaltmak için dosya yolu.	0.8.0
MCP_FLAT_TOOLS	0	1 pre‑v0.9 düz isimleri döndürür (chart yerine astroway_western_chart). Legacy.	0.9.0

Neden MCP, doğrudan entegrasyon değil

Genel bir LLM (grounding olmadan) “Temmuz’da Satürn, Jüpiterine üçgen oluşturacak” gibi bir şey söyleyecek - kesin tarih olmadan, ±15 gün sapma ile. MCP-ajan tool_use POST /v1/transits yapar ve gerçek Swiss Ephemeris’ten saniyeye kadar UTC zaman damgası döndürür.

Avantaj LLM’de değil, matematiğin gerçek olduğunun garantisinde - uydurma değil.

Paket dağıtımı

• mcp.so listing: mcp.so/server/astroway-mcp/astroway
• mcpservers.org: onay bekliyor (Mayıs 2026 itibarıyla)
• awesome-mcp-servers (punkpeye): PR #5972

Bağlantılar

• 📦 npm: npmjs.com/package/@astroway/mcp
• 📘 API belgeleri: /docs/api/
• 🔑 Kayıt: /dashboard/sign-up
• 💰 Fiyatlandırma: /pricing/
• 🌐 Genel repo (MIT): github.com/astroway/astroway-mcp