Risposta rapida: Il server Linear MCP connette gli agenti di coding IA (Claude Code, Cursor, Windsurf) all'API di gestione progetti di Linear tramite il Model Context Protocol. Con un consumo ridotto di soli 1.480 token di schema per le sue API GraphQL, consente il triage automatico delle issue, il collegamento bidirezionale con le PR e cicli autonomi di correzione bug SWE-bench.
1. Introduzione: Dai chatbot passivi agli agenti di progetto autonomi
Nel 2026 i flussi di lavoro ingegneristici sono profondamente mutati. Agenti terminali come Claude Code, ambienti di sviluppo integrati come Cursor e Windsurf e swarm di agenti autonomi headless non lavorano più isolati nel filesystem locale. Tuttavia, confinare un agente all'interno di un repository Git genera un grave deficit informativo: l'agente comprende il codice ma non possiede alcun contesto organizzativo.
Senza un'integrazione diretta con la piattaforma di issue tracking:
- Gli agenti non possono estrarre autonomamente passaggi di riproduzione e stack trace dai ticket.
- Gli sviluppatori devono incollare manualmente specifiche e criteri di accettazione nei prompt.
- Le Pull Request aperte dagli agenti restano slegate dagli sprint e dai rilasci programmati.
- Si accumulano segnalazioni duplicate nel backlog a causa della mancata correlazione automatica.
Il protocollo Model Context Protocol (MCP) di Anthropic elimina questo ostacolo. Integrando il server Linear MCP (@modelcontextprotocol/server-linear), i team attivano cicli di sviluppo intelligenti: gli agenti Linear API AI eseguono il triage dei ticket, formulano ipotesi di correzione, eseguono suite di test di regressione, aprono PR su GitHub/GitLab e aggiornano lo stato delle issue su Linear senza supervisione continua.
+----------------------------------------------------------------------------------------------------+
| Architettura di triage e bug fixing autonomo con Linear MCP |
+----------------------------------------------------------------------------------------------------+
|
+-----------------------------------+-----------------------------------+
| |
v v
+-------------------------------+ +-------------------------------+
| Team di Ingegneria | | Feed di Monitoraggio Esterno |
| - Roadmap e Cicli di Sprint | | - Eccezioni Sentry / Datadog |
| - Specifiche e Code Review | | - Ticket di Supporto Clienti |
+---------------+---------------+ +---------------+---------------+
| |
| Creazione / Prioritizzazione | Webhook Segnalazioni
v v
+----------------------------------------------------------------------------------------------------+
| ENGINE GRAPHQL DI LINEAR |
| (Team, Progetti, Cicli, Milestone, Issue, Sotto-task, Label) |
+-------------------------------------------------+--------------------------------------------------+
|
| Model Context Protocol (stdio / SSE JSON-RPC 2.0)
v
+----------------------------------------------------------------------------------------------------+
| SERVER LINEAR MCP |
| Tool: linear_search_issues, linear_create_issue, linear_update_issue, linear_add_comment |
+-------------------------------------------------+--------------------------------------------------+
|
+-----------------------------------+-----------------------------------+
| |
v v
+-------------------------------+ +-------------------------------+
| Client Interattivi | | Demoni Autonomi in Background|
| - Claude Code CLI | | - Triage e Deduplicazione |
| - Cursor Agent / Composer | | - Worker di Riparazione SWE |
| - Windsurf Cascade IDE | | - Audit Salute Sprint |
+-------------------------------+ +-------------------------------+2. Benchmark tecnico: Linear MCP a confronto con altri server MCP
Nella scelta di un project management mcp è fondamentale valutare l'overhead dei token di schema, la latenza di rete e l'efficienza dei trasporti:
+---------------------------------------------------------------------------------------------------------------------------------------+
| BENCHMARK DEI SERVER MCP DI GESTIONE PROGETTO (2026) |
+----+---------------------+----------------------------+-------------+-----------+----------+----------+---------------+---------------+
| # | Server MCP | Piattaforma Target | Trasporto | TTFT (ms) | p50 (ms) | p99 (ms) | Token Schema | Numero Tool |
+----+---------------------+----------------------------+-------------+-----------+----------+----------+---------------+---------------+
| 1 | Linear MCP (Ufficiale)| Linear Cloud (GraphQL) | stdio / SSE | 22 ms | 112 ms | 385 ms | 1.480 token | 8 tool |
| 2 | Jira MCP | Atlassian Jira Cloud | SSE / HTTP | 35 ms | 185 ms | 590 ms | 2.890 token | 14 tool |
| 3 | GitHub Issues MCP | GitHub Repositories | stdio / SSE | 19 ms | 94 ms | 310 ms | 3.240 token | 26 tool |
| 4 | GitLab MCP | GitLab CE/EE & Ultimate | stdio | 24 ms | 128 ms | 420 ms | 2.450 token | 18 tool |
| 5 | Plane MCP | Plane Open-Source Agile | stdio / SSE | 21 ms | 118 ms | 390 ms | 1.620 token | 9 tool |
+----+---------------------+----------------------------+-------------+-----------+----------+----------+---------------+---------------+Evidenze del benchmark
- Minimo overhead di schema (1.480 token): Linear MCP richiede solo 1.480 token per l'intero set di strumenti, a fronte dei 3.240 di GitHub e dei 2.890 di Jira.
- Latenza contenuta (p50 di 112 ms): Le API GraphQL veloci e il trasporto
stdiolocale assicurano tempi di risposta ideali per i cicli interattivi. - Nessun overhead N+1: Con un solo comando
linear_search_issuesl'agente riceve titolo, corpo markdown, assegnatario, label e stato.
3. Tool disponibili nel server Linear MCP
linear_search_issues: Ricerca avanzata di issue con filtri per testo, team, stato, ciclo e priorità.linear_get_issue: Recupero del testo completo del ticket in formato Markdown.linear_create_issue: Creazione di nuove issue con stime e specifiche.linear_update_issue: Modifica di stato, priorità, ciclo o assegnazione.linear_add_comment: Aggiunta di commenti con log di esecuzione o link a PR.
4. Configurazione: Claude Code, Cursor e Windsurf
Genera la tua Linear Personal API Key in Settings > My Account > API > Personal API Keys.
4.1 Claude Code CLI (claude mcp)
claude mcp add linear -e LINEAR_API_KEY=lin_api_live_xxxxxxxxxxxxxxxxxxxx -- npx -y @modelcontextprotocol/server-linearSalvato in ~/.claude.json:
{
"mcpServers": {
"linear": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-linear"],
"env": {
"LINEAR_API_KEY": "lin_api_live_9a7b8c3d2e1f4051a2b3c4d5e6f7a8b9"
}
}
}
}4.2 Cursor IDE
Aggiungere al file .cursor/mcp.json:
{
"mcpServers": {
"linear": {
"command": "node",
"args": ["/usr/local/lib/node_modules/@modelcontextprotocol/server-linear/dist/index.js"],
"env": {
"LINEAR_API_KEY": "lin_api_live_9a7b8c3d2e1f4051a2b3c4d5e6f7a8b9"
}
}
}
}4.3 Windsurf Cascade IDE
Configurare in ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"linear": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-linear"],
"env": {
"LINEAR_API_KEY": "lin_api_live_9a7b8c3d2e1f4051a2b3c4d5e6f7a8b9"
}
}
}
}5. Ricetta di automazione: Pipeline SWE-bench autonoma
#!/usr/bin/env bash
set -euo pipefail
ISSUE_KEY="ENG-512"
# 1. Recupero dettagli issue
claude --print "Recupera i dettagli di $ISSUE_KEY tramite linear_get_issue e salvali in /tmp/spec.txt."
# 2. Creazione branch
git checkout -b "fix/${ISSUE_KEY,,}-auto-patch"
# 3. Risoluzione autonoma con test
claude --dangerously-skip-permissions "
Risolvi il problema descritto in /tmp/spec.txt.
1. Scrivi un test di riproduzione in tests/repro_${ISSUE_KEY}.py.
2. Modifica il codice in src/ finché tutti i test non passano.
3. Esegui 'pytest' per escludere regressioni.
"
# 4. Creazione Pull Request
git add -A && git commit -m "fix($ISSUE_KEY): automated patch" && git push origin HEAD
PR_URL=$(gh pr create --title "fix($ISSUE_KEY): Patch automatica" --body "Closes $ISSUE_KEY via Linear MCP")
# 5. Aggiornamento ticket
claude --print "Aggiungi a $ISSUE_KEY il commento 'PR creata: $PR_URL' e imposta lo stato su 'In Review'."6. Sicurezza e mitigazione prompt injection
- Delimitatori XML: Racchiudi i contenuti non attendibili dei ticket nei tag
- Autorizzazioni progressive (HITL): Mantieni la conferma manuale per operazioni irreversibili come la cancellazione di ticket.
- Utenze bot dedicate: Utilizza credenziali con permessi minimi limitati al solo progetto di competenza.
7. Ottimizzazione costi e token
Posiziona le definizioni degli strumenti all'inizio del prompt per sfruttare il Prompt Caching, abbattendo i costi di input dello schema fino al 90%.
8. Conclusione
Il server Linear MCP rappresenta il punto d'incontro ideale tra la gestione agile dei progetti e l'automazione del codice, consentendo ai team di sviluppo di ridurre sensibilmente il carico operativo quotidiano.