Linear MCP: collegare gli assistenti AI al lavoro del team

Configurare Linear MCP: URL del server e autenticazione

L’indirizzo da usare è https://mcp.linear.app/mcp, con trasporto Streamable HTTP, una connessione web al server ospitato da Linear. La configurazione interattiva usa OAuth 2.1 con registrazione dinamica del client, che gestisce la registrazione del client e l’autorizzazione dell’utente. In alternativa, si può inviare un token OAuth o una chiave API di Linear nell’header Authorization: Bearer <yourtoken>. Configurazione di Linear MCP

Si può pensare a MCP come a uno sportello condiviso. L’assistente richiede un’operazione specifica, per esempio cercare una issue o salvare una modifica. Il server di Linear esegue l’operazione consentita dalla connessione. Il prompt esprime l’intento, ma non concede permessi aggiuntivi.

Sono modi diversi di limitare una connessione. Scrivere «non modificare nulla» nel prompt significa dare un’istruzione all’assistente; un endpoint o una credenziale in sola lettura limita invece le operazioni che può eseguire. Opzioni di accesso di Linear

Come collegare il client usato dal team

Claude e Claude Code

Nell’app di Claude per browser o desktop, aprire Settings → Connectors e collegare Linear. È il percorso indicato nella pagina di Linear dedicata all’integrazione con Claude.

Per Claude Code:

1. Eseguire claude mcp add --transport http linear-server https://mcp.linear.app/mcp nel terminale.
2. Aprire una sessione di Claude Code.
3. Eseguire /mcp e completare la procedura di autenticazione.

Sia il comando sia il passaggio successivo provengono dalle istruzioni di Linear per Claude.

Cursor

La guida principale di Linear offre un link di installazione e invita a cercare Linear nella pagina degli strumenti MCP di Cursor. Il collegamento da usare si trova nella sezione di Linear dedicata a Cursor.

La pagina specifica per Cursor descrive anche questa procedura manuale:

1. Premere Ctrl/Cmd + Shift + J per aprire le impostazioni di Cursor.
2. Selezionare MCP.
3. Selezionare Add new global MCP server.
4. Aggiungere questa configurazione:

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.linear.app/mcp"]
    }
  }
}

La configurazione usa mcp-remote, un ponte tra il client e il server ospitato da Linear. È quella pubblicata nella pagina di Linear sull’integrazione con Cursor.

Codex CLI ed estensione per IDE

Secondo Linear, la CLI e l’estensione per IDE condividono la configurazione MCP.

1. Eseguire codex mcp add linear --url https://mcp.linear.app/mcp.
2. Seguire la richiesta di accesso a Linear descritta nella guida di configurazione.
3. Per la configurazione manuale, Linear indica di autenticarsi con codex mcp login linear dopo aver modificato ~/.codex/config.toml.

Prima di copiare una configurazione, occorre considerare una discrepanza nella documentazione:

La pagina dedicata riporta come voce di configurazione manuale del server [mcp_servers.linear] con url = "https://mcp.linear.app/mcp". Queste impostazioni sono riprodotte così come pubblicate, ma i due flag discordanti non vanno considerati un prerequisito universale valido oggi. Integrazione di Linear con Codex, guida MCP principale

Conviene usare la procedura di aggiunta e accesso descritta sopra. La guida MCP attuale di OpenAI documenta la configurazione dei server HTTP e il comando codex mcp login <server-name> senza richiedere nessuno dei due flag. Documentazione MCP ufficiale di OpenAI

ChatGPT

Seguire la procedura effettivamente documentata da Linear:

1. Aprire le impostazioni dei connettori di ChatGPT tramite il link nella pagina di Linear sull’integrazione con ChatGPT.
2. Collegare Linear.
3. Aggiungere Linear come fonte nella ricerca approfondita.

Linear descrive questa connessione come un modo per consultare issue, progetti e discussioni mantenendo i permessi già assegnati all’utente. Non documenta la creazione o l’aggiornamento delle issue con questa configurazione. Va quindi usata per ricerche e riepiloghi; per gli esempi di modifica riportati più avanti serve un client MCP con capacità di scrittura documentate. La distinzione riguarda questa specifica connessione, non tutte le integrazioni di ChatGPT in generale.

