Claude Desktop

Csatlakoztassa az AstroWay API-t a Claude Desktop-hoz MCP-n keresztül. Mindkét transzport elérhető: hosted (HTTP) és helyi stdio csomag.

Előfeltételek

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

Kapcsolódás

Nyisd meg a Settings → Developer → Edit Config menüpontot - a Claude Desktop megmutatja a fájl elérési útját: claude_desktop_config.json. Illeszd be az alábbi blokkok egyikét, és indítsd újra a Claude Desktopot.

Hosted (HTTP): csomagunk nélkül, hitelesítés Bearer-token-nel. A Claude Desktop konfigurációja csak helyi parancsokat futtat, és kihagyja a url-t tartalmazó bejegyzést, ezért a hosted szerver a mcp-remote hídhoz 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 Windowson szóköz után széttöri az argumentumot a Bearer után. Ha egy témát szeretnél betölteni az egész katalógus helyett, cseréld le a /mcp-t a doménszerverre, például /mcp/core vagy /mcp/vedic.

Stdio (npx): helyi alprocessz, hitelesítés env változóval, 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 chatben: “Listázd az Astroway eszközöket” - vagy kérj egy ingyenes reference eszköz meghívását, például a csillagjegyek listájának lekérését. Ha válaszként eredményt kapsz, a kapcsolat 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 nem lett visszavonva. Ellenőrizheted a dashboardon.
• “Some MCP servers couldn’t be loaded”: a bejegyzésben url van command helyett. Használd a fenti mcp-remote blokkot.
• Az eszközök nem jelennek meg: teljesen indítsd újra a Claude Desktopot (lépj ki, ne csak zárd be az ablakot) és ellenőrizd a claude_desktop_config.json elérési útját.
• -32602 validációs hibák (stdio-hoz): frissítsd a csomagot: npm i @astroway/mcp@latest. A sémák újragenerálódnak az aktuális specifikációból.

Összes ügyfél - Ügynök beállítások.