# Dai a Cursor l'accesso a Linear

> Prima di ogni attività copi a mano i dettagli dei ticket nell'editor.

Questo setup è per gli sviluppatori che pianificano il lavoro in Linear e scrivono codice in Cursor. L'agente di Cursor legge una issue di Linear dal suo identificativo, pianifica la modifica partendo dalla descrizione e dai commenti, poi apre una pull request su GitHub collegata alla issue. Non devi più copiare a mano il testo dei ticket nell'editor.

## Passaggi

1. **Aggiungi Linear a Cursor**: Apri Cursor Settings > MCP (Tools & Integrations nelle versioni recenti) e aggiungi un nuovo server. Usa l'URL del server remoto di Linear, https://mcp.linear.app/mcp, nel tuo mcp.json. Salva il file e aspetta che il server risulti connesso.
   Consiglio: Mettilo nel .cursor/mcp.json del progetto se solo un repository ha bisogno di Linear, oppure nella configurazione globale per tutti i progetti.
2. **Autorizza il tuo workspace**: Alla prima chiamata di Cursor verso Linear si apre una finestra del browser per l'OAuth. Accedi e scegli il workspace usato dal tuo team, poi torna in Cursor. Chiedi all'agente di elencare le issue assegnate a te per controllare che veda il workspace giusto.
   Consiglio: Se in seguito cambi workspace, rimuovi e aggiungi di nuovo il server per rifare l'autorizzazione.
3. **Cita le issue nei prompt**: In modalità Agent chiedi a Cursor di leggere una issue tramite il suo identificativo, per esempio ENG-412, e di proporre un piano prima di scrivere codice. Confronta il piano con i criteri di accettazione e i commenti della issue. Poi lascia che faccia la modifica nel tuo branch.
   Consiglio: Chiedi all'agente di pubblicare un breve commento sull'avanzamento nella issue di Linear quando ha finito.
4. **Apri la pull request**: Aggiungi il server MCP di GitHub con un token fine-grained che possa creare branch e pull request nel repository. Chiedi a Cursor di aprire una PR con l'identificativo della issue di Linear nel titolo o nel nome del branch. A quel punto l'integrazione GitHub di Linear collega automaticamente la PR alla issue.
   Consiglio: L'integrazione GitHub deve essere attiva nelle impostazioni di Linear perché il collegamento sia automatico.

## Prompt da provare

- Leggi ENG-412 e proponi un piano per la modifica prima di scrivere codice.
- Implementa ENG-412 in un nuovo branch chiamato eng-412-export-csv ed esegui i test.
- Elenca le mie issue di Linear del ciclo attuale che sono In Progress.
- Apri una pull request per questo branch con ENG-412 nel titolo e un riepilogo delle modifiche.
- Aggiungi un commento su ENG-412 per dire che la correzione è in revisione, con il link alla PR.

## Cosa ti serve

- Cursor con la modalità Agent
- Un account Linear nel workspace da usare
- Un token GitHub fine-grained con accesso alle pull request
- L'integrazione GitHub di Linear attiva per collegare automaticamente le PR

## Limiti

- L'agente conosce solo la issue, i suoi commenti e il tuo repository; le decisioni prese in riunione restano invisibili.
- L'accesso OAuth usa i tuoi permessi su Linear: l'agente vede quindi tutti i team che vedi tu.
- Le discussioni lunghe occupano spazio nel contesto; sulle issue grandi chiedi prima un riepilogo.

## Note di sicurezza

- Quando puoi, usa OAuth invece di una chiave API personale.
- Controlla ogni aggiornamento delle issue proposto da Cursor.

## Server MCP

- [Linear MCP Server](https://linear.app/docs/mcp): issue-read, issue-write, project-read
- [GitHub MCP Server](https://github.com/github/github-mcp-server): repository-read, issue-write, pull-request-write

## Domande frequenti

**Quale piano di Cursor mi serve?**

I server MCP funzionano nella modalità Agent di Cursor, disponibile sia nel piano gratuito sia in quelli a pagamento, con limiti di utilizzo diversi. Controlla la pagina dei prezzi di Cursor per i limiti attuali.

**Cursor può modificare le issue di Linear?**

Sì. Il server MCP di Linear può creare e aggiornare issue e commenti con i permessi del tuo account. Cursor chiede conferma prima di eseguire le chiamate agli strumenti, a meno che tu non attivi l'esecuzione automatica.

**Funziona anche in altri editor?**

Il server di Linear funziona con qualsiasi host MCP, tra cui Claude Code, VS Code e Windsurf. Questa guida usa Cursor perché i passaggi e i percorsi delle impostazioni corrispondono alla sua interfaccia.

**E se la descrizione della issue è scarna?**

L'agente pianifica in base a quello che dice la issue. Aggiungi prima i criteri di accettazione e i link ai mockup in Linear, oppure dai i dettagli mancanti nel prompt.

## Strumenti

- **[Linear](https://suiteintent.com/t/linear?m=IT)**: Issue tracker veloce, pensato per la tastiera. · Ideale per: Startup che pianificano a cicli · Piano gratuito · Gratis per startup
- **[GitHub](https://suiteintent.com/t/github?m=IT)**: Hosting di codice, issue e pull request. · Ideale per: Team che revisionano il codice con pull request · Piano gratuito · 10000