Cursor

Verbinde das AstroWay API mit Cursor über MCP. Beide Transportarten sind verfügbar: gehostet (HTTP) und lokales stdio-Paket.

Voraussetzungen

Erhalte einen API-Schlüssel im Dashboard. Für kostenloses Testen verwende den Sandbox-Schlüssel aw_test_* - dieser belastet keine Credits.

Verbindung

Editiere ~/.cursor/mcp.json (oder das projektbezogene .cursor/mcp.json); auch verfügbar unter Settings → MCP. Füge einen der folgenden Blöcke ein und starte Cursor neu.

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

~/.cursor/mcp.json

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

Stdio (npx): lokaler Unterprozess, Authentifizierung über env-Variable, funktioniert offline:

~/.cursor/mcp.json

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

Überprüfung

Schreibe an den Agenten im Chat: “Liste die Astroway-Tools auf” - oder bitte um den Aufruf eines kostenlosen reference-Tools, z.B. das Abrufen einer Liste der Tierkreiszeichen. Wenn eine Antwort zurückkommt, funktioniert die Verbindung.

Fehlerbehebung

• 401 / invalid key: Stelle sicher, dass der Schlüssel das Präfix aw_live_* oder aw_test_* hat und nicht widerrufen wurde. Überprüfen kann man es im Dashboard.
• Tools erscheinen nicht: Starte Cursor vollständig neu und überprüfe den Pfad zu ~/.cursor/mcp.json (für projektbezogene - .cursor/mcp.json).
• Validierungsfehler -32602 (für stdio): Aktualisiere das Paket: npm i @astroway/mcp@latest. Die Schemata werden mit der aktuellen Spezifikation regeneriert.

Alle Clients - Agenteneinstellungen.