VS Code

Connetti AstroWay API a VS Code tramite MCP. La configurazione viene letta da Copilot Chat in modalità Agent.

Prerequisiti

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

Connessione

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

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

In Copilot Chat (Agent mode) scrivi: “Elenca gli strumenti di Astroway” oppure chiedi di chiamare uno strumento reference gratuito, per esempio per ottenere l’elenco dei segni zodiacali. Se ricevi un risultato, la connessione funziona.

Risoluzione dei problemi

• 401 / invalid key: assicurati che la chiave abbia il prefisso aw_live_* o aw_test_* e che non sia stata revocata. Puoi verificarlo nella dashboard.
• Gli strumenti non compaiono: riavvia completamente VS Code e controlla il percorso .vscode/mcp.json (chiave servers, campo type).
• 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.