Collegare Cursor al tuo studio

Che cos’è

Cursor è un editor con IA integrata. Con il connettore IA, la chat di Cursor consulta i dati del tuo studio (vendite, clienti, agenda, situazione finanziaria) quando fai una domanda, con le autorizzazioni dell’utente associato alla chiave. Può solo consultare i dati: non modifica nulla nel sistema.

Quando usarlo

Sviluppi un’integrazione o un sito e vuoi controllare i dati reali dello studio senza uscire dall’editor.
Usi la chat di Cursor ogni giorno e vuoi fare domande sull’attività dello studio.

Prima di iniziare

Tieni a portata di mano l’indirizzo del connettore e una chiave API con l’opzione “Consenti l’uso come connettore IA”, creati seguendo l’articolo Connettore IA.

Passo dopo passo

Passaggio 1 — Aggiungere il connettore

Apri (o crea) il file ~/.cursor/mcp.json e aggiungi il frammento qui sotto, sostituendo l’indirizzo con quello che hai copiato in Copia indirizzo e hk_... con la tua chiave:

{
  "mcpServers": {
    "heya": {
      "url": "https://seu-dominio/mcp",
      "headers": { "Authorization": "Bearer hk_..." }
    }
  }
}

Passaggio 2 — Verificare la connessione

Nelle impostazioni di Cursor, apri la sezione MCP. Il connettore heya dovrebbe risultare attivo, con gli strumenti listar_areas, buscar_ferramentas ed executar_consulta.

Passaggio 3 — Fare una domanda

Nella chat di Cursor, fai una domanda, ad esempio: “quali clienti sono stati serviti oggi nello studio?”.

Cosa succede dopo

Cursor individua la query giusta per la domanda, la esegue e risponde con i dati del sistema.
La chiave appare nella scheda API Key e il valore di Ultimo utilizzo si aggiorna.
Per revocare l’accesso, revoca la chiave nella scheda API Key: Cursor perderà l’accesso entro 30 secondi.

Errori comuni e domande

D: Il connettore mostra un errore nelle impostazioni di Cursor. Cosa devo fare? R: Verifica che l’indirizzo termini con /mcp e che la chiave sia stata incollata per intero, con Bearer e uno spazio prima della chiave. Dopo aver modificato mcp.json, disattiva e riattiva il connettore nelle impostazioni di Cursor.

D: Posso usare una variabile d’ambiente al posto della chiave? R: Alcune versioni di Cursor non sostituiscono la variabile con il suo valore nell’intestazione e inviano il testo così com’è. Se il connettore non si collega usando la variabile, inserisci la chiave direttamente nel file del tuo utente.

D: Posso inserire la configurazione nel file .cursor/mcp.json del progetto? R: Meglio di no: questo file finisce spesso nel controllo versione e la chiave rimarrebbe esposta. Usa il file del tuo utente (~/.cursor/mcp.json).

D: Cursor dice che la chiave deve avere l’opzione “Consenti l’uso come connettore IA”. Perché? R: La chiave è stata creata senza questa opzione. Modifica la chiave nella scheda API Key e seleziona Consenti l’uso come connettore IA.

D: Cursor ha aperto una schermata di accesso invece di usare la chiave. Cosa devo fare? R: Verifica che il blocco headers con la chiave sia presente in mcp.json. Con la chiave corretta, il sistema risponde direttamente e non è necessario accedere. Se Cursor continua a chiedere l’accesso e questo non riesce, usa la chiave con Claude Code o Gemini CLI, oppure contatta l’assistenza.

D: Cursor può modificare i dati del sistema tramite il connettore? R: No. Il connettore può solo consultare i dati. Le modifiche si effettuano nel sistema.