MCP Server: AstroAPI aus KI-Assistenten nutzen

AstroAPI stellt einen gehosteten Model Context Protocol-(MCP-)Server bereit. Verbinden Sie ihn mit einem KI-Assistenten wie Claude Code, Claude Desktop oder Cursor, und der Assistent kann AstroAPI direkt aufrufen — Geburtsorte nachschlagen, Horoskope berechnen und die Ergebnisse in verständlicher Sprache erklären.

Dies ist auch der schnellste Weg, eine Integration zu bauen: Verbinden Sie den MCP-Server mit Ihrem KI-Coding-Assistenten und bitten Sie ihn, den Integrationscode für Sie zu schreiben. Der Assistent kann während der Arbeit echte API-Aufrufe ausführen und sieht so tatsächliche Antworten, statt raten zu müssen.

Kein Code erforderlich

Sobald die Verbindung steht, können Sie Ihren Assistenten einfach Dinge fragen wie "Berechne das Geburtshoroskop für eine Person, die am 15. Juni 1990 um 14:30 Uhr in Amsterdam geboren wurde" — der Assistent ermittelt den Ort, ruft die API auf und fasst das Ergebnis zusammen.

---

Endpoint

https://mcp.astroapi.cloud/mcp

• Transport: Streamable HTTP
• Authentifizierung: Ihr regulärer AstroAPI-Schlüssel, gesendet als X-Api-Key-Header
• Die Module, Rate Limits und Kontingente Ihres Abonnements gelten genauso wie bei direkten API-Aufrufen.

Sie können einen API-Schlüssel im Dashboard unter API Keys erstellen. Details finden Sie unter Authentifizierung.

---

Claude Code verbinden

Führen Sie dies einmalig in Ihrem Terminal aus:

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

Bitten Sie Claude Code anschließend einfach, AstroAPI zu verwenden — zum Beispiel: "Verwende die astroapi-Tools, um ein Geburtshoroskop für den 15.06.1990 um 14:30 Uhr in Amsterdam zu berechnen, und baue mir eine React-Komponente, die es anzeigt."

Cursor verbinden

Fügen Sie dies zu .cursor/mcp.json in Ihrem Projekt hinzu (oder global zu ~/.cursor/mcp.json):

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

Andere MCP-Clients verbinden

Jeder Client, der MCP über Streamable HTTP mit benutzerdefinierten Headern unterstützt, funktioniert. Konfigurieren Sie:

Einstellung	Wert
URL	https://mcp.astroapi.cloud/mcp
Transport	Streamable HTTP
Header	X-Api-Key: YOUR_API_KEY

Gehostete Clients ohne benutzerdefinierte Header

Einige gehostete Clients (etwa claude.ai-Web-Connectoren) können keine benutzerdefinierten Header senden und erfordern OAuth. OAuth-Unterstützung steht auf der Roadmap; verwenden Sie vorerst einen Client, der benutzerdefinierte Header unterstützt, wie Claude Code, Claude Desktop oder Cursor.

---

Verfügbare Tools

Tool	Funktion
astro_resolve_place	Schlägt einen Ortsnamen nach und liefert Koordinaten sowie die IANA-Zeitzone zurück. Assistenten werden angewiesen, dieses Tool zuerst aufzurufen, damit sie niemals Koordinaten raten.
astro_natal_chart	Berechnet ein Geburtshoroskop (Punkte, Häuser, Aspekte), optional mit Deutungstexten, und liefert eine kompakte, lesbare Zusammenfassung zurück.

Weitere Tools (Transite, Synastrie, Kompatibilität, Mondphasen, Horoskopgrafiken und mehr) sind in Arbeit. Die Verfügbarkeit der Tools richtet sich nach den Modulen Ihres Abonnements: Ein Tool, das Ihr Plan nicht enthält, liefert eine klare Meldung statt Daten zurück.

---

Beispielsitzung

Ein Gespräch mit einem verbundenen Assistenten könnte so aussehen:

Sie: Was sind Sonnenzeichen und Aszendent einer Person, die am 3. März 1985 um 6:45 Uhr in Barcelona geboren wurde?

Assistent: ruft astro_resolve_place mit "Barcelona" auf, dann astro_natal_chart mit den ermittelten Koordinaten und der Zeitzone — Die Sonne steht in den Fischen auf 12°41′ im 1. Haus, und der Aszendent ist Wassermann 28°10′ …

Der Assistent übernimmt Geokodierung, Zeitzonenumrechnung und den API-Aufruf — genau die Dinge, die bei der manuellen Eingabe von Geburtsdaten üblicherweise schiefgehen.

---

Nächste Schritte

• Authentifizierung — API-Schlüssel erstellen und verwalten
• Erste Schritte — die API-Grundlagen hinter diesen Tools
• Geburtshoroskope — was die Geburtsberechnung zurückliefert