Linear MCP en un coup d’œil
D’après la documentation MCP de Linear, son changelog et sa documentation d’API, vérifiés le 17 novembre 2026. Le serveur est développé par Linear et figure dans le Connectors Directory de Claude avec la mention Anthropic verified.
| Serveur MCP de Linear | |
|---|---|
| Endpoint (lecture et écriture) | https://mcp.linear.app/mcp |
| Endpoint en lecture seule | https://mcp.linear.app/mcp/readonly, qui « n’expose jamais que des outils de lecture » (« only ever exposes read tools ») ; listé dans le registre MCP depuis le 5 novembre 2026 |
| Transport | Streamable HTTP. Les clients sans prise en charge du MCP distant se connectent via le module npm mcp-remote |
| Authentification | OAuth 2.1 avec enregistrement dynamique de client (PKCE S256 uniquement), ou un jeton OAuth ou une clé d’API Linear dans un en-tête Authorization: Bearer <yourtoken>. Authentification gérée par Okta pour l’entreprise sur Enterprise, et connexion automatique de Claude (bêta) sur Business ou Enterprise |
| Ancien endpoint SSE | https://mcp.linear.app/sse est obsolète. Le 5 février 2026, Linear a annoncé « supprimer complètement la prise en charge de SSE » (« fully removing SSE support ») ; le 17 novembre 2026, une requête non authentifiée vers cet endpoint a renvoyé 404. Utilisez /mcp pour toute nouvelle configuration |
| Forfait Linear | La page MCP de Linear n’indique aucun forfait requis pour le serveur ; sa page de tarifs liste « MCP server » parmi les intégrations, et l’accès à l’API est inclus dans tous les forfaits |
| Limites de débit | Linear n’en indique aucune pour MCP. Ses limites générales d’API sont de 2 500 requêtes par heure et par utilisateur avec une clé d’API, et de 600 par heure et par IP sans authentification ; les requêtes de jeton OAuth sont aussi limitées (429 avec Retry-After) |
| Lancement | 1er mai 2025 |
Connecter votre client IA au serveur MCP de Linear
Une étape par client ; suivez celle du vôtre. Chaque extrait est copié de la documentation de Linear ou de sa page d’intégration, ou de la documentation du client quand elles diffèrent. Pour un accès en lecture seule, remplacez https://mcp.linear.app/mcp par https://mcp.linear.app/mcp/readonly là où un extrait l’utilise.
Claude Code
Lancez la commande dans votre terminal, puis exécutez
/mcpdans une session Claude Code pour passer par la connexion à Linear. Ajoutez--scope userpour utiliser Linear dans tous vos projets, ou--scope projectpour le partager via.mcp.json. Pour sauter la connexion, passez un jeton avec--header "Authorization: Bearer your-token". Linear connecté sur claude.ai apparaît aussi dans Claude Code quand vous êtes connecté avec un abonnement claude.ai, et le plugin officiellinear@claude-plugins-officialutilise le même endpoint. Plus de détails dans Claude Code + Linear.# Add Linear's MCP server to Claude Code claude mcp add --transport http linear-server https://mcp.linear.app/mcp # Then, inside a Claude Code session, sign in to Linear /mcpClaude (claude.ai, bureau et mobile)
Le connecteur de Linear se trouve dans le Connectors Directory de Claude. La procédure d’Anthropic figure ci-dessous. La documentation de Linear la répartit par forfait (Team et Enterprise sur claude.ai, Free et Pro dans Claude Desktop sous Settings > Connectors), alors que la documentation de Claude indique que les connecteurs fonctionnent sur tous les forfaits, sur le web, le bureau et le mobile. Sur Team et Enterprise, les administrateurs peuvent aussi configurer la connexion automatique (bêta) pour que les membres dont l’adresse e-mail correspond sautent la connexion à Linear.
Customize > Connectors > Discover > search "Linear" > Connect to Claude In a chat: + > Connectors > turn Linear onCursor
La documentation de Linear l’installe avec un deeplink Cursor (sa config est
{"url":"https://mcp.linear.app/mcp"}) ou en cherchant Linear sur la page des outils MCP de Cursor ; l’installation OAuth en un clic est arrivée avec Cursor 1.0. La page Cursor de Linear donne aussi la config manuelle avecmcp-remote. La documentation de Cursor place les serveurs distants dans~/.cursor/mcp.json(global) ou.cursor/mcp.json(projet), avec un champurl. Plus de détails dans Cursor + Linear.# One-click install (opens Cursor) cursor://anysphere.cursor-deeplink/mcp/install?name=Linear&config=eyJ1cmwiOiJodHRwczovL21jcC5saW5lYXIuYXBwL21jcCJ9 # Manual: CTRL/CMD Shift J → MCP → Add new global MCP server {"mcpServers": {"linear": {"command": "npx", "args": ["-y", "mcp-remote", "https://mcp.linear.app/mcp"]}}}VS Code
C’est la méthode de Linear : ajoutez un serveur stdio qui exécute
mcp-remote, nommez-le **Linear**, puis **MCP: List Servers** → Linear → **Start Server**. La documentation de VS Code ajoute les serveurs distants directement : **MCP: Add Server** → **HTTP (HTTP or Server-Sent Events)** → saisissez l’endpoint → choisissez Global ou un.mcp.jsond’espace de travail. Un serveur Global est partagé avec Copilot CLI. Plus de détails dans GitHub Copilot + Linear.# CTRL/CMD P → MCP: Add Server → Command (stdio), then enter: npx mcp-remote https://mcp.linear.app/mcp # Or, as JSON (Linear's docs): {"mcpServers": {"linear": {"command": "npx", "args": ["-y", "mcp-remote", "https://mcp.linear.app/mcp"]}}}Codex (CLI et extension d’IDE)
codex mcp addvous invite à vous connecter. Les pages officielles ne sont pas d’accord sur un indicateur de fonctionnalité : la documentation de Linear ajouteexperimental_use_rmcp_client = truesous[features]dans~/.codex/config.toml, la page Codex de Linear indiquermcp_client = true, et la documentation MCP actuelle d’OpenAI n’utilise aucun indicateur. L’extrait ci-dessous suit la forme d’OpenAI ; si votre version de Codex réclame un indicateur, consultez les deux pages. La config est partagée par Codex CLI, l’extension d’IDE et l’application de bureau ChatGPT. Linear précise que seules les tâches Codex locales (CLI ou extension d’IDE) peuvent utiliser le serveur. Plus de détails dans Codex + Linear.# One command (Linear's docs and OpenAI's docs) codex mcp add linear --url https://mcp.linear.app/mcp # Or by hand in ~/.codex/config.toml (OpenAI's docs) [mcp_servers.linear] url = "https://mcp.linear.app/mcp" # then sign in (add --no-browser on a headless machine) codex mcp login linearWindsurf
La page Windsurf de Linear indique de sélectionner l’icône des plugins de Cascade et d’y installer le serveur MCP de Linear, ou de l’ajouter à la main comme ci-dessous. L’URL de la documentation MCP de Windsurf redirige désormais vers la documentation de Devin Local, qui range les serveurs dans
~/.config/devin/mcp_config.jsonou.devin/mcp_config.jsonet prend en charge Streamable HTTP avec OAuth ; les menus peuvent donc différer de la description de Linear.# CTRL/CMD , → Cascade → MCP servers → Add Server → Add custom server {"mcpServers": {"linear": {"command": "npx", "args": ["-y", "mcp-remote", "https://mcp.linear.app/mcp"]}}}Zed
Linear documente deux formes : la page de sa documentation utilise la première, sa page d’intégration Zed la seconde. La documentation de Zed prend aussi en charge les serveurs distants par URL (Settings → AI → MCP Servers → Add Remote Server) avec le flux OAuth de MCP, mais Linear ne documente pas cette forme, et la documentation de Zed ne mentionne pas
"source": "custom". Commencez par la forme de la page de documentation, et consultez la documentation MCP de Zed si votre version la rejette.// Linear's docs: CMD , then add to settings {"context_servers": {"linear": {"source": "custom", "command": "npx", "args": ["-y", "mcp-remote", "https://mcp.linear.app/mcp"], "env": {}}}} // Linear's Zed integration page shows an older shape: {"context_servers": {"linear": {"command": {"path": "npx", "args": ["-y", "mcp-remote", "https://mcp.linear.app/mcp"], "env": {}}, "settings": {}}}}ChatGPT (connecteur de recherche approfondie)
La page ChatGPT de Linear ne couvre qu’un connecteur pour la recherche approfondie (deep research) : connectez Linear dans les paramètres de connecteurs de ChatGPT, puis ajoutez Linear comme source dans deep research. Il est disponible pour les utilisateurs Plus et Pro (hors EEE, Suisse et Royaume-Uni) et pour les utilisateurs Team, Enterprise et Edu. Linear ne documente pas l’ajout de son URL MCP dans le mode développeur de ChatGPT. OpenAI liste Linear comme plugin ChatGPT, et l’application de bureau ChatGPT utilise le serveur MCP via la config Codex ci-dessus. Plus de détails dans ChatGPT + Linear.
ChatGPT connector settings > connect Linear Deep research > add Linear as a sourceLes autres, via mcp-remote
Pour tout client qui lance une commande MCP locale mais ne prend pas en charge le MCP distant, Linear donne ces valeurs. Linear documente aussi fx (
/mcp add linear https://mcp.linear.app/mcp, puis/mcp login linear) et v0 de Vercel (installation depuis sa page de connexions MCP).Command: npx Arguments: -y mcp-remote https://mcp.linear.app/mcp Environment: None
Ce que vous pouvez faire avec
La documentation de Linear décrit les outils comme servant à « trouver, créer et mettre à jour des objets dans Linear, comme des tickets, des projets et des commentaires » (« finding, creating, and updating objects in Linear like issues, projects, and comments »), mais ne les liste pas par nom. Les noms ci-dessous viennent du répertoire de connecteurs d’Anthropic (22 outils) et du changelog de Linear. La liste du répertoire précède les ajouts de Linear de février 2026 : votre client peut donc en afficher davantage.
- Tickets :
list_issues,list_my_issues,get_issue,create_issue,update_issue,list_issue_statuses,get_issue_status,list_issue_labels. Depuis le 5 novembre 2026,list_issuespeut filtrer par date de clôture aveccompletedAt(une date ISO-8601 ou une durée comme-P7D). À essayer : « Liste mes tickets Linear ouverts dans l’équipe Backend » ou « Crée un ticket pour ce bug et assigne-le-moi ». - Commentaires :
list_comments,create_comment. À essayer : « Résume les commentaires sur ENG-123 et ajoute un commentaire avec le correctif ». - Projets :
list_projects,get_project,create_project,update_project. À essayer : « Crée un projet pour la refonte de la facturation et ajoute-y ces trois tickets ». - Équipes, utilisateurs et cycles :
list_teams,get_team(avec la visibilité de chaque équipe etretiredAtdepuis le 14 septembre 2026),list_users,get_user,list_cycles. Depuis le 22 octobre 2026, on peut assigner des personnes avec une partie de leur nom. À essayer : « Quels tickets du cycle en cours ne sont pas assignés ? » - Documents et aide :
list_documents,get_document,search_documentation(la documentation de Linear). À essayer : « Trouve notre spec d’onboarding dans Linear et résume-la ». - Clients :
list_customer_needs(depuis le 8 octobre 2026) renvoie les demandes des clients pour un ticket, un projet ou une initiative ; on peut rechercher des clients par domaine et par identifiants externes depuis le 22 octobre 2026. À essayer : « Quels clients ont demandé le SSO ? » - Gestion de produit (depuis le 5 février 2026) : créer et modifier des initiatives, des mises à jour d’initiative, des jalons de projet et des mises à jour de projet, gérer les labels de projet, charger des images et charger des ressources Linear à partir de leurs URL. À essayer : « Rédige la mise à jour de cette semaine pour le projet Mobile v2 à partir des tickets clos ».
- Depuis le 5 novembre 2026, le serveur envoie aux clients des instructions par défaut sur la façon d’utiliser ses outils.
Accès en lecture seule
Linear documente trois façons d’empêcher un client IA de modifier quoi que ce soit :
- Utilisez l’endpoint en lecture seule
https://mcp.linear.app/mcp/readonly, qui n’expose jamais que des outils de lecture. - Utilisez
https://mcp.linear.app/mcpen n’accordant que le scope OAuthread: le jeton ne peut alors pas accéder aux API d’écriture. - Passez dans l’en-tête
Authorization: Bearerune clé d’API Linear qui n’a que la permission Read.
Dépannage
- La connexion échoue ou demande plusieurs essais : Linear indique que les connexions MCP distantes « en sont encore à leurs débuts » (« are still early »). Redémarrez votre client, ou désactivez puis réactivez le serveur Linear dans ses paramètres MCP. Se déconnecter puis se reconnecter n’affecte ni vos données Linear ni votre connexion.
- Erreur interne du serveur à la connexion : lancez
rm -rf ~/.mcp-auth, puis reconnectez-vous. Il se peut qu’il vous faille une version de Node plus récente. - Mauvais espace de travail : se reconnecter ne change pas d’espace de travail au sein d’une connexion existante. Donnez à chaque espace de travail son propre dossier d’authentification, par exemple
MCP_REMOTE_CONFIG_DIR=~/.mcp-auth/workspace-a npx mcp-remote https://mcp.linear.app/mcpetMCP_REMOTE_CONFIG_DIR=~/.mcp-auth/workspace-b npx mcp-remote https://mcp.linear.app/mcp. - Ancienne config avec
/sse: changez l’URL enhttps://mcp.linear.app/mcp. Linear a annoncé la suppression de la prise en charge de SSE le 5 février 2026. - WSL sous Windows : la documentation de Linear donne toujours une solution de contournement SSE,
{"mcpServers": {"linear": {"command": "wsl","args": ["npx","-y","mcp-remote","https://mcp.linear.app/sse","--transport sse-only"]}}}, qui utilise l’endpoint que Linear est en train de supprimer. Attendez-vous à ce qu’elle échoue, et consultez la documentation de Linear pour une mise à jour. - Les tâches cloud de Codex ne voient pas Linear : Linear précise que seules les tâches Codex locales (CLI ou extension d’IDE) peuvent utiliser le serveur MCP.
- Le client ne prend pas en charge le MCP distant : utilisez
mcp-remotecomme dans l’étape « Les autres ».
Chronologie
- 1er mai 2025 : Linear lance son serveur MCP à l’adresse
https://mcp.linear.app/sse, en natif dans Claude et viamcp-remotedans Cursor, Windsurf, VS Code et Zed. - 5 juin 2025 : installation OAuth en un clic dans Cursor 1.0, et un connecteur Linear pour la recherche approfondie de ChatGPT.
- 5 février 2026 : initiatives, mises à jour d’initiative, jalons de projet, mises à jour de projet, labels de projet, images et URL de ressources ; consommation de tokens réduite ; suppression de SSE annoncée au profit de
/mcp. - 13 août 2026 : connexion gérée par Okta pour l’entreprise, pour les espaces de travail Enterprise avec Okta SAML.
- 14 septembre 2026 :
list_teamsetget_teamrenvoient la visibilité de l’équipe etretiredAt. - 8 octobre 2026 : outil
list_customer_needs; PKCE doit utiliser une méthode S256 explicite. - 22 octobre 2026 : assignation d’utilisateurs par nom partiel, recherche de clients par domaine et par identifiants externes, et les sous-tickets créés via MCP reçoivent désormais le projet du ticket parent.
- 5 novembre 2026 : instructions par défaut pour les clients, filtre
completedAtsurlist_issues, et endpoint en lecture seule dans le registre MCP. - 12 novembre 2026 : les modifications de descriptions et de documents faites avec des clés d’API et des jetons d’application conservent la mise en forme du contenu inchangé.
Linear avec chaque agent IA
Certains agents ont aussi leur propre intégration Linear en plus du serveur MCP. Chaque page couvre toutes les façons dont cet agent travaille avec Linear.
Un tableau où les agents IA sont les assignés
Linear est conçu pour des personnes, avec des agents ajoutés comme délégués. Crewmark est un gestionnaire de tickets conçu pour une équipe d’employés IA. Chaque employé est une conversation Claude Code ou Codex sur votre propre ordinateur, avec un rôle, des KPI et des projets ; d’autres agents, comme OpenCode et DeepSeek Harness, se connectent via l’Agent Client Protocol. Assignez-lui un ticket et il se met au travail ; il se réveille au rythme d’une pulsation pendant ses horaires de travail, tient le statut à jour, commente et @mentionne d’autres employés, et passe le ticket en Needs action quand il a besoin de vous.
Crewmark ne se connecte pas à Linear. Si votre équipe garde Linear, un employé peut quand même utiliser le serveur MCP de Linear que vous avez configuré sur son ordinateur, comme n’importe quel autre outil. Crewmark est open source (GPL-3.0) et gratuit pour 1 projet avec jusqu’à 3 employés IA ; les agents tournent sur les forfaits que vous avez déjà.
| Serveur MCP de Linear | Crewmark | |
|---|---|---|
| Ce que c’est | Une connexion qui permet à un client IA de lire et de modifier Linear | Un gestionnaire de tickets où des employés IA ont la charge des tickets |
| Qui fait le travail | Vous, en donnant des instructions à votre client IA | Chaque employé IA, à chaque pulsation pendant ses horaires de travail |
| Où tourne l’agent | Dans votre client IA | Sur votre propre ordinateur, dans votre configuration Claude Code ou Codex habituelle |
| Quand il a besoin de vous | Il attend votre prochaine instruction | Il passe le ticket en Needs action et vous pose la question sur place |
FAQ : Linear MCP
Qu’est-ce que le serveur MCP de Linear ?
Le serveur MCP distant officiel et hébergé de Linear, à l’adresse https://mcp.linear.app/mcp. Il permet à des clients IA comme Claude, Cursor, Codex, VS Code, Windsurf et Zed de trouver, créer et mettre à jour des tickets, des projets, des commentaires et plus encore dans Linear. Linear l’a lancé le 1er mai 2025.
Le serveur MCP de Linear est-il gratuit ?
Linear n’indique ni forfait requis ni frais distincts : sa page de tarifs liste « MCP server » parmi les intégrations, et l’accès à l’API est inclus dans tous les forfaits Linear. Seuls certains extras dépendent du forfait : la connexion automatique de Claude demande Linear Business ou Enterprise, et la connexion gérée par Okta demande Enterprise. Le forfait de votre client IA s’applique toujours.
Comment ajouter Linear MCP à Claude Code ?
Lancez claude mcp add --transport http linear-server https://mcp.linear.app/mcp, puis exécutez /mcp dans une session Claude Code pour vous connecter à Linear. Si vous avez connecté Linear sur claude.ai et que vous vous connectez à Claude Code avec cet abonnement, le connecteur y apparaît aussi.
Linear MCP fonctionne-t-il avec Cursor ?
Oui. Installez-le depuis le deeplink Cursor de Linear ou depuis la page des outils MCP de Cursor avec l’OAuth en un clic, ou ajoutez {"mcpServers": {"linear": {"command": "npx", "args": ["-y", "mcp-remote", "https://mcp.linear.app/mcp"]}}} sous Add new global MCP server.
Peut-on utiliser Linear MCP en lecture seule ?
Oui. Utilisez https://mcp.linear.app/mcp/readonly, qui n’expose que des outils de lecture ; ou utilisez /mcp en n’accordant que le scope OAuth read ; ou passez une clé d’API Linear avec la seule permission Read comme jeton Bearer.
Pourquoi ma connexion à Linear MCP échoue-t-elle ?
Linear indique que les connexions MCP distantes en sont encore à leurs débuts et peuvent demander plusieurs tentatives : redémarrez le client ou désactivez puis réactivez le serveur. En cas d’erreur interne du serveur, lancez rm -rf ~/.mcp-auth, reconnectez-vous et mettez Node à jour. Si votre config pointe encore vers /sse, changez-la en https://mcp.linear.app/mcp ; Linear supprime la prise en charge de SSE.
Informations vérifiées le 17 novembre 2026 dans la documentation et le changelog de Linear et dans la documentation de chaque client.