Linear MCP : connectez vos assistants IA à vos tickets

Serveur Linear MCP : URL et authentification

Utilisez https://mcp.linear.app/mcp avec Streamable HTTP, une connexion web au serveur hébergé. La configuration interactive repose sur OAuth 2.1 avec enregistrement dynamique du client, qui gère l’enregistrement du client et l’autorisation de l’utilisateur. Vous pouvez aussi transmettre un jeton OAuth ou une clé API Linear dans Authorization: Bearer <yourtoken>. Configurer Linear MCP

Voyez MCP comme un guichet commun. Votre assistant demande une opération précise, par exemple retrouver un ticket ou enregistrer une modification. Le serveur de Linear exécute cette opération si la connexion l’y autorise. Votre prompt exprime une intention ; il n’accorde aucun droit supplémentaire.

Ces options restreignent la connexion de différentes façons. Un prompt demandant « ne modifie rien » donne une consigne à l’assistant ; un endpoint ou des identifiants en lecture seule limitent ce qu’il peut réellement faire. Options d’accès de Linear

Comment connecter le client utilisé par votre équipe ?

Claude et Claude Code

Dans l’application web ou de bureau de Claude, ouvrez Settings → Connectors, puis connectez Linear. C’est le parcours indiqué sur la page d’intégration Claude de Linear.

Pour Claude Code :

1. Exécutez claude mcp add --transport http linear-server https://mcp.linear.app/mcp dans votre terminal.
2. Ouvrez une session Claude Code.
3. Lancez /mcp et suivez la procédure d’authentification jusqu’au bout.

La commande comme l’étape suivante proviennent du guide de configuration Claude de Linear.

Cursor

Le guide principal de Linear propose un lien d’installation et invite à retrouver Linear sur la page des outils MCP de Cursor. Utilisez le lien d’installation de la section Cursor du guide Linear.

La page dédiée à Cursor décrit aussi cette procédure manuelle :

1. Appuyez sur Ctrl/Cmd + Shift + J pour ouvrir les paramètres de Cursor.
2. Sélectionnez MCP.
3. Sélectionnez Add new global MCP server.
4. Ajoutez cette configuration :

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

Cette configuration utilise mcp-remote, une passerelle entre le client et le serveur hébergé. Elle est publiée sur la page d’intégration Cursor de Linear.

Codex CLI et extension pour IDE

Selon Linear, l’interface en ligne de commande et l’extension pour IDE partagent leur configuration MCP.

1. Exécutez codex mcp add linear --url https://mcp.linear.app/mcp.
2. Suivez l’invite de connexion à Linear décrite dans son guide de configuration.
3. Si vous optez pour la configuration manuelle, Linear indique de vous authentifier avec codex mcp login linear après avoir modifié ~/.codex/config.toml.

Avant de copier une configuration, attention à cette divergence entre les pages de documentation :

Sur la page dédiée, l’entrée manuelle du serveur est [mcp_servers.linear], avec url = "https://mcp.linear.app/mcp". Ces paramètres sont reproduits tels qu’ils sont publiés, mais les options contradictoires ne doivent pas être considérées comme un prérequis universel encore en vigueur. Intégration Codex de Linear, guide MCP principal

Utilisez la procédure d’ajout et de connexion ci-dessus. Le guide MCP actuel d’OpenAI décrit la configuration des serveurs HTTP et la commande codex mcp login <server-name> sans exiger l’une ou l’autre de ces options. Documentation MCP officielle d’OpenAI

ChatGPT

Suivez le parcours effectivement documenté par Linear :

1. Ouvrez les paramètres des connecteurs de ChatGPT à l’aide du lien figurant sur la page d’intégration ChatGPT de Linear.
2. Connectez Linear.
3. Dans la recherche approfondie, ajoutez Linear comme source.

