Connecter Claude Code à Jira avec le serveur MCP d'Atlassian

Passer de son éditeur de code à Jira, ouvrir un onglet, chercher le bon board, copier-coller une spec dans un ticket, revenir au code. Ce va-et-vient répété gruge le temps et casse la concentration tout au long de la journée d'un développeur. Le serveur MCP officiel d'Atlassian permet de l'éviter en grande partie : une fois branché sur Claude Code, on lit et on crée des tickets Jira sans quitter le terminal.

Ce guide explique ce qu'est cette intégration, pourquoi elle est utile, et comment la mettre en place en quelques minutes.

Le contexte : c'est quoi MCP ?

MCP (Model Context Protocol) est un standard ouvert qui définit comment un assistant IA se connecte à des outils et des sources de données externes. Plutôt que chaque outil réinvente sa propre façon de parler à l'IA, MCP fournit une interface commune.
Un serveur MCP expose des capacités (lire des tickets, en créer, chercher dans une base de connaissances), et un client compatible comme Claude Code les consomme.

Atlassian fournit un serveur MCP officiel, hébergé de son côté, qui donne accès à Jira et Confluence. C'est ce serveur qu'on va connecter ici. Comme il est hébergé par Atlassian, il n'y a aucun process local à installer ni à maintenir : on déclare simplement l'adresse du serveur, on s'authentifie, et c'est prêt.

On prend Atlassian comme fil conducteur parce que c'est un cas répandu, mais la logique est exactement la même pour les autres outils qui exposent un serveur MCP.

Suivi de projet, gestion documentaire, service client, dépôts de code : dès qu'un outil fournit un MCP, on peut le brancher sur Claude Code selon le même principe. Seules l'adresse du serveur et la méthode d'authentification changent.
Ce qui suit vous servira donc de modèle bien au-delà de Jira.

Ce que ça change concrètement

Une fois connecté, Claude Code peut interroger et modifier Jira directement dans une session de travail. Quelques usages typiques :

• Transformer un fichier de specs en ticket sans recopier quoi que ce soit à la main.
• Générer une série de tickets à partir de notes de réunion ou d'un backlog en vrac.
• Récupérer le contexte d'un ticket pendant qu'on code, sans changer de fenêtre.
• Faire le lien entre une pull request et le ticket correspondant.
• Résumer les tickets ouverts sur un projet pour préparer un point d'équipe.

Le gain n'est pas seulement le temps économisé sur les clics, c'est surtout de garder le fil : le contexte du code et celui du suivi de projet vivent au même endroit.

Les bénéfices, côté pilotage du projet

Cette intégration n'intéresse pas que les développeurs. Pour un chef d'entreprise, un product owner ou un chef de projet, elle règle un problème très concret : la qualité et la régularité du suivi.

Tout le monde le sait sans oser trop le dire : les développeurs n'aiment pas rédiger des tickets. C'est une tâche administrative qui les éloigne du code, et le résultat s'en ressent. Les tickets sont souvent bâclés, incomplets, écrits à la va-vite. Il manque le contexte, les critères d'acceptation, les fichiers concernés, l'estimation. Résultat : des allers-retours pour clarifier, des malentendus, un backlog difficile à exploiter et un suivi qui reflète mal la réalité du travail.

Avec cette intégration, c'est l'IA qui rédige le ticket, à partir du travail réel du développeur : le code, les specs, la discussion en cours. Et elle le fait avec une précision que peu de gens prennent le temps d'atteindre à la main. Concrètement, cela apporte plusieurs choses.

• Des tickets mieux écrits et plus complets. L'IA structure l'information, reprend le contexte technique et formule des descriptions claires, sans que le développeur ait à s'y coller.
• Une traçabilité qui suit vraiment le travail. Comme le ticket est généré au moment où le travail se fait, le suivi reste à jour au lieu d'être rempli après coup, de mémoire et en vitesse.
• Moins de friction, donc plus de tickets créés. Quand créer un ticket ne coûte presque rien, on documente ce qui, autrement, serait resté dans la tête de quelqu'un.
• Un backlog exploitable pour le pilotage. Des tickets homogènes et bien renseignés donnent une vision fiable de l'avancement, plus facile à trier, prioriser et communiquer aux parties prenantes.
• Du temps de développeur rendu au développement. La partie administrative est prise en charge, l'équipe se concentre sur ce qu'elle sait faire de mieux.

En résumé, on ne demande plus aux développeurs de choisir entre coder et documenter proprement : les deux se font en même temps, et le suivi de projet gagne en fiabilité sans effort supplémentaire.

Un point important sur la portée et les permissions

Deux choses à avoir en tête avant de commencer.

1. La configuration se fait au niveau de votre poste. Elle est donc individuelle : chaque développeur qui veut utiliser l'intégration la met en place une fois sur sa machine. On ne configure pas ça au niveau du dépôt, et il n'y a rien à committer pour que ça marche.
2. L'authentification se fait avec votre propre compte Atlassian, via OAuth. Autrement dit, Claude Code ne peut ni voir ni créer plus que ce que votre compte autorise déjà. Vos permissions Jira restent la seule limite. Il n'y a pas de jeton partagé ni d'accès élargi.

Prérequis

• Claude Code installé et à jour (vérifiable avec claude --version).
• Un compte Atlassian Cloud avec accès à votre instance Jira.
• Un terminal. Le connecteur se déclare en dehors d'une session Claude Code déjà ouverte, via la commande claude mcp add.

Deux flags méritent une explication :

• --transport http indique que le serveur est distant, hébergé par Atlassian, et non un process qui tourne sur votre machine.
• --scope user rend la connexion disponible sur tous vos projets, pas seulement le dossier courant. C'est le bon choix ici : on veut éviter le scope project, qui écrirait la config dans le dépôt. Chaque développeur doit s'authentifier avec son propre compte, donc rien n'a vocation à être partagé via le repo.

Le serveur atlassian doit apparaître dans la liste. S'il n'y est pas, c'est que la commande de l'étape précédente n'est pas passée : relancez-la.

Étape 3 : s'authentifier via OAuth

Déclarer le serveur ne suffit pas, il faut encore lui donner accès à votre compte. Ouvrez une session Claude Code avec la commande claude, puis :

1. Tapez /mcp.
2. Sélectionnez atlassian.
3. Choisissez Authenticate.
   Une page de consentement OAuth Atlassian s'ouvre dans le navigateur. Connectez-vous avec votre compte Atlassian Cloud et approuvez l'accès.

Une fois l'accès approuvé, vous revenez dans Claude Code et l'intégration est active. À partir de là, Claude Code interroge et modifie Jira avec vos permissions.

Utilisation

Il n'y a pas de syntaxe particulière à retenir : on demande en langage naturel, dans une session. Par exemple :

• Crée un ticket Jira à partir du contenu de docs/tickets/mon-fichier.md
• Résume les tickets ouverts sur le projet FLEET assignés à moi

Claude Code se charge d'appeler les bons outils du serveur MCP et de vous rendre le résultat.

Le contenu de cet article a été, en partie, rédigé par l'IA. Le contenu a été vérifié et ajusté par un humain.