Windsurf

Dostęp do API AstroWay w Windsurf za pomocą MCP. Serwer używa asystenta Cascade.

Warunki

Pobierz klucz API na pulpitze. W celu bezpłatnego testowania użyj klucza sandbox aw_test_* - nie będzie on pobierał kredytów.

Połączenie

Edytuj ~/.codeium/windsurf/mcp_config.json; dostępne również przez Settings → Cascade → MCP. Uwaga: dla serwera zdalnego Windsurf używa klucza serverUrl (nie url). Wstaw jeden z bloków poniżej i ponownie uruchom Windsurf.

Hosted (HTTP): bez instalacji, autoryzacja za pomocą tokenu 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, autoryzacja za pomocą zmiennej środowiskowej, 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: «Perelicz instrumenty Astroway» - lub poproś o wywołanie bezpłatnego narzędzia odwołującego się, np. uzyskaj listę znaków zodiaku. Jeśli w odpowiedzi przychodzi wynik, połączenie działa.

Usuwanie problemów

• 401 / niepoprawny klucz: upewnij się, że klucz ma prefiks aw_live_* lub aw_test_* i nie został odwołany. Sprawdź to w pulpitze.
• Narzędzia nie pojawiają się: całkowicie ponownie uruchom Windsurf i sprawdź ścieżkę ~/.codeium/windsurf/mcp_config.json (dla hosted - klucz serverUrl).
• Błędy weryfikacji -32602 (dla stdio): zaktualizuj pakiet: npm i @astroway/mcp@latest. Schematy są ponownie generowane z aktualnej specyfikacji.

Wszystkie klienci - Nalążtuje agenta.