Windsurf

Podłącz AstroWay API do Windsurf przez MCP. Z serwera korzysta asystent Cascade.

Wymagania wstępne

Wygeneruj klucz API w panelu. Do darmowych testów używaj klucza sandbox aw_test_* - nie pobiera on kredytów.

Podłączenie

Edytuj ~/.codeium/windsurf/mcp_config.json; plik jest też dostępny przez Settings → Cascade → MCP. Uwaga: dla zdalnego serwera Windsurf używa klucza serverUrl (nie url). Wklej jeden z poniższych bloków i uruchom ponownie Windsurf.

Hosted (HTTP): bez instalacji, uwierzytelnianie tokenem Bearer:

~/.codeium/windsurf/mcp_config.json

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

Stdio (npx): lokalny podproces, uwierzytelnianie przez zmienną środowiskową, działa offline:

~/.codeium/windsurf/mcp_config.json

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

Weryfikacja

W Cascade napisz: “Wypisz narzędzia Astroway” - albo poproś o wywołanie darmowego narzędzia referencyjnego, na przykład pobranie listy znaków zodiaku. Jeśli w odpowiedzi pojawi się wynik, połączenie działa.

Rozwiązywanie problemów

• 401 / invalid key: upewnij się, że klucz ma prefiks aw_live_* lub aw_test_* i nie został unieważniony. Możesz to sprawdzić w panelu.
• Narzędzia się nie pojawiają: całkowicie uruchom ponownie Windsurf i sprawdź ścieżkę ~/.codeium/windsurf/mcp_config.json (dla hosted - klucz serverUrl).
• Błędy walidacji -32602 (dla stdio): zaktualizuj pakiet: npm i @astroway/mcp@latest. Schematy są generowane na nowo z aktualnej specyfikacji.

Wszystkie klienty - Konfiguracja agenta.