Claude Desktop

Verbind de AstroWay API met Claude Desktop via MCP: met een één‑klik extensie of handmatig via configuratie, met een hosted‑server (HTTP) of een lokaal stdio‑pakket.

Voorvereisten

Haal een API‑sleutel op in het dashboard. Voor gratis testen gebruik je de sandbox‑sleutel aw_test_* – die geen kredieten verrekent.

Eén‑klik extensie

1. Download astroway.mcpb.
2. Open het bestand. Claude Desktop toont een installatiedialoog.
3. Plak de API‑sleutel, selecteer de instrumentengroepen (standaard geboortehoroscopen, transits, progressies, terugkeer, synastrie en kalender) en schakel de extensie in.

De configuratie hoef je niet te bewerken. De extensie is het npm‑pakket @astroway/mcp met zijn afhankelijkheden, gebouwd vanaf dezelfde release. Leeg het groepsveld om alle 700+ instrumenten te laden.

Handmatige verbinding

Open Settings → Developer → Edit Config – Claude Desktop toont het pad naar het bestand claude_desktop_config.json. Plak een van de onderstaande blokken en herstart Claude Desktop.

Hosted (HTTP): zonder ons pakket, authenticatie via Bearer‑token. De configuratie van Claude Desktop start alleen lokale commando’s en negeert de vermelding met de eigen url, dus de hosted‑server wordt via de brug mcp-remote verbonden:

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

De sleutel staat in env, niet in args, omdat Claude Desktop op Windows het argument splitst op de spatie na Bearer. Om één thema in plaats van de volledige map te laden, vervang je /mcp door een domein‑server, bijvoorbeeld /mcp/core of /mcp/vedic.

Stdio (npx): lokaal subprocess, authenticatie via een env‑variabele, werkt offline:

claude_desktop_config.json

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

Controle

Typ in de chat naar Claude: “Geef een lijst van Astroway‑instrumenten” – of vraag om een gratis referentie‑instrument, bijvoorbeeld de lijst van sterrenbeelden op te halen. Als je een resultaat terugkrijgt, werkt de verbinding.

Probleemoplossing

• 401 / invalid key: zorg ervoor dat de sleutel het prefix aw_live_* of aw_test_* heeft en niet is ingetrokken. Je kunt dit controleren in het dashboard.
• “Some MCP servers couldn’t be loaded”: in de url‑vermelding in plaats van command. Gebruik het blok met mcp-remote hierboven.
• Instrumenten verschijnen niet: herstart Claude Desktop volledig (log uit, in plaats van alleen het venster te sluiten) en controleer het pad naar claude_desktop_config.json.
• Validatiefouten -32602 (voor stdio): update het pakket: npm i @astroway/mcp@latest. De schema’s worden opnieuw gegenereerd vanuit de actuele specificatie.

Alle clients - Agentconfiguratie.