Claude Desktop

Verbinden Sie die AstroWay-API mit Claude Desktop über MCP: als Ein-Klick-Erweiterung oder manuell über die Konfiguration, mit einem gehosteten Server (HTTP) oder einem lokalen stdio-Paket.

Voraussetzungen

Besorgen Sie sich einen API-Schlüssel im Dashboard. Für kostenloses Testen verwenden Sie den Sandbox-Schlüssel aw_test_* - dieser belastet keine Credits.

Ein-Klick-Erweiterung

1. Laden Sie astroway.mcpb herunter.
2. Öffnen Sie die Datei. Claude Desktop zeigt einen Installationsdialog an.
3. Fügen Sie den API-Schlüssel ein, wählen Sie Tool-Gruppen (standardmäßig Geburtstagskarten, Transite, Progressionen, Rückläufe, Synastrie und Kalender) und aktivieren Sie die Erweiterung.

Die Konfiguration muss nicht bearbeitet werden. Die Erweiterung ist das npm-Paket @astroway/mcp mit seinen Abhängigkeiten, das aus dem gleichen Release kompiliert wurde. Leeren Sie das Gruppenfeld, um alle 700+ Tools zu laden.

Manuelle Verbindung

Öffnen Sie Settings → Developer → Edit Config - Claude Desktop zeigt den Pfad zur Datei claude_desktop_config.json an. Fügen Sie einen der folgenden Blöcke ein und starten Sie Claude Desktop neu.

Hosted (HTTP): ohne unser Paket, Authentifizierung über Bearer-Token. Die Claude-Desktop-Konfiguration führt nur lokale Befehle aus und überspringt den Eintrag mit dem url selbst, daher wird der gehostete Server über die Brücke mcp-remote verbunden:

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

Der Schlüssel liegt in env, nicht in args, weil Claude Desktop unter Windows das Argument nach dem Leerzeichen nach Bearer trennt. Um ein Thema anstelle des gesamten Katalogs zu laden, ersetzen Sie /mcp durch einen Domänenserver, z.B. /mcp/core oder /mcp/vedic.

Stdio (npx): lokaler Unterprozess, Authentifizierung über Umgebungsvariable, funktioniert offline:

claude_desktop_config.json

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

Überprüfung

Schreiben Sie Claude im Chat: “Liste Astroway-Tools auf” - oder bitten Sie Sie, ein kostenloses Referenz-Tool aufzurufen, z.B. eine Liste der Tierkreiszeichen zu erhalten. Wenn Sie eine Antwort erhalten, funktioniert die Verbindung.

Fehlerbehebung

• 401 / ungültiger Schlüssel: Stellen Sie sicher, dass der Schlüssel das Präfix aw_live_* oder aw_test_* hat und nicht widerrufen wurde. Überprüfen Sie dies im Dashboard.
• “Some MCP servers couldn’t be loaded”: url im Eintrag statt command. Verwenden Sie den Block mit mcp-remote oben.
• Tools erscheinen nicht: Starten Sie Claude Desktop vollständig neu (melden Sie sich ab, nicht nur das Fenster schließen) und überprüfen Sie den Pfad zu claude_desktop_config.json.
• Validierungsfehler -32602 (für stdio): Aktualisieren Sie das Paket: npm i @astroway/mcp@latest. Die Schemata werden mit der aktuellen Spezifikation neu generiert.

Alle Clients - Agent-Einstellungen.