Linear MCP — Cas d'usage, Installer & Démo en direct

Name: Linear MCP Server
Author: linear

Pourquoi l'utiliser

Fonctionnalités clés

Officiel, hébergé à distance — authentification via mcp-remote OAuth, aucune fuite de jeton
Problème CRUD complet : créer, mettre à jour, attribuer, commenter, déplacer l'état
Requête par cycle, équipe, responsable, label, projet ou texte libre
Respecte les autorisations de votre espace de travail linéaire : l'agent ne peut pas faire ce que vous ne pouvez pas faire

Démo en direct

Aperçu en pratique

linear.replay ▶ prêt

0/0

Installer

Choisissez votre client

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

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

Ouvrez Claude Desktop → Settings → Developer → Edit Config. Redémarrez après avoir enregistré.

~/.cursor/mcp.json · .cursor/mcp.json

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

Cursor utilise le même schéma mcpServers que Claude Desktop. La config projet l'emporte sur la globale.

VS Code → Cline → MCP Servers → Edit

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

Cliquez sur l'icône MCP Servers dans la barre latérale Cline, puis "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

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

Même format que Claude Desktop. Redémarrez Windsurf pour appliquer.

~/.continue/config.json

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

Continue utilise un tableau d'objets serveur plutôt qu'une map.

~/.config/zed/settings.json

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

Ajoutez dans context_servers. Zed recharge à chaud à la sauvegarde.

claude mcp add linear -- npx -y mcp-remote https://mcp.linear.app/sse

Une seule ligne. Vérifiez avec claude mcp list. Supprimez avec claude mcp remove.

Cas d'usage

Usages concrets : Linear

Comment trier un backlog linéaire désordonné en 10 minutes

👤 Responsables d'ingénierie, responsables techniques ⏱ ~15 min intermediate

Quand l'utiliser : Lundi matin. Le retard compte plus de 200 problèmes non triés et la planification se fait en une heure.

Prérequis

Accès linéaire à l'espace de travail — OAuth via mcp-remote — le premier appel d'outil ouvre le navigateur pour accorder
Slug d'équipe (par exemple «ENG») — Regardez n'importe quel identifiant de problème - le préfixe est le slug de votre équipe

Déroulement

Extrayez tous les problèmes non triés pour l'équipe

Répertoriez tous les problèmes ENG dans l’état « Triage » ou sans priorité définie, créés au cours des 30 derniers jours. Renvoie l’identifiant, le titre, le journaliste et la longueur de la description.✓ Copié

→ Tableau des candidats avec suffisamment de contexte pour classer
Regroupement par thème

Regroupez-les en 4 à 6 thèmes (bug / infra / onboarding / perf / etc.). Pour chaque cluster, proposer une priorité et une suggestion de projet.✓ Copié

→ Clusters thématiques avec justification
Appliquer les décisions

Pour chaque cluster, mettez à jour les problèmes : définissez la priorité, ajoutez l'étiquette correspondante et passez à l'état « Backlog ». N'affectez personne.✓ Copié

→ N numéros mis à jour, confirmations enregistrées

Résultat : Un backlog prêt à être planifié, regroupé et hiérarchisé, avec une piste d'audit de chaque modification apportée par l'agent.

Pièges

L'agent attribue en masse les problèmes aux mauvaises personnes en fonction de « qui a écrit un code similaire » — Dites-lui explicitement de NE PAS attribuer - l'affectation est un appel humain et devrait le rester
Le débit linéaire de niveau gratuit vous limite après ~ 1 500 requêtes/h — Mises à jour par lots avec « issueBatchUpdate » lorsqu'elles sont disponibles ; sinon, gardez le tri en dessous de 500 problèmes

Combiner avec : sentry · github

Générer un rapport hebdomadaire sur l'état du cycle à partir de Linear

👤 Responsables d'ingénierie, PM ⏱ ~10 min beginner

Quand l'utiliser : Vendredi après-midi, vous devez rédiger la mise à jour hebdomadaire pour le leadership.

Prérequis

Cycle actif en Linéaire — Linéaire > votre équipe > Cycles — notez le numéro de cycle actuel

Déroulement

Statistiques du cycle d'extraction

Pour le cycle ENG 47, répertoriez tous les problèmes regroupés par état. Incluez les tâches terminées cette semaine, en cours, bloquées et à risque (aucune mise à jour depuis plus de 3 jours).✓ Copié

→ Répartition avec décomptes et titres de numéros
Diff par rapport à la semaine dernière

Comparez avec l'instantané de la semaine dernière [collez le JSON précédent]. Qu'est-ce qui a été expédié, qu'est-ce qui a régressé vers des états antérieurs, qu'est-ce qui est nouvellement bloqué ?✓ Copié

→ Delta avec narration
Rédiger le rapport

