Cursor

Connetti AstroWay API a Cursor tramite MCP. Sono disponibili entrambi i trasporti: hosted (HTTP) e il pacchetto stdio locale.

Prerequisiti

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

Connessione

Modifica ~/.cursor/mcp.json (oppure .cursor/mcp.json a livello di progetto); è accessibile anche da Settings → MCP. Incolla uno dei blocchi qui sotto e riavvia Cursor.

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

~/.cursor/mcp.json

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

Stdio (npx): sottoprocesso locale, autenticazione tramite variabile d’ambiente, funziona offline:

~/.cursor/mcp.json

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

Verifica

Scrivi all’agente in chat: “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 Cursor e controlla il percorso di ~/.cursor/mcp.json (per il file di progetto, .cursor/mcp.json).
• 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.