Claude Desktop

Collega l’API AstroWay a Claude Desktop tramite MCP: con un’estensione in un clic o manualmente tramite configurazione, con un server ospitato (HTTP) o un pacchetto stdio locale.

Prerequisiti

Ottieni la tua chiave API nella dashboard. Per test gratuiti, usa la chiave sandbox aw_test_* – non consumerà crediti.

Estensione in un clic

1. Scarica astroway.mcpb.
2. Apri il file. Claude Desktop mostrerà una finestra di dialogo per l’installazione.
3. Incolla la chiave API, seleziona i gruppi di strumenti (per impostazione predefinita, temi natali, transiti, progressioni, ritorni, sinastria e calendario) e abilita l’estensione.

Non è necessario modificare la configurazione. L’estensione è il pacchetto npm @astroway/mcp con le sue dipendenze, compilato dalla stessa release. Cancella il campo dei gruppi per caricare tutti gli oltre 700 strumenti.

Connessione manuale

Apri Impostazioni → Sviluppatore → Modifica Configurazione - Claude Desktop mostrerà il percorso del file claude_desktop_config.json. Incolla uno dei blocchi seguenti e riavvia Claude Desktop.

Ospitato (HTTP): senza il nostro pacchetto, autenticazione tramite token Bearer. La configurazione di Claude Desktop esegue solo comandi locali e ignora la voce con il solo url, quindi il server ospitato si connette tramite il bridge 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" }
  }
}
}

La chiave si trova in env e non in args, perché Claude Desktop su Windows spezza l’argomento allo spazio dopo Bearer. Per caricare un singolo tema invece dell’intero catalogo, sostituisci /mcp con un server di dominio, ad esempio /mcp/core o /mcp/vedic.

Stdio (npx): sottoprocesso locale, autenticazione tramite variabile d’ambiente, funziona offline:

claude_desktop_config.json

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

Verifica

Scrivi a Claude nella chat: “Elenca gli strumenti Astroway” - oppure chiedigli di richiamare uno strumento di riferimento gratuito, ad esempio per ottenere un elenco dei segni zodiacali. Se ricevi un risultato in risposta, la connessione funziona.

Risoluzione dei problemi

• 401 / invalid key: assicurati che la chiave abbia il prefisso aw_live_* o aw_test_* e che non sia stata revocata. Puoi verificarlo nella dashboard.
• “Some MCP servers couldn’t be loaded”: nella voce url invece di command. Usa il blocco con mcp-remote qui sopra.
• Gli strumenti non appaiono: riavvia completamente Claude Desktop (esci, non solo chiudere la finestra) e controlla il percorso di claude_desktop_config.json.
• Errori di validazione -32602 (per stdio): aggiorna il pacchetto: npm i @astroway/mcp@latest. Gli schemi vengono rigenerati dalla specifica attuale.

Tutti i client - Configurazione dell’agente.