Rédigez un rapport Markdown d'une page : victoires, en vol, bloqueurs, aide nécessaire. Restez honnête : le leadership lit entre les lignes.✓ Copié

→ Rapport prêt à être collé dans Slack ou Notion

Résultat : Une mise à jour soignée du cycle en 10 minutes au lieu de 45.

Pièges

Les problèmes terminés sans PR fusionnés semblent être des progrès mais ne le sont pas — Combinez avec GitHub MCP : vérifiez que chaque problème « Terminé » a un PR fusionné référencé

Combiner avec : github · notion

Classement automatique des bogues linéaires à partir des nouveaux problèmes Sentry

👤 Ingénieurs de garde ⏱ ~15 min intermediate

Quand l'utiliser : Vous souhaitez que les pics d’erreurs en temps réel dans Sentry deviennent des bogues suivis sans copier-coller manuel.

Prérequis

Sentry MCP installé aux côtés de Linear — Voir le guide des sentinelles pour la configuration
Une étiquette linéaire dédiée comme « from-sentry » — Linéaire > Paramètres > Étiquettes – créer une fois

Déroulement

Trouver de nouveaux problèmes Sentry dépassant le seuil

Recherchez les problèmes Sentry observés pour la première fois au cours des dernières 24 heures avec plus de 50 événements dans le projet web-prod.✓ Copié

→ Liste avec les ID de problème et le nombre d'événements
Rechercher les doublons dans Linear

Pour chaque titre de numéro Sentry, recherchez dans Linear les numéros existants avec des titres similaires ou contenant l'URL Sentry. Ignorez ceux déjà déposés.✓ Copié

→ Liste de déduplication – uniquement les éléments véritablement nouveaux
Créer les bugs linéaires

Créez un problème linéaire dans l'équipe ENG pour chaque nouveau problème Sentry : titre = titre Sentry, description = stacktrace + lien, priorité = Urgent si > 1000 événements sinon élevé, étiquette = from-sentry.✓ Copié

→ N problèmes créés avec des liens renvoyés

Résultat : Une prise de bogues linéaire propre qui ne laisse jamais tomber une erreur de production sur le sol.

Pièges

Le même numéro de Sentry est déposé deux fois car les titres dérivent légèrement — Utilisez l'identifiant court du problème Sentry (par exemple WEB-3a91) dans le titre linéaire et déduisez cette sous-chaîne

Combiner avec : sentry

Pousser les problèmes obsolètes dans le cycle actuel

👤 Responsables techniques, scrum masters ⏱ ~5 min beginner

Quand l'utiliser : Contrôle à mi-cycle. Les problèmes attribués depuis plus de 5 jours sans changement d’état sont généralement bloqués.

Déroulement

Trouvez les problèmes obsolètes

Répertoriez les problèmes du cycle ENG actuel qui sont en « En cours » depuis plus de 5 jours sans changement d'état ni commentaire.✓ Copié

→ Liste avec le destinataire et les jours périmés
Postez un petit commentaire de coup de pouce

Ajoutez un commentaire sur chacun : « Enregistrement rapide – toujours sur la bonne voie pour ce cycle, ou avez-vous besoin de décomposer cela/d'obtenir de l'aide ? » Identifiez le destinataire.✓ Copié

→ Commentaires postés, liens renvoyés
Escalader si ignoré

Dans 48 heures, réexécutez. Si toujours pas de mise à jour, envoyez-moi une liste pour un suivi 1:1.✓ Copié

→ Liste d'escalade pour le suivi humain

Résultat : Travail débloqué sans être le manager harcelant au quotidien.

Pièges

Commentez le spam si vous exécutez ceci toutes les heures — Vérifiez si l'agent a déjà commenté au cours des 3 derniers jours avant de poster à nouveau

Échafauder un projet linéaire à partir d'une spécification Notion

👤 PM et responsables techniques lancent une nouvelle initiative ⏱ ~20 min intermediate

Quand l'utiliser : Vous disposez d'un PRD écrit et devez le diviser en problèmes traçables.

Prérequis

Notion MCP installée — Voir le guide des notions
L'URL de la page PRD — Copier depuis Notion

Déroulement

Lire et résumer la spécification

Lisez le Notion PRD sur <URL> et répertoriez chaque livrable discret sous la forme d'une description sur une seule ligne.✓ Copié

→ 15 à 40 sujets candidats
Réviser et affiner

Regroupez-les en 3 à 5 étapes. Signalez tous ceux qui nécessitent un travail de conception, d’API ou de base de données comme des problèmes distincts.✓ Copié

→ Arbre à problèmes structuré
Créer le projet et les problèmes linéaires

Créez un projet linéaire nommé « <Spec title> » dans l'équipe ENG. Créez chaque jalon en tant que problème parent, avec les enfants comme sous-problèmes. Lien vers la page Notion dans chaque description.✓ Copié