Linear présente cette connexion comme un moyen de consulter les tickets, les projets et les discussions tout en respectant les droits existants de chaque utilisateur. La création et la modification de tickets par cette configuration ne sont pas documentées. Utilisez-la pour les recherches et les synthèses ; pour les exemples de modification ci-dessous, choisissez un client MCP dont les fonctions d’écriture sont documentées. Cette distinction concerne cette connexion précise, et ne vaut pas comme affirmation générale sur toutes les intégrations ChatGPT.

Quels outils Linear documente-t-il publiquement ?

La distinction utile se situe entre récupérer du contexte et enregistrer des modifications. Le tableau ci-dessous reprend les identifiants exacts de la liste des outils couramment utilisés publiée par Linear, avec leur rôle. Cette liste figure sur sa page d’intégration Slack, dans la section qui explique comment connecter ce même serveur Linear MCP à Slackbot. Liste des outils de Linear

Le journal des nouveautés de Linear cite aussi list_cycles, list_issue_labels, list_comments, save_project et save_document. Il documente les détails des cycles, la pagination des labels et des commentaires, les modifications de projets, ainsi que la création de documents ou leur rattachement à des initiatives ou à des cycles. Il s’agit d’un inventaire publié des outils pertinents, pas de l’affirmation que chaque client expose un catalogue identique et de taille fixe. Outils de cycles et de labels, outils de commentaires, outils de projets et de documents

D’anciens exemples peuvent appeler séparément create_issue et update_issue. Linear les a réunis dans save_issue. Gardez-le à l’esprit si vous reprenez d’anciens prompts ou développez une intégration qui s’appuie sur les noms d’outils. Évolution des outils de Linear

Quels accès sont accordés et que contrôle l’administrateur ?

Considérez cette connexion comme un accès autorisé aux données de l’espace de travail. Dans la terminologie OAuth de Linear, read signifie « accès en lecture au compte de l’utilisateur » et write, « accès en écriture au compte de l’utilisateur ». Par défaut, l’acteur utilisateur crée les ressources au nom de la personne qui a autorisé l’application. Autorisations OAuth de Linear

Pour les clés API, Linear parle d’un « accès complet aux données auxquelles votre utilisateur a accès », avec la possibilité de restreindre les autorisations et les équipes. Une clé restreinte offre donc un périmètre d’accès sensiblement différent de celui d’une clé personnelle dotée de droits étendus. Autorisations des clés API

Les contrôles disponibles dépendent du mode d’authentification de la connexion :

Linear explique que les approbations servent à contrôler « quelles applications peuvent accéder à l’espace de travail et à ses données ». Les membres peuvent demander une approbation pendant l’installation. Les contrôles des clés s’appliquent à l’authentification par clé API ; ils ne remplacent pas la gestion des connexions d’applications OAuth. Approbation des applications, administration de l’API

Pour les clients Anthropic compatibles, les espaces de travail Enterprise équipés d’Okta SAML peuvent utiliser une autorisation gérée par l’entreprise. Linear indique que celle-ci « applique leurs autorisations Linear existantes ». Les administrateurs gèrent les accès dans Okta, sans demander à chaque utilisateur une autorisation distincte pour chaque connexion. Autorisation gérée par l’entreprise

Pour un workflow limité aux points d’avancement, choisissez la lecture seule. Pour le triage et la création de tickets, accordez les droits d’écriture nécessaires et présentez les modifications proposées avant de les appliquer. Cette étape de validation est une recommandation de workflow ; elle ne signifie pas que tous les clients imposent le même mécanisme d’approbation.

Trois workflows à mettre en place

Commencez par les bilans de cycle, qui peuvent fonctionner sans écriture. Passez ensuite au triage si le traitement des demandes entrantes devient répétitif. La conversion de spécifications devient intéressante lorsqu’un responsable consacre du temps à transformer en tickets des décisions déjà prises.

Les cas ci-dessous sont des exemples fictifs détaillés. Ils illustrent des prompts et les livrables attendus, et ne présentent pas les résultats d’un test réalisé avec un compte connecté.

Préparer une proposition de triage à valider