Quali strumenti documenta Linear?

La distinzione utile è tra recuperare informazioni e salvare modifiche. Quelli che seguono sono gli identificatori esatti presenti nell’elenco degli strumenti di uso comune pubblicato da Linear, con le rispettive funzioni. L’elenco si trova nella pagina dell’integrazione con Slack, nella sezione che spiega come collegare lo stesso server Linear MCP a Slackbot. Elenco degli strumenti di Linear

Il changelog di Linear cita anche list_cycles, list_issue_labels, list_comments, save_project e save_document. Documenta i dettagli dei cicli, la paginazione di etichette e commenti, le modifiche ai progetti e la creazione o lo spostamento di documenti sotto iniziative o cicli. Si tratta di una raccolta di strumenti pertinenti documentati pubblicamente: non implica che ogni client esponga un catalogo identico e di dimensioni fisse. Strumenti per cicli ed etichette, strumenti per i commenti, strumenti per progetti e documenti

Gli esempi meno recenti possono usare separatamente create_issue e update_issue. Linear li ha unificati in save_issue. Va tenuto presente quando si copiano vecchi prompt o si sviluppano integrazioni basate sui nomi degli strumenti. La modifica agli strumenti di Linear

A quali dati accede e cosa può controllare un amministratore?

La connessione va considerata un canale autorizzato di accesso ai dati del workspace. Nella terminologia OAuth di Linear, read significa «accesso in lettura all’account dell’utente» e write significa «accesso in scrittura all’account dell’utente». L’attore utente predefinito crea risorse a nome della persona che ha autorizzato l’applicazione. Permessi OAuth di Linear

Per le chiavi API, Linear parla di «accesso completo ai dati a cui il tuo utente può accedere», con la possibilità di limitare permessi e team. Una chiave con restrizioni è quindi sostanzialmente diversa da una chiave personale con autorizzazioni estese. Permessi delle chiavi API

I controlli disponibili dipendono dal metodo di autenticazione della connessione:

Linear spiega che le approvazioni servono a controllare «quali applicazioni possono accedere al workspace e ai suoi dati». I membri possono richiedere l’approvazione durante l’installazione. I controlli sulle chiavi riguardano l’autenticazione tramite chiave API e non sostituiscono la gestione delle connessioni delle app OAuth. Approvazione delle applicazioni, amministrazione delle API

Per i client Anthropic supportati, i workspace Enterprise con Okta SAML possono usare l’autorizzazione gestita dall’azienda. Secondo Linear, questa «applica i permessi Linear già esistenti». Gli amministratori gestiscono l’accesso tramite Okta, senza richiedere a ogni utente un’autorizzazione separata per ciascuna connessione. Autorizzazione gestita dall’azienda

Per un flusso dedicato solo agli aggiornamenti sullo stato del lavoro, scegliere l’accesso in sola lettura. Per il triage e la creazione di issue, concedere i permessi di scrittura necessari e rendere visibili le modifiche proposte prima di applicarle. Questa revisione è una raccomandazione sul processo di lavoro: non significa che ogni client imponga lo stesso meccanismo di approvazione.

Tre flussi di lavoro da mettere in pratica

Conviene iniziare dai report di ciclo, perché possono funzionare senza operazioni di scrittura. Il triage viene dopo, quando la gestione delle nuove segnalazioni diventa ripetitiva. La conversione delle specifiche è utile quando un responsabile dedica tempo a trasformare decisioni già prese in ticket.

Gli esempi che seguono sono simulazioni illustrate nel dettaglio. Mostrano prompt e risultati attesi, non esiti di una prova con accesso a un account.

Preparare una proposta di triage da rivedere

Un responsabile del team di sviluppo potrebbe chiedere all’assistente di esaminare le nuove segnalazioni, recuperare issue esistenti simili e proporre tutte le modifiche insieme. Il vantaggio è ridurre ricerche ripetute e interventi sui singoli campi, lasciando al responsabile la decisione su assegnazioni e priorità.

