MCP Sunucusu: AstroAPI'yi Yapay Zeka Asistanlarından Kullanın

AstroAPI, barındırılan bir Model Context Protocol (MCP) sunucusu sunar. Bunu Claude Code, Claude Desktop veya Cursor gibi bir yapay zeka asistanına bağlayın; asistan AstroAPI'yi doğrudan çağırabilir — doğum yerlerini arayabilir, haritalar hesaplayabilir ve sonuçları sade bir dille açıklayabilir.

Bu aynı zamanda bir entegrasyon geliştirmenin en hızlı yoludur: MCP sunucusunu yapay zeka kodlama asistanınıza bağlayın ve entegrasyon kodunu sizin için yazmasını isteyin. Asistan çalışırken gerçek API çağrıları yapabilir, böylece tahmin etmek yerine gerçek yanıtları görür.

Kod gerekmez

Bağlantı kurulduktan sonra asistanınıza sadece şöyle sorular sorabilirsiniz: "15 Haziran 1990'da saat 14:30'da Amsterdam'da doğan biri için doğum haritasını hesapla" — asistan konumu çözümler, API'yi çağırır ve sonucu özetler.

---

Endpoint

https://mcp.astroapi.cloud/mcp

• Aktarım: Streamable HTTP
• Kimlik doğrulama: normal AstroAPI anahtarınız, X-Api-Key başlığıyla gönderilir
• Aboneliğinizin modülleri, hız limitleri ve kotaları, doğrudan API çağrılarında olduğu gibi aynen geçerlidir.

Dashboard üzerinde API Keys bölümünden bir API anahtarı oluşturabilirsiniz. Ayrıntılar için Kimlik Doğrulama sayfasına bakın.

---

Claude Code'u Bağlama

Terminalinizde bunu bir kez çalıştırın:

claude mcp add --transport http astroapi https://mcp.astroapi.cloud/mcp \
  --header "X-Api-Key: YOUR_API_KEY"

Ardından Claude Code'dan AstroAPI'yi kullanmasını isteyin — örneğin: "astroapi araçlarını kullanarak 1990-06-15 14:30 Amsterdam için bir doğum haritası hesapla ve bunu görüntüleyen bir React bileşeni oluştur."

Cursor'ı Bağlama

Bunu projenizdeki .cursor/mcp.json dosyasına (veya global olarak ~/.cursor/mcp.json dosyasına) ekleyin:

{
  "mcpServers": {
    "astroapi": {
      "url": "https://mcp.astroapi.cloud/mcp",
      "headers": {
        "X-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

Diğer MCP istemcilerini bağlama

Özel başlıklarla Streamable HTTP üzerinden MCP'yi destekleyen her istemci çalışır. Şunları yapılandırın:

Ayar	Değer
URL	https://mcp.astroapi.cloud/mcp
Aktarım	Streamable HTTP
Başlık	X-Api-Key: YOUR_API_KEY

Özel başlık desteği olmayan barındırılan istemciler

Bazı barındırılan istemciler (claude.ai web bağlayıcıları gibi) özel başlık gönderemez ve OAuth gerektirir. OAuth desteği yol haritasında yer alıyor; şimdilik Claude Code, Claude Desktop veya Cursor gibi özel başlıkları destekleyen bir istemci kullanın.

---

Kullanılabilir Araçlar

Araç	Ne yapar
astro_resolve_place	Bir yer adını arar ve koordinatlar ile IANA saat dilimini döndürür. Asistanlara önce bu aracı çağırmaları talimatı verilir, böylece koordinatları asla tahmin etmezler.
astro_natal_chart	Bir doğum haritası hesaplar (noktalar, evler, açılar), isteğe bağlı olarak yorum metinleriyle birlikte, ve kompakt, okunabilir bir özet döndürür.

Daha fazla araç (transitler, sinastri, uyumluluk, ay evreleri, harita görselleri ve diğerleri) yolda. Araçların kullanılabilirliği aboneliğinizin modüllerine bağlıdır: planınızın içermediği bir araç, veri yerine açık bir mesaj döndürür.

---

Örnek Oturum

Bağlı bir asistanla yapılan bir konuşma şöyle görünebilir:

Siz: 3 Mart 1985'te saat 6:45'te Barselona'da doğan birinin güneş burcu ve yükseleni nedir?

Asistan: "Barcelona" ile astro_resolve_place aracını, ardından çözümlenen koordinatlar ve saat dilimiyle astro_natal_chart aracını çağırır — Güneş, 1. evde Balık burcunda 12°41′ konumunda ve Yükselen Kova 28°10′ …

Asistan; coğrafi kodlamayı, saat dilimi dönüşümünü ve API çağrısını halleder — doğum verilerini elle girerken genellikle ters giden şeyleri.

---

Sonraki Adımlar

• Kimlik Doğrulama — API anahtarları oluşturma ve yönetme
• Başlarken — bu araçların arkasındaki API temelleri
• Doğum Haritaları — doğum haritası hesaplamasının döndürdükleri