Claude Code

Connetti l’API AstroWay a Claude Code tramite MCP. Non è necessario modificare i file - tutto è configurabile con una sola riga di comando nel terminale.

Premesse

Otterrai la chiave API su dashboard. Per il test gratuito utilizza la chiave sandbox aw_test_* - non inciderà sui crediti.

Connetti

Esegui una delle righe di comando nel terminale. Dopo di che, riavvia Claude Code.

Hosted (HTTP): senza installazione, autenticazione tramite token Bearer:

terminal

claude mcp add --transport http astroway https://mcp.astroway.info/mcp \
--header "Authorization: Bearer aw_live_YOUR_KEY"

Stdio (npx): processo locale, autenticazione tramite variabile di ambiente, funziona offline:

terminal

claude mcp add astroway --env ASTROWAY_API_KEY=aw_live_YOUR_KEY -- npx -y @astroway/mcp

Verifica

Scrivi a Claude nel chat: «Elenca gli strumenti Astroway» - o chiedi di attivare l’ strumento di riferimento gratuito, ad esempio ottieni la lista dei segni zodiacali. Se arriva un risultato, la connessione funziona.

Risolvi i problemi

• 401 / chiave non valida: assicurati che la chiave abbia il prefisso aw_live_* o aw_test_* e non sia stata revocata. Verifica possibile in dashboard.
• Gli strumenti non appaiono: riavvia completamente Claude Code e verifica che il server sia stato aggiunto (claude mcp list).
• Errori di validazione -32602 (per stdio): aggiorna il pacchetto: npm i @astroway/mcp@latest. Le schemi vengono ricreati con la specifica attuale.

Tutti i clienti - Impostazione dell’agente.