→ URL du projet + nombre de problèmes

Résultat : Un projet linéaire entièrement échafaudé en 20 minutes au lieu de 2 heures de rédaction manuelle de tickets.

Pièges

L'agent crée 80 problèmes alors que vous en vouliez 20 – trop granulaire — À l'étape 2, limitez explicitement : « pas plus de 20 problèmes au total, fusionnez tout ce qui est inférieur à une journée de travail »

Combiner avec : notion

Combinaisons

Associez-le à d'autres MCPs pour un effet X10

linear + sentry

Transformez automatiquement les pics d’erreurs de production en bugs linéaires suivis

Trouvez les nouveaux numéros Sentry web-prod des dernières 24 heures avec plus de 50 événements. Pour chacun, créez un bug linéaire dans l'équipe ENG intitulé « from-sentry », priorité élevée, avec la trace de pile dans la description.✓ Copié

linear + github

Lier automatiquement les PR aux problèmes linéaires et clôturer les problèmes lorsque les PR fusionnent

Pour chaque PR ouvert dans mon dépôt, recherchez l'ID du problème linéaire dans le titre ou le nom de la branche et ajoutez un commentaire de référence sur le problème linéaire avec l'URL du PR.✓ Copié

linear + notion

Publier des résumés de cycle hebdomadaires dans une base de données Notion

Générez le statut du cycle ENG de cette semaine et créez une page dans la base de données Notion « Engineering Weekly » avec le rapport complet.✓ Copié

Outils

Ce que ce MCP expose

Outil	Entrées	Quand appeler	Coût
list_issues	team?, assignee?, state?, label?, cycle?, query?, limit?	Recherche principale : filtrer le flux	1 API call
get_issue	id	Récupérer le contexte complet pour un seul problème	1 API call
create_issue	teamId, title, description?, priority?, labelIds?, assigneeId?, projectId?	Déposer un nouveau problème	1 API call
update_issue	id, stateId?, priority?, assigneeId?, labelIds?, title?, description?	Modifier l'état, la priorité ou l'affectation	1 API call
create_comment	issueId, body	Publier un coup de pouce ou une note de statut sur un problème	1 API call
list_projects	teamId?	Découvrez les projets actifs en équipe	1 API call
list_cycles	teamId	Rechercher des cycles actifs ou récents pour une équipe	1 API call
list_teams		Découvrez les équipes dans l'espace de travail	1 API call

Coût et limites

Coût d'exécution

Quota d'API: 1 500 req/h pour les applications OAuth, 120 req/min en rafale — généreux pour tout flux de travail réel
Tokens par appel: 300 à 1 500 jetons par numéro en fonction de la description/des commentaires
Monétaire: Gratuit – Le MCP linéaire est inclus dans tout forfait linéaire
Astuce: Utilisez list_issues avec des filtres spécifiques au lieu de tout extraire puis filtrer - réduit le coût des jetons par 10 sur les gros arriérés

Sécurité

Permissions, secrets, portée

Portées minimales : read write issues:create

Stockage des identifiants : OAuth via mcp-remote — jetons stockés dans ~/.mcp-auth/, actualisables sans vous reconnecter

Sortie de données : Tous les appels vers api.linear.app et mcp.linear.app

Ne jamais accorder : admin

Dépannage

Erreurs courantes et correctifs

OAuth browser popup doesn't open

Exécutez npx -y mcp-remote https://mcp.linear.app/sse manuellement une fois — cela imprimera une URL que vous pourrez coller dans un navigateur

Vérifier : After auth, re-run your agent; token cached in ~/.mcp-auth/

403 on update_issue

Votre rôle linéaire ne dispose pas d'un accès en écriture à cette équipe. Demandez à un administrateur d’espace de travail de vous promouvoir ou d’étendre l’agent à une équipe que vous possédez.

Issues returned but comments are missing

Les commentaires sont une requête distincte — utilisez « get_issue » avec include-comments, ou répertoriez les commentaires séparément avec l'ID du problème.

Can't find an issue you know exists

Vérifiez le filtre d'équipe : les problèmes des autres équipes ne sont renvoyés que si vous transmettez team=null ou spécifiez cette équipe.

Alternatives

Linear vs autres

Alternative	Quand l'utiliser	Compromis
Jira MCP	Votre organisation est sur Jira, pas Linear	API plus lourde, plus d'états/champs sur lesquels raisonner — les agents font moins bien sur Jira dès le départ
GitHub Issues (via GitHub MCP)	Vous voulez des problèmes étroitement liés au code sans outil séparé	Perdre des cycles, des projets et des états de flux de travail – GitHub Issues est plus simple mais moins structuré

Plus

Ressources

📖 Lire le README officiel sur GitHub

🐙 Voir les issues ouvertes

🔍 Parcourir les 400+ serveurs MCP et Skills