Connectez Claude Code à Jira et Confluence avec une seule commande claude mcp add. Découvrez le point d’accès v2, le choix des portées, la connexion OAuth, les en-têtes de jeton API, les premiers prompts, un fichier .mcp.json pour l’équipe et un tableau de dépannage pour les erreurs que vous rencontrerez vraiment.
Votre backlog Jira ne diminue jamais, et personne ne retrouve quoi que ce soit dans Confluence. Claude peut lire et écrire dans les deux, et répondre à vos questions à leur sujet, sans que vous ayez à coller un seul ticket dans une fenêtre de discussion. Tout le lien tient en une ligne de terminal : claude mcp add --transport http atlassian https://mcp.atlassian.com/v2/mcp. Lancez-la, connectez-vous une fois dans votre navigateur, et Claude Code peut rechercher dans Jira avec JQL, créer des tickets, et lire ou modifier des pages Confluence, le tout avec vos propres permissions.
Ce guide suit claude mcp add atlassian dans l’ordre où vous en aurez besoin : ce que le serveur expose, ce qu’il faut vérifier d’abord, la commande exacte, les trois portées, la connexion OAuth, une première série de prompts, l’option jeton API pour l’automatisation, le partage en équipe et un tableau de dépannage. Chaque commande et chaque point d’accès ci-dessous proviennent de la documentation actuelle d’Atlassian et de Claude Code, vérifiée en octobre 2026.
MCP (Model Context Protocol) est le standard ouvert qui permet à un client d’IA d’appeler des outils externes. Atlassian héberge son propre serveur distant, le Atlassian Rovo MCP Server, donc vous n’installez rien en local. Claude Code se connecte à une URL, et Atlassian gère l’authentification, les permissions et les appels à Jira et Confluence en coulisses.
Un seul point d’accès dessert Jira, Jira Service Management, Confluence, Bitbucket, Projects, Goals et les enregistrements Loom. Cet article se limite à Jira et Confluence, le duo que la plupart des équipes connectent en premier. La connexion utilise OAuth 2.1, et chaque action respecte vos contrôles d’accès existants. Claude voit exactement ce que voit votre compte, rien de plus.
Vous ne tapez jamais les noms des outils. Vous rédigez une demande simple, et Claude choisit l’outil correspondant. Il reste utile de connaître le menu pour formuler de meilleurs prompts :
| Produit | Lecture | Écriture | Recherche |
|---|---|---|---|
| Jira | getJiraIssue, listJiraProjects, listJiraBoards, listJiraIssueComments, listJiraIssueTransitions | createJiraIssue, editJiraIssue, transitionJiraIssue, addOrEditJiraIssueComment | searchJiraIssuesUsingJql |
| Confluence | getConfluenceContent, listConfluenceSpaces, listConfluenceContent, listConfluenceComments | createConfluenceContent, updateConfluenceContent, createConfluenceComment, addLabelsToConfluenceContent | searchConfluence (CQL) |
💡 Conseil : les outils en lecture seule sont sans risque pour un premier essai. Les outils d’écriture modifient de vrais tickets et de vraies pages, réservez-les donc pour après la réussite de la connexion.
La liste de contrôle est courte, mais sauter un seul point est la cause la plus fréquente des blocages :
claude --version dans un terminal. S’il affiche une version, c’est bon.
Une fois ces cases cochées, toute la configuration prend quelques minutes.
Ouvrez n’importe quel terminal et lancez :
claude mcp add --transport http atlassian https://mcp.atlassian.com/v2/mcp
Chaque élément remplit une fonction précise :
claude mcp add enregistre un nouveau serveur MCP auprès de Claude Code.--transport http sélectionne le transport HTTP en flux continu (streamable HTTP) qu’utilisent les serveurs distants.atlassian est le nom local. C’est ce que vous verrez dans /mcp et dans claude mcp list.https://mcp.atlassian.com/v2/mcp est le point d’accès v2 d’Atlassian.💡 Conseil : d’anciens articles affichent une adresse v1. La documentation actuelle d’Atlassian pointe vers la v2 : copiez donc l’URL ci-dessus plutôt qu’une vieille réponse de forum.
Par défaut, la commande enregistre le serveur dans la portée locale. Vous pouvez choisir où il est enregistré avec --scope :
| Portée | Option | Chargé dans | Partagé avec l’équipe | Stocké dans |
|---|---|---|---|---|
| Locale (par défaut) | --scope local | Projet courant uniquement | Non | ~/.claude.json |
| Projet | --scope project | Projet courant uniquement | Oui, via le contrôle de version | .mcp.json à la racine du projet |
| Utilisateur | --scope user | Tous vos projets | Non | ~/.claude.json |
Pour un usage personnel dans tous les dépôts, la portée utilisateur est le choix pratique :
claude mcp add --transport http atlassian --scope user https://mcp.atlassian.com/v2/mcp
La portée projet fonctionne aussi ici, car l’URL ne contient aucun secret. Chaque coéquipier se connecte tout de même avec son propre compte Atlassian.
Ajouter le serveur ne vous connecte pas. Terminez avec ces étapes :
/mcp.claude mcp list.Vous préférez rester dans le terminal ? Lancez claude mcp login atlassian. Sur une machine sans interface, claude mcp login atlassian --no-browser affiche une URL au lieu d’ouvrir un navigateur. Pour voir les détails d’un seul serveur, utilisez claude mcp get atlassian. La colonne d’état vous indique où vous en êtes :
| Statut | Signification |
|---|---|
| ✔ Connecté | Le serveur est actif et prêt |
| ! Authentification requise | La connexion OAuth est encore en attente |
| ✘ Échec de la connexion | Erreur de connexion, généralement un problème d’URL ou de réseau |
Commencez par des lectures. Un bon premier test vérifie que la connexion fonctionne et montre à Claude comment votre instance est organisée.
Demandez en langage courant, ou collez directement du JQL :
« Listez les tickets non résolus du projet PAY mis à jour cette semaine, classés par priorité, et résumez les cinq premiers. »
Claude appelle searchJiraIssuesUsingJql. Si vous voulez un contrôle total, fournissez-lui vous-même la requête :
project = PAY AND status != Done AND assignee = currentUser() ORDER BY priority DESC
Quand un nom est ambigu, demandez à Claude d’exécuter lookupJiraAccountId pour un coéquipier avant de filtrer par personne assignée. Cet outil convertit un nom affiché ou une adresse e-mail en identifiant de compte, dont JQL a besoin.
Les écritures fonctionnent de la même façon, avec une habitude à adopter : demandez d’abord un brouillon.
« Rédigez un Bug pour le projet PAY intitulé “Le paiement échoue avec les cartes enregistrées” à partir de la trace d’erreur ci-dessus. Montrez-moi les champs. Ne créez rien tant que je ne vous ai pas dit de le faire. »
En coulisses, Claude consulte les types de tickets du projet et leurs champs obligatoires, puis appelle createJiraIssue une fois que vous avez approuvé. Faire avancer un ticket est tout aussi simple :
« Passez PAY-142 à En revue et ajoutez un commentaire renvoyant vers la pull request. »
Cette demande utilise transitionJiraIssue et addOrEditJiraIssueComment. Par défaut, Claude Code demande une approbation avant d’exécuter des outils MCP. Lisez donc chaque demande d’écriture avant de l’accepter.
💡 Conseil : indiquez le projet, le type de ticket et la priorité dans votre premier message. Les prompts qui contiennent ces détails demandent moins d’appels d’outils et moins de questions de suivi, ce qui limite aussi la consommation de crédits Rovo.
Confluence fonctionne avec la recherche CQL et les outils de page :
« Recherchez notre runbook de réponse aux incidents dans Confluence et résumez les étapes d’escalade. »
« Créez une page dans l’espace ENG intitulée “Checklist de mise en production” à partir des notes de ce fichier. »
« Ajoutez un commentaire en pied de page sur la page d’intégration pour demander si les étapes du VPN sont toujours valables. »
Les mises à jour de pages existantes peuvent remplacer tout le corps ou appliquer des modifications ciblées. Pour tout contenu sur lequel les gens s’appuient, demandez à Claude d’effectuer des modifications ciblées et de montrer le changement avant d’enregistrer.
OAuth convient au travail interactif quotidien. L’authentification par jeton API convient aux pipelines, aux bots et aux autres exécutions non interactives, où personne n’est là pour cliquer sur un écran de consentement. Elle est facultative, et un administrateur de l’organisation doit d’abord l’activer dans les paramètres du serveur Rovo MCP.
Atlassian accepte deux formats d’en-tête :
Authorization: Basic <base64(email:api_token)>Authorization: Bearer <credential>Générez la valeur Base64 d’un jeton personnel sur macOS ou Linux :
printf '%s' 'you@company.com:YOUR_API_TOKEN' | base64
Sous Linux, ajoutez -w 0 pour que la longue sortie reste sur une seule ligne. Sous Windows PowerShell :
[Convert]::ToBase64String([Text.Encoding]::UTF8.GetBytes("you@company.com:YOUR_API_TOKEN"))
Enregistrez ensuite le serveur sous un nom différent, afin qu’il puisse coexister avec votre entrée OAuth :
claude mcp add --transport http atlassian-ci https://mcp.atlassian.com/v2/mcp \
--header "Authorization: Basic BASE64_VALUE"
⚠️ Avertissement : traitez le jeton comme un mot de passe. Conservez-le en portée locale ou utilisateur, jamais dans un
.mcp.jsonversionné, et renouvelez-le lorsqu’une personne quitte l’équipe.
Atlassian indique que certains outils MCP peuvent ne pas être disponibles avec l’authentification par jeton, car les jetons portent des portées sélectionnables, plus étroites qu’une session OAuth complète. Voici ce compromis en un tableau :
| OAuth 2.1 | Jeton API | |
|---|---|---|
| Configuration | Connexion dans le navigateur via /mcp | Bascule d’administrateur plus un en-tête |
| Idéal pour | Travail interactif quotidien | Tâches CI, bots, automatisation |
| Identité | Votre utilisateur | Votre utilisateur, ou un compte de service |
| Disponibilité des outils | Ensemble complet | Certains outils peuvent manquer |
Pour donner à tout un dépôt la même connexion, ajoutez le serveur en portée projet ou écrivez le fichier à la main :
{
"mcpServers": {
"atlassian": {
"type": "http",
"url": "https://mcp.atlassian.com/v2/mcp"
}
}
}
Enregistrez-le sous le nom .mcp.json à la racine du projet, puis versionnez-le. Dans les sessions interactives, Claude Code demande à chaque coéquipier d’approuver les serveurs du projet avant de les utiliser. Dans les modes non interactifs comme claude -p, les serveurs du projet se chargent sans demande. Pour réinitialiser ces approbations, lancez claude mcp reset-project-choices.
L’avis d’Atlassian indique : « Le 1er mars 2027, toute utilisation existante de la v1 commencera automatiquement à exposer et à utiliser les outils v2. » Les clients qui ont mis en cache d’anciens identifiants devront peut-être vider leurs identifiants clientIds ou .well-known en cache. Si vous avez enregistré une adresse v1 il y a plusieurs mois, faites dès maintenant un remplacement propre :
claude mcp logout atlassian
claude mcp remove atlassian
claude mcp add --transport http atlassian https://mcp.atlassian.com/v2/mcp
Lancez ensuite /mcp et reconnectez-vous.
Deux habitudes gardent la configuration saine dans le temps :
La plupart des échecs entrent dans quelques schémas. Commencez par claude mcp list, puis repérez le symptôme qui correspond :
| Symptôme | Cause probable | Solution |
|---|---|---|
! Needs authentication | La connexion n’a pas abouti ou a expiré | Lancez /mcp ou claude mcp login atlassian |
✘ Failed to connect | Mauvaise URL, mauvais transport ou blocage réseau | Lancez claude mcp get atlassian et vérifiez que le type est http et que l’URL se termine par /v2/mcp |
| Le navigateur ne s’ouvre jamais | Session distante ou sans interface | Utilisez claude mcp login atlassian --no-browser |
| La connexion boucle après un changement de version | Données client en cache obsolètes | Lancez la séquence de déconnexion, suppression et ajout ci-dessus |
| Un outil attendu est absent | Portées du jeton plus étroites qu’OAuth | Élargissez les portées du jeton ou passez à OAuth |
| Les recherches ne renvoient rien pour un projet auquel vous avez accès | Décalage de nom | Demandez à Claude de lister les projets Jira qu’il voit, puis réutilisez le nom exact |
Quand rien d’autre ne fonctionne, supprimer puis rajouter le serveur prend une dizaine de secondes et écarte une mauvaise entrée locale. Après chaque modification, relancez claude mcp list avant d’accuser votre prompt. Une ligne verte ✔ Connecté indique que le problème se situe dans la demande, et non dans la connexion.
Connecter Claude à Atlassian règle la partie technique. Deux tâches restent autour : rédiger des textes de tickets lisibles, et donner aux pages Confluence un peu de poids visuel. PicassoIA aide sur les deux, comme outil séparé à côté de votre configuration Claude Code. Le lien MCP ci-dessus fonctionne dans Claude Code, tandis que les étapes ci-dessous se déroulent sur PicassoIA.
Claude Sonnet 5 transforme des notes brutes en brouillons de tickets propres avant même que vous ouvriez un terminal :
low ignore la réflexion approfondie et répond le plus vite. Passez à high ou max quand le problème touche plusieurs systèmes.Besoin d’un raisonnement plus lourd pour un compte rendu d’incident complexe ? Claude Opus 4.7 et Claude Fable 5 sont disponibles sur la même plateforme.
Un runbook avec une image d’en-tête claire est ouvert plus souvent qu’un mur de texte. P-Image, Flux 2 Pro, Seedream 5 Pro et GPT Image 2 transforment tous une phrase en photo utilisable comme bannière de page. Essayez un prompt tel que « un tableau blanc d’équipe ensoleillé avec des notes adhésives, faible profondeur de champ, grain de film naturel ».
La liste d’outils Atlassian inclut l’import de pièces jointes pour les tickets Jira, mais seulement le téléchargement pour Confluence : insérez donc l’image finale dans la page avec l’éditeur Confluence.
PicassoIA propose aussi sa propre connexion MCP pour la génération d’images et de vidéos, gérée depuis votre compte. Le principe est le même que celui que vous venez de configurer : connectez-vous une fois, puis demandez en langage courant.
Lancez la commande, connectez-vous et demandez à Claude votre première recherche JQL. Ensuite, ouvrez PicassoIA, choisissez un modèle et créez les brouillons de tickets et les images que votre équipe repousse sans cesse. Votre prochaine revue de sprint vous remerciera.
Choisissez votre langue