Un responsable d’ingénierie peut demander à l’assistant d’examiner les nouveaux signalements, de retrouver des tickets existants similaires et de présenter l’ensemble des modifications proposées. L’intérêt : réduire les recherches répétitives et les modifications de propriétés, tout en laissant au responsable la décision sur les assignations et les priorités.

Exemple de données d’entrée : Un nouveau signalement, « Le bouton d’export se bloque », indique que le navigateur ne répond plus pendant un export filtré. Un ticket existant, « L’export filtré ne se termine jamais », concerne le même écran. Un autre signalement, « Les invitations n’arrivent jamais », ne contient ni journaux de livraison ni étapes de reproduction.

Prompt :

Une proposition utile :

Après examen, le responsable peut autoriser uniquement les changements de labels et d’assignation convenus via save_issue, sans toucher aux signalements ambigus. L’assistant doit renvoyer les liens des tickets concernés et un relevé des champs modifiés. Les opérations de récupération et d’enregistrement figurent dans la liste des outils de Linear.

Avant de développer un système de triage sur mesure, comparez-le à Triage Intelligence. Linear propose déjà des suggestions de propriétés et la détection de doublons ou de relations. Une orchestration MCP personnalisée se justifie davantage lorsque la décision exige du contexte ou des règles que le workflow natif ne couvre pas. Triage Intelligence

Transformer une spécification en tickets sans inventer d’exigences

Un fondateur peut partir d’un brief fonctionnel approuvé pour préparer des brouillons de tickets, puis créer dans Linear les tâches validées. Le gain tient à la cohérence : chaque ticket reprend l’exigence dont il découle, et les décisions manquantes restent visibles.

Exemple de spécification : « Les administrateurs de l’espace de travail peuvent inviter des membres par e-mail. Les destinataires acceptent l’invitation via un lien reçu par e-mail. Les administrateurs peuvent révoquer les invitations en attente. Les modifications de facturation et les invitations groupées sont hors périmètre. »

Prompt :

Découpage proposé :

Questions ouvertes : Que se passe-t-il si l’adresse e-mail appartient déjà à un membre ? Une invitation expire-t-elle ? Que doit voir le destinataire après une révocation ? Ces points restent ouverts tant que le responsable produit n’a pas tranché.

Après validation, l’assistant peut créer le ticket parent et les sous-tickets, renvoyer leurs URL et signaler tout élément qu’il n’a pas pu créer. La création de sous-tickets fait partie des capacités MCP documentées. Évolutions du MCP de Linear

L’assistant se charge de la transcription. Les décisions produit restent du ressort du responsable produit.

Rédiger un point hebdomadaire à partir du cycle

Un responsable peut transformer le travail du cycle en brouillon de point d’avancement, avec des liens à l’appui de chaque affirmation. L’intérêt est de passer plus vite de mises à jour dispersées entre les tickets à un compte rendu vérifiable.

Un rapport hebdomadaire et un bilan de cycle peuvent couvrir des périodes différentes. Précisez l’équipe, le cycle et la période du rapport, pour éviter que « terminé pendant ce cycle » ne devienne implicitement « terminé cette semaine ».

Exemple de données sources : Le ticket « E-mail d’invitation » est passé au statut Terminé pendant la période du rapport. « Accepter l’invitation » reste En cours. Un commentaire sur « Révoquer l’invitation » indique que l’implémentation attend une décision produit sur l’expérience à prévoir lorsqu’un lien a été révoqué.

Prompt :

Exemple de brouillon :

Dans un véritable brouillon, chaque phrase doit comporter l’URL du ticket correspondant. Cet exemple ne donne volontairement aucun pourcentage d’achèvement et n’affirme aucune livraison. La récupération des cycles, des tickets et des commentaires fournit les éléments nécessaires à ce workflow. Outils de cycles et de tickets, récupération des commentaires

D’autres usages une fois ces workflows stabilisés

La création de commentaires fait partie des capacités documentées du serveur, tandis que les outils de projets apportent le contexte nécessaire à une passation. Capacités du serveur, outils de projets

Rentabilité : comptez aussi le temps de vérification

