Vai al contenuto

Collega Claude a GitHub e Linear

Le nuove issue GitHub si accumulano più in fretta di quanto qualcuno riesca a etichettarle, e il lavoro vero si segue in Linear.

4 passaggiIntermedia
Claude DesktopClaude CodeGitHubLinear

Come si collega

La tua IA raggiunge le tue app tramite piccoli connettori chiamati server MCP.
La tua IA
Claude DesktopClaude Code
Connettori
GitHubLinear
Le tue app
GitHubLinear

Questo setup è pensato per maintainer e team di prodotto che ricevono le segnalazioni di bug in GitHub Issues ma pianificano il lavoro in Linear. Claude legge le nuove issue GitHub, propone label e priorità, poi crea le issue Linear corrispondenti nel team giusto dopo la tua approvazione. Ottieni un backlog smistato in Linear e una lista di issue GitHub più pulita.

Configuralo

4 passaggi. Aprine uno per i dettagli.
  1. 1Aggiungi il server MCP di GitHub

    In GitHub crea un token fine-grained limitato ai repository da smistare, con accesso in lettura e scrittura alle issue e in lettura ai metadati. Aggiungi il server MCP ufficiale di GitHub a Claude Desktop o Claude Code con questo token. Chiedi a Claude di elencare le dieci issue aperte più recenti per confermare l'accesso.

    Consiglio: Lascia disattivati i permessi su contenuti e pull request: per lo smistamento bastano le issue.

  2. 2Aggiungi il server MCP di Linear

    Aggiungi il server MCP remoto di Linear su mcp.linear.app e completa l'accesso OAuth nel browser. Scegli il workspace che contiene i tuoi team di prodotto. Chiedi a Claude di elencare i tuoi team Linear e i loro stati di workflow per verificare che veda il workspace giusto.

    Consiglio: Se fai parte di più workspace, controlla i nomi dei team prima di creare qualsiasi cosa.

  3. 3Dai a Claude le regole di smistamento

    Scrivi brevi regole di smistamento: le tue label GitHub e il loro significato, come assegni la priorità e quale team Linear è responsabile di quale parte del prodotto. Salvale in un Progetto Claude, in CLAUDE.md o in un prompt da incollare ogni volta. Aggiungi due o tre vecchie issue con l'instradamento scelto, come esempio.

    Consiglio: Aggiungi una regola per i duplicati, per esempio cercare il titolo in Linear prima di creare una nuova issue.

  4. 4Controlla prima di scrivere

    Chiedi prima a Claude una tabella di smistamento: issue, label proposte, priorità, team di destinazione e un motivo in una riga. Correggi ciò che è sbagliato, poi approva le modifiche alle label e la creazione delle issue Linear. Tieni attiva l'approvazione degli strumenti per le scritture finché qualche giro non passa senza correzioni.

    Consiglio: Chiedi a Claude di aggiungere il link Linear come commento sulla issue GitHub, così gli autori possono seguire i progressi.

Poi chiedi e basta

Cosa dire una volta collegato. Clicca per copiare.
Chiedi a Claude Desktop…Claude Desktop

Da sapere

Cosa ti serve, cosa non fa e come restare al sicuro.
Cosa ti serve
  • Un account GitHub con accesso in scrittura alle issue dei repository interessati
  • Un workspace Linear in cui puoi creare issue
  • Claude Desktop o Claude Code
  • Regole di smistamento scritte con label, priorità e responsabilità dei team
Limiti
  • Claude valuta la priorità dal testo della issue: una segnalazione di bug vaga produce uno smistamento vago.
  • Le issue Linear create così non restano sincronizzate con GitHub: un cambio di stato da una parte non aggiorna l'altra.
  • I backlog grandi vanno gestiti a lotti, perché Claude lavora bene con un numero limitato di issue per conversazione.
Resta al sicuro
  • Usa un token GitHub fine-grained limitato a repository specifici.
  • Mantieni l'approvazione delle chiamate agli strumenti per ogni azione di scrittura.
GitHub MCP Server (repository-read, issue-write, pull-request-write) Linear MCP Server (issue-read, issue-write, project-read)

Domande frequenti

Risposte chiare prima di iniziare
Claude chiuderà o eliminerà issue GitHub?
Solo se il token lo consente e tu approvi la chiamata. Per lo smistamento limitati a label, commenti e creazione di issue Linear, e chiudi le issue tu.
Serve un piano Linear a pagamento?
Il server MCP di Linear funziona con il piano gratuito, nei limiti di issue e team di quel piano. Ti serve un piano Claude che supporti i connettori MCP oppure Claude Code.
Può girare in modo programmato?
In Claude Desktop lanci lo smistamento a mano. Per eseguirlo a intervalli regolari puoi avviare Claude Code in un'attività pianificata, ma tieni un controllo umano prima delle scritture.
E se Claude manda una issue al team sbagliato?
Spostala in Linear e aggiungi il caso come esempio nelle tue regole di smistamento. Esempi chiari correggono la maggior parte degli errori di instradamento.

Strumenti di questa configurazione

I prodotti coinvolti