VS Code

Connetti l’API AstroWay a VS Code tramite MCP. La configurazione legge il Copilot Chat in modalità Agente.

Premesse

Otterrai l’API chiave sul piano di controllo. Per un test gratuito utilizza il chiave di sabbia aw_test_* - non inciderà i crediti.

Connettività

Crea .vscode/mcp.json nella radice del progetto. Attenzione: in VS Code il chiave è servers (non mcpServers), e ogni server richiede il campo type. Inserisci uno dei blocchi sotto e riavvia VS Code.

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

.vscode/mcp.json

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

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

.vscode/mcp.json

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

Verifica

Nel Copilot Chat (modalità Agente) digita: «Elenco gli strumenti Astroway» - o chiedi di attivare lo strumento di riferimento gratuito, ad esempio ottieni la lista dei segni zodiacali. Se ottieni un risultato, la connessione funziona.

Risoluzione dei problemi

• 401 / chiave non valida: assicurati che la chiave abbia il prefisso aw_live_* o aw_test_* e non sia stata revocata. Puoi verificare in piano di controllo.
• Gli strumenti non appaiono: riavvia completamente VS Code e verifica il percorso .vscode/mcp.json (chiave servers, campo type).
• 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 - Impostazioni dell’agente.