Claude Desktop

Csatlakoztasd az AstroWay API-t a Claude Desktop-hoz MCP-n keresztül: egykattintásos kiegészítővel vagy manuálisan konfiguráción keresztül, hosted szerverrel (HTTP) vagy helyi stdio csomaggal.

Előfeltételek

Szerezd meg az API-kulcsot a dashboardon. Ingyenes teszteléshez használd a sandbox kulcsot aw_test_* – ez nem von le kreditet.

Egykattintásos kiegészítő

1. Töltsd le a astroway.mcpb fájlt.
2. Nyisd meg a fájlt. A Claude Desktop megjeleníti a telepítési párbeszédablakot.
3. Illeszd be az API-kulcsot, válaszd ki az eszközcsoportokat (alapértelmezés szerint születési képletek, tranzitok, progressziók, visszatérések, szinasztria és naptár) és kapcsold be a kiegészítőt.

A konfigurációt nem kell szerkeszteni. A kiegészítő egy npm csomag @astroway/mcp a függőségeivel, ugyanabból a kiadásból építve. Töröld a csoportmezőt, hogy betöltsd az összes 700+ eszközt.

Manuális csatlakozás

Nyisd meg a Settings → Developer → Edit Config menüt – a Claude Desktop megmutatja a claude_desktop_config.json fájl útvonalát. Illeszd be az alábbi blokkok egyikét, és indítsd újra a Claude Desktop-ot.

Hosted (HTTP): a mi csomagunk nélkül, hitelesítés Bearer tokennel. A Claude Desktop konfigurációja csak helyi parancsokat indít, és kihagyja a url bejegyzést, ezért a hosted szerver a mcp-remote hídon keresztül csatlakozik:

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" }
  }
}
}

A kulcs az env-ben van, nem az args-ban, mert a Claude Desktop Windows-on a Bearer után szóközön bontja a argumentumot. Egyetlen témát betölteni a teljes könyvtár helyett, cseréld le a /mcp-t egy domain szerverre, például /mcp/core vagy /mcp/vedic.

Stdio (npx): helyi alfolyamat, hitelesítés env változón keresztül, offline működik:

claude_desktop_config.json

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

Ellenőrzés

Írj a Claude-nak a csevegőben: “Listázd az Astroway eszközöket” – vagy kérj egy ingyenes referencia-eszközt, például a csillagjegyek listáját. Ha válaszként eredményt kapsz, a csatlakozás működik.

Hibaelhárítás

• 401 / invalid key: győződj meg róla, hogy a kulcs aw_live_* vagy aw_test_* előtaggal rendelkezik, és nincs visszavonva. Ellenőrizheted a dashboardon.
• “Some MCP servers couldn’t be loaded”: a url bejegyzésben command helyett. Használd a fenti mcp-remote blokkot.
• Az eszközök nem jelennek meg: indítsd újra teljesen a Claude Desktop-ot (lépj ki, ne csak zárd be az ablakot), és ellenőrizd a claude_desktop_config.json útvonalát.
• Validációs hibák -32602 (stdio esetén): frissítsd a csomagot: npm i @astroway/mcp@latest. A sémák az aktuális specifikációból újragenerálódnak.

Minden kliens - Ügynök beállítása.