Claude Desktop

Connetti l’API AstroWay a Claude Desktop tramite MCP. Sono disponibili due trasporti: hosted (HTTP) e locale stdio-pacchetto.

Premesse

Otterrai l’API-key nel dashboard. Per il test gratuito utilizza il sandbox-key aw_test_* - non inciderà credito.

Connetti

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

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

claude_desktop_config.json

{
"mcpServers": {
  "astroway": {
    "url": "https://mcp.astroway.info/mcp",
    "headers": { "Authorization": "Bearer aw_live_YOUR_KEY" }
  }
}
}

Stdio (npx): processo locale, autenticazione tramite variabile env, 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 nel chat: «Elenco gli strumenti Astroway» - o chiedi di attivare l’istrumento di riferimento gratuito, ad esempio ottieni la lista dei segni zodiacali. Se arriva il risultato, la connessione funziona.

Risolvi problemi

• 401 / chiave non valida: assicurati che la chiave abbia il prefisso aw_live_* o aw_test_* e non sia stata revocata. Verifica possibile nel dashboard.
• Gli strumenti non appaiono: riavvia completamente Claude Desktop (uscita, 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. Le schemi vengono ricompilati con la specifica attuale.

Tutti i clienti - Configura l’agente.