Esempio di dati in ingresso: una nuova segnalazione, «Il pulsante di esportazione si blocca», indica che il browser smette di rispondere durante un’esportazione con filtri. Una issue esistente, «L’esportazione con filtri non termina», descrive la stessa schermata. Un’altra segnalazione, «Gli inviti non arrivano», non contiene log di consegna né passaggi per riprodurre il problema.

Prompt:

Una proposta utile potrebbe essere questa:

Dopo la revisione, il responsabile potrebbe autorizzare solo le modifiche concordate a etichette e assegnatari tramite save_issue, lasciando invariate le segnalazioni ambigue. L’assistente dovrebbe restituire i link alle issue interessate e un riepilogo dei campi modificati. Le operazioni di recupero e salvataggio sono presenti nell’elenco degli strumenti di Linear.

Prima di sviluppare un sistema di triage su misura, vale la pena confrontarlo con Triage Intelligence. Linear offre già suggerimenti per i campi e rilevamento di duplicati o relazioni. Un’orchestrazione MCP personalizzata ha più senso quando la decisione richiede informazioni o regole che vanno oltre il flusso nativo. Triage Intelligence

Trasformare le specifiche in issue senza inventare requisiti

Un founder potrebbe partire da una specifica funzionale approvata, ottenere bozze di issue e poi creare in Linear le attività già revisionate. Il vantaggio è la coerenza: ogni ticket riporta il requisito da cui deriva e le decisioni ancora da prendere restano visibili.

Esempio di specifica: «Gli amministratori del workspace possono invitare membri tramite email. Gli invitati accettano attraverso un link ricevuto via email. Gli amministratori possono revocare gli inviti in sospeso. Le modifiche alla fatturazione e gli inviti in blocco sono fuori ambito».

Prompt:

Scomposizione proposta in issue:

Domande aperte: cosa succede se l’indirizzo email appartiene già a un membro? Gli inviti scadono? Cosa deve vedere l’invitato dopo la revoca? Queste restano domande finché il responsabile di prodotto non decide.

Dopo l’approvazione, l’assistente potrebbe creare la issue principale e le sotto-issue, restituire i relativi URL e indicare eventuali elementi che non è riuscito a creare. La creazione di sotto-issue è una funzionalità MCP documentata. Novità MCP di Linear

L’assistente si occupa della trascrizione. Le decisioni di prodotto restano al responsabile di prodotto.

Preparare un aggiornamento settimanale a partire dal ciclo

Un responsabile potrebbe trasformare le attività del ciclo in una bozza di aggiornamento, con link a supporto di ogni affermazione. Il vantaggio è passare più rapidamente da aggiornamenti sparsi nelle issue a un report verificabile.

Un report settimanale e un riepilogo del ciclo possono riferirsi a periodi diversi. Occorre specificare team, ciclo e intervallo del report, così che «completato in questo ciclo» non diventi implicitamente «completato questa settimana».

Esempio di materiale di partenza: «Email di invito» viene contrassegnata come Done nell’intervallo del report. «Accettare l’invito» resta In Progress. Un commento su «Revocare l’invito» indica che l’implementazione è in attesa di una decisione di prodotto sull’esperienza da mostrare quando si apre un link revocato.

Prompt:

Esempio di bozza:

In una bozza reale, ogni frase dovrebbe riportare l’URL della issue corrispondente. L’esempio non fornisce volutamente percentuali di completamento né dichiara che ci sia stato un rilascio. Il recupero di cicli, issue e commenti fornisce gli elementi necessari per questo flusso di lavoro. Strumenti per cicli e issue, recupero dei commenti

Altri utilizzi, una volta consolidati questi flussi

La creazione di commenti rientra nelle funzionalità documentate del server, mentre gli strumenti per i progetti forniscono il contesto per il passaggio di consegne. Funzionalità del server, strumenti per i progetti

Il conto economico deve includere il tempo di revisione

La voce di costo interessata è il coordinamento del team di sviluppo. Prima di MCP, un responsabile cerca informazioni, le copia, le mette a confronto e scrive. Con un assistente collegato, deve comunque definire la richiesta, rivedere il risultato e correggere gli errori.

