MCP – kapcsolódás Claude / Cursor

Model Context Protocol szerver AstroWay kiteszi az összes 771 végpontot eszközként az AI-ügynök számára. Két mód – mindkettő natívan támogatott minden MCP-kompatibilis kliens által.

Mód	URL / parancs	Mikor választani
Hosted HTTP	https://mcp.astroway.info/mcp	Claude Web (claude.ai a böngészőben), Claude Desktop / Cursor / Code újoncok npm nélkül, vagy ha zero-install szeretnél
Stdio (npm)	npx @astroway/mcp	Cursor haladó felhasználók, helyi fejlesztés, adatvédelmi tudatos (a kulcs soha nem hagyja el a gépedet), offline-kész

A hosted végpont és az npm csomag ugyanazt az eszközkatalógust használják (egy /v1/openapi.json-ból generálva). Auth: ugyanaz a aw_test_* / aw_live_* API-kulcs – a hosted esetén Authorization: Bearer … headerrel küldik, a stdio esetén – ASTROWAY_API_KEY környezeti változóval.

Forrás: github.com/astroway/astroway-mcp · npm: npmjs.com/package/@astroway/mcp · hosted: mcp.astroway.info/health

Hosted (mcp.astroway.info) – zero telepítés

Gyors kezdés npm nélkül – válaszd ki a kliensed. Telepítés előtt szerezd meg a kulcsot a api.astroway.info/dashboard/sign-up oldalon (10 000 kredit/hó ingyen).

Cursor (one-click)

Kattints a gombra – a Cursor megnyílik, megerősítést kér, és automatikusan hozzáad egy bejegyzést:

Install in Cursor →

Kötelező 2. lépés – különben nem működik

A Cursor nem tudja beilleszteni a titkot a deeplinkből – a ~/.cursor/mcp.json fájlba a Bearer YOUR_API_KEY literál kerül, amire a szerver 403 invalid_format választ ad.

A gomb megnyomása után:

1. Cursor Settings (⚙️ jobb felső sarok) → Tools & MCP → keresd meg az astroway-hosted elemet a listában.
2. Kattints a három pontra (⋯) a szerver mellett → Edit configuration.
3. A Authorization mezőben cseréld le a Bearer YOUR_API_KEY-t Bearer aw_test_…-ra (vagy aw_live_…)-ra – a saját valós kulcsod a Dashboard-ról.
4. Mentsd → nyisd újra az MCP listát → győződj meg róla, hogy a státusz enabled, zöld pont, és a 780+ tools enabled számláló látható.

Alternatívaként – szerkeszd közvetlenül a fájlt: ~/.cursor/mcp.json (headers.Authorization).

Megjegyzés

A Cursor korlátozza a nevek hosszát: server_name:tool_name ≤ 60 karakter. Körülbelül 90 a 780+ eszköz közül (főleg a hellenistic_*, psychological_*, zi_wei_*, zodiac_* és numerology_* csoportok) szűrve lesz a Cursor által és nem lesz elérhető az LLM-en keresztül. A többi ~690 működik. A Claude Desktopban nincs ilyen limit – teljes katalógus.

Claude Desktop

Settings → Developer → Edit Config megnyitja a claude_desktop_config.json fájlt. Ez a fájl csak helyi parancsokat indít: a url bejegyzés átugrásra kerül a “Some MCP servers couldn’t be loaded” üzenettel. A hosted szerver a mcp-remote hídon keresztül csatlakozik, ehhez Node.js szükséges:

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

Zárd be teljesen a Claude Desktopot (Cmd+Q), majd indítsd újra. A kulcs az env-ben van, mert a Claude Desktop Windowson a Bearer után szóközön bontja a argumentumot.

Az Add custom connector párbeszédablak a Settings → Connectors menüben csak nevet és URL-t fogad, nincs benne Authorization fejléc mező, így az AstroWay kulcsot így nem lehet átadni.

JSON config (manual)

Cursor, Cline, Continue és Windsurf számára, amelyek közvetlenül fogadják a távoli url-t:

