VS Code

Verbinde die AstroWay API über MCP mit VS Code. Die Konfiguration wird von Copilot Chat im Agent mode gelesen.

Voraussetzungen

Hol dir einen API-Schlüssel im Dashboard. Zum kostenlosen Testen nimm einen Sandbox-Schlüssel aw_test_*: Er verbraucht keine Credits.

Verbindung

Lege .vscode/mcp.json im Projektstamm an. Achtung: In VS Code heißt der Schlüssel servers (nicht mcpServers), und jeder Server braucht ein Feld type. Füge einen der Blöcke unten ein und starte VS Code neu.

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

.vscode/mcp.json

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

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

.vscode/mcp.json

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

Prüfen

Schreib in Copilot Chat (Agent mode): “Liste die Astroway-Tools auf”, oder bitte darum, ein kostenloses Reference-Tool aufzurufen, zum Beispiel um die Liste der Tierkreiszeichen abzurufen. Kommt ein Ergebnis zurück, funktioniert die Verbindung.

Fehlerbehebung

• 401 / invalid key: Stell sicher, dass der Schlüssel das Präfix aw_live_* oder aw_test_* hat und nicht widerrufen ist. Prüfen kannst du das im Dashboard.
• Tools erscheinen nicht: Starte VS Code vollständig neu und prüfe den Pfad .vscode/mcp.json (Schlüssel servers, Feld type).
• Validierungsfehler -32602 (bei stdio): Aktualisiere das Paket: npm i @astroway/mcp@latest. Die Schemas werden aus der aktuellen Spezifikation neu generiert.

Alle Clients: Agent einrichten.