Per calcolare il punto di pareggio, usare i propri costi in questa formula:

Valore netto = (tempo di preparazione manuale − tempo di preparazione assistita, revisione e correzione) × costo orario complessivo − costi aggiuntivi del client e di gestione.

Un report ben presentato che richiede più tempo per essere verificato non ha fatto risparmiare tempo al team. Nel confronto tra i due flussi di lavoro, mantenere invariato l’ambito del report e includere il tempo necessario a rimediare a modifiche errate. L’obiettivo utile è ridurre il lavoro di coordinamento per ogni risultato accettato.

Per scegliere l’abbonamento, consultare la guida ai prezzi di Linear. Se non è stato ancora scelto lo strumento di gestione delle attività, il confronto Linear vs Jira affronta questa decisione. La nostra guida ai migliori server MCP presenta altre connessioni complementari.

Quali prodotti ha senso costruire su questa integrazione?

Un servizio che prepara bozze di aggiornamento sul ciclo è il punto di partenza più promettente. Un responsabile del team di sviluppo potrebbe pagare per un report coerente, che rispetti i confini tra team, separi il lavoro concluso da quello aperto e includa riscontri nelle issue. La versione minima utile salverebbe una definizione del report, recupererebbe i dati pertinenti del ciclo e produrrebbe una bozza modificabile. Pianificazione delle esecuzioni, tentativi successivi in caso di errore e invio sarebbero responsabilità dell’applicazione.

La difficoltà sta nel differenziarsi: un prompt generico per ottenere un riepilogo è facile da replicare. Il potenziale prodotto risiede nelle regole di reporting dell’azienda, nella tracciabilità delle fonti e nel processo di revisione. Prima di creare un servizio autonomo in abbonamento, occorre verificare che questi aspetti rappresentino un problema ricorrente per i team.

Una coda personalizzata per la revisione del triage è un’opportunità più circoscritta. Un responsabile di platform engineering o del supporto tecnico potrebbe pagare per unire il contesto delle issue di Linear alle proprie regole di instradamento e a informazioni di supporto autorizzate separatamente. La versione minima mostrerebbe le modifiche proposte ai campi, gli elementi a supporto e un’azione per approvare o saltare ogni proposta, applicando poi le modifiche accettate.

La difficoltà, in questo caso, è la concorrenza diretta con Triage Intelligence, già integrato in Linear. Ha senso sviluppare il prodotto solo dove informazioni o regole aggiuntive cambiano una decisione che il sistema nativo non riesce a gestire adeguatamente per quel team. Sono ipotesi di prodotto, non risultati ottenuti da clienti.

Dove si fermano i vantaggi della connessione

MCP dà all’assistente accesso alle operazioni, ma non risolve requisiti ambigui né rende affidabili dati incompleti nelle issue. Un ticket contrassegnato come Done può giustificare un’affermazione sullo stato di quel ticket. Da solo, non dimostra che una funzionalità sia arrivata al cliente.

Allo stesso modo, autorizzare Linear non significa autorizzare l’accesso a ogni documento, repository o sistema di supporto citato in una issue. Se l’applicazione da sviluppare richiede quelle fonti, vanno previsti percorsi separati per accedervi e recuperarne i dati.

Per le nuove configurazioni, usare /mcp. Linear indica /sse come alternativa di ripiego deprecata. Anche il precedente server della community di jerhadf dichiara esplicitamente di essere deprecato e non più mantenuto e rimanda al server ufficiale di Linear. Indicazioni attuali sull’endpoint

Da fare lunedì: chiedere al responsabile del team di sviluppo di definire team, ciclo e intervallo temporale per una bozza di aggiornamento in sola lettura. Verificare le affermazioni confrontandole con le issue collegate e paragonare l’impegno di preparazione a quello del processo attuale. Estendere il flusso alle operazioni di scrittura quando il team ha una procedura di revisione chiara.

Per realizzare questi flussi di lavoro attorno alle regole del proprio team, sviluppiamo automazioni AI.