Claude Code

Collega l’API AstroWay a Claude Code tramite MCP. Non serve modificare file: si configura tutto con un solo comando nel terminale.

Prerequisiti

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

Connessione

Esegui uno dei comandi nel terminale. Dopodiché riavvia Claude Code.

Hosted (HTTP): nessuna 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): sottoprocesso locale, autenticazione tramite variabile d’ambiente, funziona offline:

terminal

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

Verifica

Scrivi a Claude in chat: “Elenca gli strumenti di Astroway”, oppure chiedigli di chiamare uno strumento reference gratuito, per esempio ottenere l’elenco dei segni zodiacali. Se ricevi un risultato, la connessione funziona.

Risoluzione dei problemi

• 401 / invalid key: verifica che la chiave abbia il prefisso aw_live_* o aw_test_* e non sia stata revocata. Puoi controllarlo nella dashboard.
• Gli strumenti non compaiono: riavvia completamente Claude Code e controlla che il server sia stato aggiunto (claude mcp list).
• Errori di validazione -32602 (per stdio): aggiorna il pacchetto con npm i @astroway/mcp@latest. Gli schemi vengono rigenerati dalla specifica aggiornata.

Tutti i client: Configurazione dell’agente.