Le poste de coût concerné est la coordination de l’équipe d’ingénierie. Sans MCP, un responsable cherche, copie, recoupe et rédige. Avec un assistant connecté, il doit toujours cadrer la demande, vérifier le résultat et corriger les erreurs.

Utilisez cette formule de rentabilité avec vos propres coûts :

Valeur nette = (temps de préparation manuelle − temps de préparation assistée, de vérification et de correction) × coût horaire chargé − coûts supplémentaires du client et d’exploitation.

Un compte rendu soigné qui prend plus de temps à vérifier n’a pas fait gagner de temps à l’équipe. Comparez les workflows à périmètre de rapport identique, en comptant aussi la remise en état après des modifications erronées. L’objectif utile est de réduire le travail de coordination nécessaire pour obtenir un résultat validé.

Pour choisir un abonnement, consultez les tarifs de Linear. Si vous hésitez encore sur l’outil de suivi, le comparatif Linear vs Jira traite ce choix. Notre guide des meilleurs serveurs MCP présente d’autres connexions complémentaires.

Quels services construire autour de cette connexion ?

Un service de préparation des bilans de cycle constitue la piste de départ la plus solide. Un responsable d’ingénierie pourrait payer pour un rapport cohérent qui respecte le périmètre des équipes, distingue le travail terminé du travail ouvert et cite les tickets qui étayent ses constats. La version minimale utile enregistrerait les paramètres d’un rapport, récupérerait les données pertinentes du cycle et produirait un brouillon modifiable. La planification, les nouvelles tentatives en cas d’échec et la diffusion relèveraient de votre application.

La difficulté tient à la différenciation : un prompt de synthèse générique se reproduit facilement. Le produit potentiel réside dans les règles de reporting de l’entreprise, la traçabilité des sources et le processus de validation. Vérifiez que ces points posent régulièrement problème aux équipes avant de créer un service autonome sur abonnement.

Une file de validation du triage sur mesure représente une opportunité plus ciblée. Un responsable d’équipe plateforme ou d’ingénierie support pourrait payer pour combiner le contexte des tickets Linear avec ses propres règles d’aiguillage et des données de support accessibles sous autorisation distincte. La version minimale afficherait les changements de champs proposés, les éléments qui les justifient et une action pour les approuver ou les ignorer, puis appliquerait les modifications acceptées.

La difficulté est ici la concurrence directe avec Triage Intelligence, intégré à Linear. Ne développez cette solution que si le contexte ou les règles supplémentaires changent une décision que le système natif ne sait pas traiter correctement pour l’équipe concernée. Ce sont des hypothèses produit, pas des résultats clients établis.

Quelles sont les limites de la connexion ?

MCP donne à l’assistant accès à des opérations ; il ne tranche pas les exigences ambiguës et ne rend pas fiables des données de tickets incomplètes. Un ticket marqué Terminé peut justifier une affirmation sur l’état de ce ticket. À lui seul, il ne prouve pas qu’un client a reçu la fonctionnalité.

De même, autoriser l’accès à Linear ne donne pas accès à tous les documents, dépôts ou systèmes de support mentionnés dans un ticket. Si votre solution a besoin de ces sources, prévoyez pour chacune les accès et les mécanismes de récupération nécessaires.

Pour les nouvelles configurations, utilisez /mcp. Linear présente /sse comme une solution de repli obsolète. L’ancien serveur communautaire jerhadf indique lui aussi explicitement qu’il est obsolète et n’est plus maintenu, et oriente les utilisateurs vers le serveur officiel de Linear. Recommandations actuelles sur les endpoints

Dès lundi, demandez au responsable d’ingénierie de définir l’équipe, le cycle et la période à couvrir pour préparer un brouillon de point d’avancement en lecture seule. Vérifiez ses affirmations à l’aide des tickets liés et comparez l’effort de préparation au processus actuel. Passez à l’écriture lorsque l’équipe dispose d’une routine de validation claire.

Pour adapter ces workflows aux règles de votre équipe, nous développons des automatisations IA.