Claude Desktop

Podłącz API AstroWay do Claude Desktop przez MCP: rozszerzeniem jednym kliknięciem lub ręcznie przez konfigurację, z hosted-serwerem (HTTP) lub lokalnym stdio-pakietem.

Wymagania wstępne

Uzyskaj klucz API w dashboardzie. Do bezpłatnego testowania użyj klucza sandbox aw_test_* – nie pobiera kredytów.

Rozszerzenie jednym kliknięciem

1. Pobierz astroway.mcpb.
2. Otwórz plik. Claude Desktop pokaże dialog instalacji.
3. Wklej klucz API, wybierz grupy narzędzi (domyślnie mapy natalne, tranzyty, progresje, powroty, synastria i kalendarz) i włącz rozszerzenie.

Konfiguracji nie trzeba edytować. Rozszerzenie to npm-pakiet @astroway/mcp z jego zależnościami, zbudowany z tego samego wydania. Wyczyść pole grup, aby załadować wszystkie 700+ narzędzi.

Ręczne podłączenie

Otwórz Settings → Developer → Edit Config – Claude Desktop pokaże ścieżkę do pliku claude_desktop_config.json. Wklej jeden z bloków poniżej i zrestartuj Claude Desktop.

Hosted (HTTP): bez naszego pakietu, uwierzytelnianie przez token Bearer. Konfiguracja Claude Desktop uruchamia tylko lokalne komendy i pomija zapis z samym url, dlatego hosted-serwer łączy się przez most mcp-remote:

claude_desktop_config.json

{
"mcpServers": {
  "astroway": {
    "command": "npx",
    "args": ["-y", "mcp-remote", "https://mcp.astroway.info/mcp", "--header", "Authorization:${AUTH_HEADER}"],
    "env": { "AUTH_HEADER": "Bearer aw_live_YOUR_KEY" }
  }
}
}

Klucz znajduje się w env, a nie w args, ponieważ Claude Desktop na Windows rozdziela argument po spacji po Bearer. Aby załadować jedną temat zamiast całego katalogu, zamień /mcp na serwer domenowy, np. /mcp/core lub /mcp/vedic.

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

claude_desktop_config.json

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

Sprawdzenie

Napisz do Claude w czacie: “Wymień narzędzia Astroway” – lub poproś o wywołanie darmowego narzędzia referencyjnego, np. pobranie listy znaków zodiaku. Jeśli odpowiedź zawiera 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ł odwołany. Możesz to sprawdzić w dashboardzie.
• “Some MCP servers couldn’t be loaded”: w zapisie url zamiast command. Użyj bloku z mcp-remote powyżej.
• Narzędzia nie pojawiają się: całkowicie zrestartuj Claude Desktop (wyloguj się, a nie tylko zamknij okno) i sprawdź ścieżkę do claude_desktop_config.json.
• Błędy walidacji -32602 (dla stdio): zaktualizuj pakiet: npm i @astroway/mcp@latest. Schematy są regenerowane z aktualnej specyfikacji.

Wszyscy klienci - Ustawienia agenta.