# 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.

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.

## Passaggi

1. **Aggiungi 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. **Aggiungi 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. **Dai 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. **Controlla 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.

## Prompt da provare

- Smista le issue aperte in acme/app create questa settimana e mostrami una tabella con label, priorità e team Linear.
- Crea issue Linear nel team Platform per le issue GitHub che hai segnato come bug, con un link a GitHub.
- Trova le issue GitHub che sembrano duplicati di issue Linear esistenti ed elencale una accanto all'altra.
- Aggiungi le label bug e needs-repro alla issue 512 e chiedi all'autore la versione del browser in un commento.
- Riassumi le nuove issue GitHub della settimana per area di prodotto per la riunione di pianificazione.

## 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.

## Note di sicurezza

- Usa un token GitHub fine-grained limitato a repository specifici.
- Mantieni l'approvazione delle chiamate agli strumenti per ogni azione di scrittura.

## Server MCP

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

## Domande frequenti

**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

- **[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
- **[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