Windsurf

Verbinde die AstroWay API mit Windsurf über MCP. Der Server verwendet den Cascade-Assistenten.

Voraussetzungen

Hole dir einen API-Schlüssel im Dashboard. Für kostenloses Testen verwende den Sandbox-Schlüssel aw_test_* – er verbraucht keine Credits.

Verbindung

Bearbeite ~/.codeium/windsurf/mcp_config.json; auch verfügbar über Settings → Cascade → MCP. Beachte: Für einen Remote-Server verwendet Windsurf den Schlüssel serverUrl (nicht url). Füge einen der folgenden Blöcke ein und starte Windsurf neu.

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

~/.codeium/windsurf/mcp_config.json

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

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

~/.codeium/windsurf/mcp_config.json

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

Überprüfung

Schreibe in Cascade: „Liste die Astroway-Tools auf“ – oder bitte darum, ein kostenloses Referenz-Tool aufzurufen, zum Beispiel die Liste der Sternzeichen abzurufen. 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. Du kannst dies im Dashboard überprüfen.
• Tools erscheinen nicht: Starte Windsurf vollständig neu und überprüfe den Pfad ~/.codeium/windsurf/mcp_config.json (für Hosted – den Schlüssel serverUrl).
• Validierungsfehler -32602 (für Stdio): Aktualisiere das Paket: npm i @astroway/mcp@latest. Die Schemas werden aus der aktuellen Spezifikation neu generiert.

Alle Clients – Agenten-Setup.