Jira MCP

Qu'est-ce que Jira MCP ?

Une équipe utilise Jira pour suivre les tâches et les bugs d'un projet. Si vous n'avez jamais ouvert cet outil, imaginez un grand tableau partagé où chaque tâche a sa propre fiche : un titre, une description, une personne responsable, et un statut qui évolue au fil du travail (à faire, en cours, terminé).

Jira MCP est le serveur distant officiel publié par Atlassian, l'éditeur de Jira. Contrairement aux serveurs Google Calendar et Gmail vus dans ce catalogue, il ne demande pas de créer un projet Google Cloud séparé : il s'appuie directement sur votre compte Atlassian existant, ce qui rend sa mise en place nettement plus rapide.

Le vocabulaire Jira, avant d'aller plus loin

Un débutant ne doit jamais lire une phrase comme « fais transitionner WEB-123 » sans en comprendre chaque mot. Voici les termes qui reviendront tout au long de cette fiche.

Ce qu'il permet réellement

Selon la documentation officielle d'Atlassian, la partie Jira de ce serveur expose notamment ces outils, regroupés en trois familles :

• Lecture : retrouver un ticket par sa clé, lister les projets auxquels vous avez accès, consulter les statuts possibles pour un ticket, retrouver le compte d'une personne par son nom.
• Recherche : rechercher des tickets avec une requête JQL, le langage de recherche propre à Jira, présenté plus bas dans cette fiche.
• Écriture : créer un ticket, modifier ses champs, ajouter un commentaire, ajouter du temps passé, ou faire avancer un ticket d'un statut à un autre.

Les capacités d'écriture ne sont disponibles que si le groupe de permission correspondant (write_jira) a été accordé lors de la connexion, un point détaillé plus loin dans la section permissions.

Prérequis

• un compte Atlassian avec accès à un site Jira Cloud ;
• un navigateur pour l'autorisation OAuth ;
• Claude Code, ou un autre client MCP compatible avec un transport HTTP distant (Cursor et Gemini CLI sont notamment listés comme compatibles par Atlassian).

Connecter le serveur

Depuis un terminal, ajoutez le serveur distant à Claude Code.

claude mcp add --transport http atlassian https://mcp.atlassian.com/v1/mcp/authv2

Décryptage : --transport http indique un serveur distant, pas une commande locale. atlassian est le nom choisi pour le reconnaître. L'adresse est celle publiée officiellement par Atlassian pour ce serveur : ne la modifiez pas.

L'autorisation Atlassian

À la première utilisation, votre navigateur s'ouvre sur la page de connexion Atlassian. Connectez-vous avec le compte que vous utilisez déjà pour Jira, puis lisez l'écran de consentement qui liste les accès demandés avant de les accepter. Une fois autorisé, le jeton est conservé par Claude Code et renouvelé automatiquement : vous n'aurez pas besoin de repasser par cet écran à chaque session.

Si votre organisation Atlassian utilise des jetons API plutôt qu'OAuth pour ce type d'intégration, cette option existe aussi, mais elle demande une activation par un administrateur de votre site Atlassian : elle sort du cadre d'un premier usage personnel.

Premier test : retrouver un ticket

Vérifiez la connexion avec /mcp dans Claude Code, puis testez avec un ticket que vous connaissez déjà, en remplaçant la clé par une existante dans votre propre Jira.

"Retrouve le ticket WEB-12 et explique-moi en deux phrases ce qu'il reste à faire."

Ce que vous devriez voir

Un résumé fidèle au contenu réel du ticket : son titre, son statut actuel, et éventuellement la personne assignée. Comparez avec la fiche ouverte directement dans Jira, dans votre navigateur, pour confirmer que rien n'a été inventé.

Chercher plusieurs tickets avec JQL

JQL (Jira Query Language) est le langage de recherche propre à Jira, utilisé aussi bien dans l'interface web que par ce serveur. Vous n'avez pas besoin de l'écrire vous-même : décrivez votre besoin en langage naturel, et laissez l'IA construire la requête.

"Trouve tous les tickets ouverts du projet WEB assignés à moi."

En coulisse, l'IA traduit cette phrase en une requête du type project = WEB AND assignee = currentUser() AND status != Done, l'envoie au serveur, et vous présente le résultat sous une forme lisible.

Une action contrôlée : ajouter un commentaire

Si votre connexion inclut les permissions d'écriture, testez une action simple et facile à vérifier.

"Ajoute un commentaire de test sur le ticket WEB-12 indiquant que je vérifie l'intégration MCP."

Ouvrez ensuite ce ticket directement dans Jira pour confirmer que le commentaire apparaît bien, avec le bon texte. Vous pouvez le supprimer ou le modifier ensuite, comme n'importe quel commentaire que vous auriez écrit vous-même.

Permissions : read, write, search

Ce serveur organise ses droits en trois groupes distincts, accordés au moment de la connexion : la lecture, la recherche, et l'écriture. Si vous n'avez besoin que de retrouver et lire des tickets, il n'est pas nécessaire d'accorder le groupe d'écriture : vous limitez ainsi ce qu'une demande mal formulée pourrait modifier par erreur dans un projet partagé par toute une équipe.

Sécurité

Un ticket Jira n'est pas toujours anodin : il peut contenir des détails techniques sensibles, des informations sur un client, ou des discussions internes dans ses commentaires. Comme le serveur hérite exactement de vos propres droits d'accès, il ne peut pas voir plus que ce que vous voyez déjà vous-même dans Jira. La vigilance porte surtout sur l'écriture : un commentaire ajouté par erreur, ou une transition de statut appliquée au mauvais ticket, reste visible par toute l'équipe qui suit ce projet.

Limites

Ce serveur ne remplace pas une lecture attentive avant une action d'écriture sur un projet partagé : faire avancer le mauvais ticket, ou commenter au mauvais endroit, a un impact réel sur le travail d'une équipe. Certaines fonctionnalités avancées de Jira (automatisations complexes, tableaux de bord personnalisés) ne sont pas exposées par ce serveur, qui reste centré sur la lecture, la recherche et la mise à jour de tickets individuels.

Dépannage

Si l'écran d'autorisation Atlassian ne s'affiche pas, vérifiez que vous êtes bien connecté à un compte ayant accès à au moins un site Jira Cloud. Si une clé de ticket comme WEB-12 n'est pas retrouvée, vérifiez d'abord son orthographe exacte dans Jira : le code du projet est sensible à la casse. Si les actions d'écriture échouent alors que la lecture fonctionne, le groupe de permission write_jira n'a probablement pas été accordé lors de la connexion : relancez l'autorisation en l'acceptant cette fois.

À vous de jouer

Recherchez un autre ticket du même projet, cette fois en décrivant son sujet plutôt qu'en donnant sa clé exacte, par exemple : « trouve le ticket qui parle du formulaire de contact dans le projet WEB ». Comparez la précision du résultat à une recherche par clé.

Foire aux questions (FAQ)

Guides recommandés