Claude Desktop

Conectează API AstroWay la Claude Desktop prin MCP: prin extensie cu un singur click sau manual prin config, cu server hosted (HTTP) sau pachet stdio local.

Precondiții

Obține cheia API în dashboard. Pentru testare gratuită folosește cheia sandbox aw_test_* - aceasta nu consumă credite.

Extensie cu un singur click

1. Descarcă astroway.mcpb.
2. Deschide fișierul. Claude Desktop va afișa dialogul de instalare.
3. Introdu cheia API, selectează grupurile de instrumente (implicit hărți natale, tranzite, progresii, reveniri, sinastrie și calendar) și activează extensia.

Configul nu trebuie modificat. Extensia este pachetul npm @astroway/mcp cu dependențele sale, construit din aceeași versiune. Golește câmpul grupuri pentru a încărca toate cele 700+ instrumente.

Conectare manuală

Deschide Settings → Developer → Edit Config - Claude Desktop va afișa calea către fișierul claude_desktop_config.json. Inserează unul dintre blocurile de mai jos și repornește Claude Desktop.

Hosted (HTTP): fără pachetul nostru, autentificare prin token Bearer. Configul Claude Desktop rulează doar comenzi locale și ignoră înregistrarea cu url, așa că serverul hosted se conectează prin podul 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" }
  }
}
}

Cheia se află în env, nu în args, deoarece Claude Desktop pe Windows împarte argumentul la spațiu după Bearer. Pentru a încărca o singură temă în loc de întregul catalog, înlocuiește /mcp cu serverul de domeniu, de exemplu /mcp/core sau /mcp/vedic.

Stdio (npx): subproces local, autentificare prin variabilă de mediu, funcționează offline:

claude_desktop_config.json

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

Verificare

Scrie lui Claude în chat: “Enumeră instrumentele Astroway” - sau cere să invoce un instrument de referință gratuit, de exemplu să obții lista semnelor zodiacului. Dacă primești un rezultat în răspuns, conexiunea funcționează.

Depanare

• 401 / invalid key: asigură-te că cheia are prefixul aw_live_* sau aw_test_* și nu este revocată. Poți verifica în dashboard.
• “Some MCP servers couldn’t be loaded”: în înregistrarea url în loc de command. Folosește blocul cu mcp-remote de mai sus.
• Instrumentele nu apar: repornește complet Claude Desktop (deconectează-te, nu doar închide fereastra) și verifică calea către claude_desktop_config.json.
• Erori de validare -32602 (pentru stdio): actualizează pachetul: npm i @astroway/mcp@latest. Schemele sunt regenerate din specificația curentă.

Toți clienții - Setări agent.