Claude Desktop

Verbinden Sie die AstroWay-API mit Claude Desktop über MCP. Beide Transportmethoden sind verfügbar: gehostet (HTTP) und das lokale stdio-Paket.

Voraussetzungen

Holen Sie sich einen API-Schlüssel im Dashboard. Für kostenlose Tests verwenden Sie den Sandbox-Schlüssel aw_test_* - dieser belastet keine Credits.

Verbindung

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

Hosted (HTTP): ohne Installation, Authentifizierung über Bearer-Token:

claude_desktop_config.json

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

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 an Claude im Chat: «Liste die AstroWay-Tools auf» - oder bitten Sie Sie, ein kostenloses Reference-Tool aufzurufen, zum Beispiel das Abrufen einer Liste der Tierkreiszeichen. Wenn Sie eine Antwort erhalten, funktioniert die Verbindung.

Fehlerbehebung

• 401 / invalid key: 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.
• Tools werden nicht angezeigt: Starten Sie Claude Desktop vollständig neu (beenden Sie die Anwendung, nicht nur das Fenster) 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 aus der aktuellen Spezifikation neu generiert.

Alle Clients - Agenteneinstellungen.