Claude Desktop

Připojte API AstroWay k Claude Desktop přes MCP: rozšířením v jednom kliknutí nebo ručně přes konfiguraci, s hostovaným serverem (HTTP) nebo lokálním stdio balíčkem.

Předpoklady

Získejte API klíč v dashboardu. Pro bezplatné testování použijte sandbox klíč aw_test_* - neodečítá kredity.

Rozšíření v jednom kliknutí

1. Stáhněte astroway.mcpb.
2. Otevřete soubor. Claude Desktop zobrazí instalační dialog.
3. Vložte API klíč, vyberte skupiny nástrojů (ve výchozím nastavení natační mapy, transity, progresie, návraty, synastrie a kalendář) a zapněte rozšíření.

Konfiguraci není třeba upravovat. Rozšíření je npm balíček @astroway/mcp s jeho závislostmi, sestavený ze stejného vydání. Vyčistěte pole skupin, abyste nahráli všech 700+ nástrojů.

Ruční připojení

Otevřete Nastavení → Vývojář → Upravit konfiguraci - Claude Desktop zobrazí cestu k souboru claude_desktop_config.json. Vložte jeden z bloků níže a restartujte Claude Desktop.

Hostované (HTTP): bez našeho balíčku, autentizace přes Bearer token. Konfigurace Claude Desktop spouští pouze lokální příkazy a přeskočí záznam s samotným url, proto hostovaný server připojuje přes 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" }
  }
}
}

Klíč leží v env, ne v args, protože Claude Desktop na Windows rozdělí argument na mezery po Bearer. Abychom nahráli jednu téma místo celého katalogu, nahraďte /mcp doménový server, například /mcp/core nebo /mcp/vedic.

Stdio (npx): lokální podproces, autentizace přes env proměnnou, funguje offline:

claude_desktop_config.json

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

Ověření

Napište Claude do chatu: “Vypište nástroje Astroway” - nebo požádejte o zavolání bezplatného reference nástroje, například o získání seznamu zvěrokruhu. Pokud přijde odpověď, připojení funguje.

Řešení problémů

• 401 / neplatný klíč: ujistěte se, že klíč má prefix aw_live_* nebo aw_test_* a není odvolán. Zkontrolovat můžete v dashboardu.
• “Some MCP servers couldn’t be loaded”: v záznamu url místo command. Použijte blok s mcp-remote výše.
• Nástroje se neobjevují: úplně restartujte Claude Desktop (odhlaste se, nejen zavřete okno) a zkontrolujte cestu k claude_desktop_config.json.
• Chyby validace -32602 (pro stdio): aktualizujte balíček: npm i @astroway/mcp@latest. Schémata jsou regenerována z aktuální specifikace.

Všichni klienti - Nastavení agenta.