{
  "mcpServers": {
    "astroway-hosted": {
      "url": "https://mcp.astroway.info/mcp",
      "headers": {
        "Authorization": "Bearer aw_live_..."
      }
    }
  }
}

Konfigurációs útvonalak:

• Cursor: ~/.cursor/mcp.json (globálisan) vagy .cursor/mcp.json (a workspace-ben)
• Cline (VS Code): .cline/mcp.json a workspace-ben
• Continue: ~/.continue/config.json (mcpServers blokk)
• Windsurf: ~/.codeium/windsurf/mcp_config.json

A módosítás után indítsd újra teljesen a klienst (Cmd+Q → újraindítás).

Ellenőrzés

curl https://mcp.astroway.info/health
# {"status":"ok","version":"…","uptime_sec":…,"mcp_protocol_version":"…"}

A kliensben kérd: “List 5 AstroWay tool names from astroway-hosted”. Ennek vissza kell adnia olyan neveket, mint astroway_western_chart, astroway_horoscope_daily, astroway_vedic_panchang_full, …

Kéréskorlátok

A hosted végpont 3 szintű korlátozással védett: Cloudflare DDoS réteg + edge proxy 120 req/min/IP + memória-alapú bucket 60/60s/(IP+key). A valós MCP-kliensek (Claude Desktop, Cursor) nem közelítik meg ezeket a határokat – nem végeznek burst kéréseket. Ha az automatizációd / CI > 120 req/min igényel, használd a stdio módot (itt nincsenek korlátok, közvetlenül a api.astroway.info/v1/*-ra küld a saját tarifád rate-limitjével).

Mi van, ha a mcp.astroway.info ideiglenesen nem elérhető

Ha a hosted végpont 5xx-et ad vissza, az MCP-kliens hibát lát a tools/list hívásnál. Ez nem érinti a stdio-klienseket – ők egy helyi npm csomagot indítanak, amely közvetlenül a api.astroway.info/v1/*-ra kérdez, a köztes hosted réteg nélkül.

Fallback kritikus integrációkhoz: adj hozzá második MCP-szervert a stdio-móddal ellátott konfigurációhoz – a kliens automatikusan ezt használja, ha a hosted nem válaszol a tools/list-re:

{
  "mcpServers": {
    "astroway": {
      "url": "https://mcp.astroway.info/mcp",
      "headers": { "Authorization": "Bearer aw_live_..." }
    },
    "astroway-fallback": {
      "command": "npx",
      "args": ["-y", "@astroway/mcp"],
      "env": { "ASTROWAY_API_KEY": "aw_live_..." }
    }
  }
}

A hosted végpont valós uptime-ja látható a status.astroway.info oldalon. 5 percnél hosszabb incidenseket postmortemként publikálunk 5 munkanapon belül (per /sla/).

Stdio (npm) – helyi fejlesztéshez

@astroway/mcp – npm csomag, amely helyben subprocessként fut. Egy npm csomag, natív integráció Claude Desktop, Cursor és bármely MCP-kompatibilis klienssel.

Hogyan működik

Az eszközlista a build időpontjában generálódik a live OpenAPI-specből (api.astroway.info/v1/openapi.json). Minden csomagkiadás automatikusan felveszi az összes új végpontot – semmit sem kell kézzel karbantartani.

Minden végpont eszközzé válik a következő formában:

• tools/list visszaadja a leírást és a bemeneti sémát (példa kérés testtel)
• tools/call HTTP POST-ot küld a https://api.astroway.info/v1/<path> címre a te ASTROWAY_API_KEY-eddel
• A válasz strukturált JSON-ként érkezik az ügynöknek

Minden kiadás SLSA provenance-nel is érkezik (Sigstore-attested) – ez garancia arra, hogy az npm csomag a nyilvános repó egy commitjából épült.

Telepítés

Claude Desktop (macOS)

Add hozzá a ~/Library/Application Support/Claude/claude_desktop_config.json-hoz:

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

Indítsd újra a Claude Desktopot. A csevegés alatti sávban megjelenik egy 🛠️ indikátor a betöltött eszközök számával.

Cursor

Add hozzá a ~/.cursor/mcp.json-hoz:

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

Cline / Continue / Windsurf / Copilot / VS Code MCP

Ugyanaz a npx @astroway/mcp parancs működik minden MCP-kompatibilis kliensen. A konfiguráció azonos – csak a fájl útvonala változik:

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

Kliens	Konfiguráció útvonala
Cline (VS Code)	.cline/mcp.json a workspace gyökerében
Continue	~/.continue/config.json (mcpServers alatt)
Windsurf	~/.codeium/windsurf/mcp_config.json
GitHub Copilot Chat (VS Code)	preview flag → mcp.json a workspace-ben
VS Code MCP extension	~/.vscode/mcp.json

Egyéb MCP kliensek

Futtasd stdio-szerverként:

ASTROWAY_API_KEY=aw_live_... npx @astroway/mcp

Tipp

Szerezz kulcsot a api.astroway.info/dashboard/sign-up oldalon. Ingyenes szint – 10 000 kredit/hó, kártya nélkül.

Adatvédelem – v1.0.0+

Ez az MCP-szerver nem küld semmit vissza az AstroWay felé a tényleges API-hívásokon kívül, amiket neked ad végrehajtani. Nincs telemetria, nincs analytics, nincs opt-in/opt-out kapcsoló – alapértelmezés szerint csend.

A kimenő kérések két azonosító fejlécet tartalmaznak, hogy az AstroWay backend meg tudja különböztetni az MCP forgalmat a közvetlen HTTP-től a saját naplóiban:

• User-Agent: astroway-mcp/<version> (Node/<node-version>)
• X-Astroway-Channel: mcp

Egyik sem tartalmaz session ID-t, gép ujjlenyomatot vagy személyes adatot. Ez egy szabványos User-Agent szemantika – minden CLI-eszköz hasonló információt küld.

Részhalmaz regisztráció – v1.0.0+

Ha csak a katalógus egy részét használod – regisztráld a részhalmazt, hogy az LLM kontextusablaka kompakt maradjon:

{
  "env": {
    "ASTROWAY_API_KEY": "aw_live_...",
    "ASTROWAY_TOOL_GROUPS": "western,vedic,relational",   // only these prefixes
    "ASTROWAY_READONLY": "1"                               // skip ai/horoscope/reports (LLM-backed, costs credits)
  }
}

Gyakori csoportok: western, vedic, tarot, numerology, hd (Human Design), relational (synastry/composite/davison), prognostics (transits/progressions/returns), aspects, horary, geo, chinese, bazi, mayan, iching, runes, geomancy. Futtasd a npx @astroway/mcp --list-tools parancsot a teljes készlet megtekintéséhez.

ASTROWAY_READONLY=1 kihagyja a három LLM-et meghívó csoportot (ai, horoscope, reports) – hasznos, ha tiszta, determinisztikus kártyamatematikát szeretnél, anélkül, hogy krediteket költenél szöveg generálására.

Stabilitási elkötelezettség – v1.0.0+

• A katalógus a munkamenet idejére lefagyott. 780+ eszköz, 12 prompt, 14 resource be van ágyazva a kiadott npm csomagba a build időpontjában – semmi nem változik a csatlakozás során. Ha a kliended a tools/list-et cache-eli az első hívás után – az a teljes munkamenetre helyes marad.
• Az eszközazonosítók stabilak a major verzióban. Az astroway_<group>_<tool> név nem lesz átnevezve vagy törölve a v1.x verziókban, de csak deprecation megjegyzés után a CHANGELOG.md-ben és egy minor párhuzamos elérhetőség mellett.
• Az eszköz bemeneti struktúrája stabil a minor verzióban. Szűkítések (regex, range, enum) patch-ekben jönnek; kötelező mező hozzáadása minor bump-ot igényel.
• A katalóg frissítése: újratelepítéssel. npm i -g @astroway/mcp@latest (vagy a npx -y @astroway/mcp forma a konfigurációdban) a következő indításkor a legfrissebb készletet hozza.

Prompt példák

A szerver csatlakoztatása után kérd meg az AI-t:

Születési horoszkóp

Számold ki a születési horoszkópom – született 1990. március 15., 14:30, Kijev. Írd le a Napot, Holdat, Ascendenst és találd meg a szoros aspektusokat.

Tranzitok

Melyek a jelentős lassú bolygók tranzitjai, amelyek 2027-ben a születési horoszkópomra esnek?

Claude két tool-call-t hajt végre: először a transits (aktuális pillanatkép), majd a transit-calendar (időintervallum). Értelmezi a trendeket.

Védikus Mahadasha

Indítsd el a Vimshottari Mahadasha-t egy 1985.07.22., 06:45 Mumbai-ban született személy számára. Melyik időszakban van most ez a személy?

A vedic/dashas/vimshottari/maha eszközön keresztül – a jelenlegi periódus pontos UTC időbélyegzője.

Szinasztria

Hasonlítsd össze a két horoszkópot: A – 1988.06.10. 09:15 London, B – 1991.11.22. 22:40 Berlin. Melyek a legerősebb kereszt-aspektusok?

A synastry eszköz két chart blokkot használ + a kompatibilitási pontszám értelmezése.

Tarot

Húzz ki 3 Rider-Waite-Smith kártyát: Múlt – Jelen – Jövő. Kérdés: “érdemes új munkát vállalni?”. Seed = 42.

tarot/rider-waite/spread rögzített seed-del a reprodukálhatóságért.

Az összes eszköz listája

A csatlakozás után kérdezd meg Claude-t:

Sorold fel az összes astroway-eszközt.

Vagy a parancssorból:

ASTROWAY_API_KEY=aw_test_smoke npx @astroway/mcp 2>&1 | head -1
# (starts the stdio server; tool-list calls come from the MCP client over the protocol)

Konfiguráció

Változó	Alapértelmezett	Leírás	Verziótól
ASTROWAY_API_KEY	(kötelező)	Live: aw_live_.... Sandbox: aw_test_....	0.1.0
ASTROWAY_BASE_URL	https://api.astroway.info/v1	Override self-hosted/staging környezetekhez.	0.1.0
ASTROWAY_TOOL_GROUPS	(összes csoport)	Vesszővel elválasztott előtagok a katalógus korlátozásához (western,vedic,relational).	1.0.0
ASTROWAY_READONLY	0	1 kihagyja az LLM-alapú csoportokat (ai, horoscope, reports).	1.0.0
LOG_LEVEL	error	silent/error/warn/info/debug – naplózási szint stderr-en.	0.8.0
LOG_FILE	(nem íródik)	Az útvonal a napló másolatához.	0.8.0
MCP_FLAT_TOOLS	0	1 visszaadja a pre‑v0.9 flat‑neveket (chart a astroway_western_chart helyett). Legacy.	0.9.0

Miért MCP, és nem közvetlen integráció

Egy általános LLM (grounding nélkül) azt mondja majd “valamikor júliusban a Szaturnusz trójuszt alkot a Jupitereddel” – pontos dátum nélkül, ±15 nap eltéréssel. Az MCP-ügynök tool_use POST /v1/transits‑t hajt végre és UTC‑timestamp‑et ad vissza másodperc pontossággal, a valódi Swiss Ephemeris‑en.

Az előny nem az LLM-ben, hanem a garanciában, hogy a matematika valós – nem kitalált.

A csomag terjesztése

• mcp.so listing: mcp.so/server/astroway-mcp/astroway
• mcpservers.org: jóváhagyásra vár (2026 májusában)
• awesome-mcp-servers (punkpeye): PR #5972

Hivatkozások

• 📦 npm: npmjs.com/package/@astroway/mcp
• 📘 API docs: /docs/api/
• 🔑 Sign up: /dashboard/sign-up
• 💰 Pricing: /pricing/
• 🌐 Public repo (MIT): github.com/astroway/astroway-mcp