Claude Desktop

Collega l’API AstroWay a Claude Desktop tramite MCP. Sono disponibili entrambi i trasporti: hosted (HTTP) e pacchetto stdio locale.

Prerequisiti

Ottieni la chiave API nella dashboard. Per i test gratuiti usa la chiave sandbox aw_test_* - non consuma crediti.

Connessione

Apri Settings → Developer → Edit Config - Claude Desktop mostrerà il percorso al file claude_desktop_config.json. Incolla uno dei blocchi qui sotto e riavvia Claude Desktop.

Hosted (HTTP): senza il nostro pacchetto, autenticazione tramite token Bearer. La configurazione di Claude Desktop avvia solo comandi locali e ignora la voce con il url, quindi il server hosted si collega 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 è in env, non in args, perché Claude Desktop su Windows spezza l’argomento sullo spazio dopo Bearer. Per caricare un solo tema invece dell’intero catalogo, sostituisci /mcp con il server di dominio, ad esempio /mcp/core o /mcp/vedic.

Stdio (npx): processo 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 chiedi di chiamare lo strumento di riferimento gratuito, ad esempio per ottenere l’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 non sia revocata. Puoi verificarlo nella dashboard.
• “Some MCP servers couldn’t be loaded”: nella voce url usa command al posto. Usa il blocco con mcp-remote sopra.
• Gli strumenti non compaiono: riavvia completamente Claude Desktop (esci, non solo chiudere la finestra) e verifica 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 più recente.

Tutti i client - Impostazioni agente.