Atlassian MCP Server

officiel

Serveur MCP officiel d'Atlassian pour connecter des agents IA à Jira, Confluence, Opsgenie et d'autres produits Atlassian.

Que pouvez-vous faire avec Atlassian MCP ?

  • Recherche dans les produits Atlassian — Demandez à votre assistant de trouver des tickets Jira, des pages Confluence, des dépôts Bitbucket ou des Projets sans changer d’outil.
  • Créer et mettre à jour des éléments de travail — Donnez pour instruction à votre assistant de créer des stories Jira, de mettre à jour des tickets ou de générer des pages Confluence à partir du langage naturel.
  • Résumer et récupérer du contenu — Faites résumer par votre assistant des pages Confluence, des enregistrements Loom ou des demandes Jira Service Management.
  • Automatiser les flux de travail répétitifs — Demandez à votre assistant de créer en masse des tickets Jira à partir de notes de réunion ou de lier des éléments de travail à la documentation associée.
  • Interroger l’état des projets et des objectifs — Obtenez des mises à jour en temps réel sur les Projets, les Objectifs ou les dépendances des composants Compass directement dans votre client IA.

Serveur MCP hébergé

npx add-mcp 'https://mcp.atlassian.com/v1/mcp/authv2'

S’installe dans Claude Code, Codex, Cursor et plus

Documentation

Atlassian

Atlassian MCP Server

Le serveur officiel Model Context Protocol (MCP) pour Atlassian : un pont hébergé dans le cloud qui offre à vos outils d'IA un accès sécurisé et en temps réel à Jira, Confluence, Jira Service Management, Bitbucket, Compass, Loom et à la plateforme Atlassian dans son ensemble — propulsé par votre Teamwork Graph.

Official Atlassian Server GitHub stars License: Apache 2.0 Status: Generally Available

Model Context Protocol compatible MCP Registry: com.atlassian Auth: OAuth 2.1 or API token Hosting: Atlassian Cloud

Jira Confluence Jira Service Management Bitbucket Loom Compass Rovo

Premiers pas · Outils pris en charge · Sécurité et administration · Communauté


Le serveur officiel Atlassian MCP Server est un pont basé sur le cloud entre votre site Atlassian Cloud et des outils externes compatibles. Une fois configuré, il permet à ces outils d'interagir en temps réel avec Jira, Confluence, Jira Service Management, Bitbucket, Compass, Loom et les données de la plateforme Atlassian (Projets, Objectifs, Équipes, Focus, Talent et Teamwork Graph). L'authentification utilise OAuth 2.1 ou des jetons API, de sorte que chaque action respecte les contrôles d'accès existants de l'utilisateur.

Avec le serveur Atlassian MCP Server, vous pouvez :

  • Résumer et rechercher dans Jira, Jira Service Management, Confluence, Bitbucket, Projets, Objectifs, etc., sans changer d'outil.
  • Récupérer et consulter les enregistrements de vidéos et de réunions de Loom.
  • Créer et mettre à jour des éléments de travail ou des pages à partir de commandes en langage naturel.
  • Automatiser les tâches répétitives, comme la génération d'éléments de travail à partir de notes de réunion ou de spécifications.

Connectez-vous une fois, puis décrivez ce que vous voulez — sans changer d'onglet et sans copier-coller. Votre IA sélectionne et exécute les bonnes actions.

Il est conçu pour les développeurs, les créateurs de contenu et les équipes de projet qui travaillent dans des IDE ou des outils d'IA et souhaitent utiliser les données Atlassian sans changer constamment de contexte.

[!IMPORTANT] v2 est désormais la version recommandée. Les nouvelles configurations doivent utiliser https://mcp.atlassian.com/v2/mcp, qui expose davantage d'outils et de produits. Les connexions v1 existantes commencent automatiquement à exposer et à utiliser les outils v2 ; les clients incompatibles peuvent devoir effacer les identifiants clients mis en cache ou les informations d'identification .well-known pour continuer à s'authentifier. Pour les étapes de configuration, consultez Premiers pas avec le serveur Atlassian MCP Server.

Configuration en un clic

Choisissez votre client IA ci-dessous pour installer le serveur officiel Atlassian MCP Server. Chaque bouton utilise le lien d'installation natif de votre client, vous n'avez donc pas besoin de modifier manuellement un fichier de configuration JSON.

Add to Cursor
Ajouter à Cursor

Référencez les problèmes et consignez le travail dans votre base de code.
Add to VS Code
Ajouter à VS Code

Recherchez et créez des problèmes Jira via GitHub Copilot.
Add to ChatGPT
Ajouter à ChatGPT

Recherchez, résumez et créez directement depuis ChatGPT.
Add to Claude
Ajouter à Claude

Intégrez Jira et Confluence dans les flux de travail Claude.

Laissez votre agent faire la configuration

La plupart des agents de codage IA peuvent installer, authentifier et configurer le serveur eux-mêmes. Copiez et collez cette invite dans votre agent :

Set up Atlassian MCP for this agent using the official setup guide at
https://support.atlassian.com/atlassian-rovo-mcp-server/docs/getting-started-with-the-atlassian-remote-mcp-server/
and the MCP server URL https://mcp.atlassian.com/v2/mcp. Then start the Atlassian MCP
authentication flow so I can sign in.

Ou ajoutez le serveur manuellement avec la commande propre à votre client :

ClientCommande ou configuration
Claude Codeclaude mcp add --transport http atlassian https://mcp.atlassian.com/v2/mcp, puis exécutez /mcp dans une session pour vous authentifier
Codexcodex mcp add atlassian --url https://mcp.atlassian.com/v2/mcp
Claude DesktopParamètres → Extensions → Parcourir les extensions → Plugins, puis recherchez Atlassian
Codex DesktopPlugins ou Connecteurs, puis installez Atlassian Rovo
VS Code / GitHub CopilotVue Extensions → recherchez @mcp Atlassian → Installer
CursorPlugin Atlassian pour Cursor avec MCP → Ajouter à Cursor
WindsurfCascade → Serveurs MCP → Ajouter un serveur → Ajouter un serveur personnalisé, avec serverUrl défini sur https://mcp.atlassian.com/v2/mcp
Tout autre client MCPUtilisez l'URL du serveur https://mcp.atlassian.com/v2/mcp

Contenu


Clients pris en charge

Le serveur Atlassian MCP Server fonctionne avec une liste croissante de clients compatibles MCP :

ClientRéférence de configuration
OpenAI ChatGPTGuide des connecteurs / MCP
OpenAI Codex (CLI et Desktop)Documentation MCP de Codex
Claude (Claude.ai, Desktop et Code)Documentation MCP de Claude
CursorAtlassian sur la place de marché Cursor
Visual Studio Code (GitHub Copilot)Documentation MCP de VS Code
GitHub Copilot CLIÀ propos de Copilot CLI
Google Gemini CLIDocumentation MCP de Gemini CLI
WindsurfDocumentation MCP de Windsurf
DockerCatalogue MCP et boîte à outils Docker
Kiro et autres clients Agent PluginsDocumentation Kiro Powers
Amazon Quick SuiteGuide d'intégration MCP

Le serveur Atlassian MCP Server prend également en charge tout client local compatible MCP pouvant s'exécuter sur localhost et se connecter au serveur via le proxy mcp-remote. Cela permet des intégrations personnalisées ou tierces conformes à la spécification MCP.

[!TIP] Pour la liste actuelle et canonique des clients pris en charge et la configuration étape par étape, consultez Premiers pas avec le serveur Atlassian MCP Server. Vous pouvez également vous référer à la documentation MCP de votre client ou à son assistant intégré.


Packaging des plugins et compatibilité

Ce référentiel publie le même serveur MCP et les mêmes compétences dans plusieurs formats de package afin que les clients puissent utiliser leurs flux de découverte et d'installation natifs :

FormatManifeste et configurationComposants partagés
Agent Plugins v1plugin.json et mcp.jsonskills/
Plugin Claude Code.claude-plugin/plugin.json et .claude-plugin/marketplace.json.mcp.json et skills/
Plugin Cursor.cursor-plugin/plugin.json.mcp.json et skills/
Extension Geminigemini-extension.jsonConfiguration du serveur MCP intégrée au manifeste
Registre MCPserver.jsonMétadonnées du serveur distant

Les compétences dans skills/ ciblent le point de terminaison /v2/mcp et sont ce que chaque plugin packagé installe. La génération précédente est archivée dans skills/v1/ pour ceux qui utilisent encore un point de terminaison v1 ; elle n'est installée par aucun plugin et est configurée manuellement. Consultez skills/README.md pour les différences.

mcp.json et .mcp.json sont tous deux intentionnels. Agent Plugins exige le nom de fichier racine mcp.json et son vocabulaire de transport portable ; les clients existants continuent d'utiliser .mcp.json et leur vocabulaire de configuration natif. Gardez leurs paramètres de point de terminaison alignés lors de la modification de l'un ou l'autre fichier.

Le package racine peut être importé par les clients qui implémentent Agent Plugins, y compris Kiro Powers. Les manifestes spécifiques aux clients restent disponibles et ne sont pas remplacés par le package portable.


Produits et outils pris en charge

Les outils sont organisés par produit et par intention (lecture, écriture, recherche, suppression ou gestion). Les administrateurs d'organisation accordent ou révoquent l'accès au niveau du groupe d'autorisations, et chaque outil hérite de l'accès de son groupe parent.

ProduitGroupes d'autorisationsOAuth 2.1Jeton API
Jiraread_jira · write_jira · search_jira✅✅
Jira (activé par l'administrateur)delete_jira · manage_jira✅✅
Confluenceread_confluence · write_confluence · search_confluence✅✅
Bitbucket Cloudread_bitbucket · write_bitbucket✅✅
Jira Service Managementread_jsm · write_jsm—✅ (uniquement)
Plateforme Atlassianread_teamwork_graph · write_teamwork_graph · search_atlassian✅✅
Loomread_loom · write_loom✅✅
Objectifsread_goals · write_goals✅✅
Projetsread_projects · write_projects✅✅
Équipesread_teams · write_teams✅✅
Focusread_focus · write_focus✅✅
Talentread_talent · write_talent✅✅
Compassread_compass · write_compass✅ (uniquement)—

Conditions spécifiques au produit :

  • delete_jira et manage_jira sont désactivés par défaut et doivent être activés par un administrateur avant de pouvoir être utilisés.
  • Les outils Bitbucket Cloud ne sont disponibles que si votre espace de travail Bitbucket est lié à une organisation. Les espaces de travail non liés à une organisation ne peuvent pas être sélectionnés lors de l'authentification.
  • Les outils Jira Service Management ne prennent en charge que l'authentification par jeton API et ne sont disponibles que si un administrateur d'organisation a activé l'authentification par jeton API.
  • Les outils Loom ne sont disponibles que pour les espaces de travail Loom liés à un site Atlassian.
  • Les outils Teamwork Graph peuvent récupérer des données de services tiers connectés à Jira, tels que les pull requests, builds et déploiements liés. Pour GitHub for Atlassian, l'accès complet signifie que les outils récupèrent les données GitHub en fonction des autorisations GitHub de l'utilisateur, tandis que l'accès limité signifie qu'ils récupèrent les données en fonction des autorisations Jira de l'utilisateur. Les connecteurs Azure DevOps, GitLab, Jenkins et Spinnaker suivent le modèle d'accès limité.

[!NOTE] Pour la référence complète et actuelle des outils, y compris la portée requise pour chaque groupe d'autorisations, voir Outils pris en charge.


Comment le serveur expose les outils

Plutôt que d'envoyer chaque définition d'outil au client IA lors de la connexion, le serveur Atlassian MCP expose un petit ensemble d'outils les plus utilisés et laisse le client découvrir le reste à la demande. Les outils marqués Principal sont visibles directement par les agents.

Cela présente deux avantages :

  • Le contexte de votre client reste libre pour la tâche en cours au lieu d'être rempli de définitions d'outils.
  • De nouveaux outils deviennent disponibles sans que le client ait besoin de se reconnecter.

Passerelles MCP

Si vous utilisez une passerelle MCP, ou si vous avez besoin que tous les outils soient disponibles dès le départ plutôt que d'utiliser les méthodes de découverte et d'exécution, utilisez le remplacement tools=all pour exposer tous les outils sous forme de liste plate paginée :

https://mcp.atlassian.com/v2/mcp?tools=all

Avant de commencer

Vérifiez que votre environnement répond à ces exigences avant de configurer le serveur.

Prérequis

Les exigences dépendent de la façon dont vous vous connectez :

Pour les clients pris en charge

  • Un site cloud Atlassian avec un ou plusieurs des produits suivants : Jira, Confluence, Jira Service Management, Bitbucket ou Compass
  • L'accès au client de votre choix
  • Un navigateur moderne pour terminer le flux d'autorisation OAuth 2.1, ou des identifiants de jeton API pour l'authentification sans interface

Si votre administrateur d'organisation a désactivé l'authentification par jeton API, les clients MCP ne peuvent pas se connecter avec un jeton et doivent utiliser OAuth 2.1 à la place.

Pour les IDE ou les clients locaux (configuration de bureau)

  • Un site cloud Atlassian avec un ou plusieurs produits pris en charge
  • Un IDE pris en charge (par exemple, Claude Desktop, VS Code ou Cursor) ou un client personnalisé compatible MCP
  • Node.js v18+ installé pour exécuter le proxy MCP local (mcp-remote)
  • Un navigateur moderne pour terminer la connexion OAuth, ou des identifiants de jeton API pour l'authentification sans interface

Données et sécurité

Le serveur applique plusieurs contrôles de sécurité :

  • Tout le trafic est chiffré en transit via HTTPS (TLS 1.2 ou version ultérieure), conformément aux pratiques de sécurité d'Atlassian.
  • L'authentification OAuth 2.1 et par jeton API fournit un contrôle d'accès sécurisé.
  • L'accès aux données respecte les autorisations utilisateur dans chaque produit Atlassian connecté, y compris Jira, Confluence, Jira Service Management, Bitbucket, Compass et Loom.
  • Si votre organisation utilise la liste blanche d'adresses IP pour les produits Atlassian Cloud, les appels d'outils effectués via le serveur Atlassian MCP respectent également ces règles IP.

Pour une vue d'ensemble plus approfondie du modèle de sécurité et des contrôles d'administration, voir :


Comment cela fonctionne

Architecture et communication

  1. Un client pris en charge se connecte au point de terminaison du serveur. Le point de terminaison recommandé pour tous les clients est :

    https://mcp.atlassian.com/v2/mcp
    

    Les points de terminaison v1 (https://mcp.atlassian.com/v1/mcp/authv2 et https://mcp.atlassian.com/v1/mcp) restent pris en charge, et les connexions v1 existantes commencent automatiquement à exposer et à utiliser les outils v2.

  2. Selon votre configuration, un flux OAuth 2.1 sécurisé basé sur navigateur est déclenché, ou l'authentification par jeton API est utilisée.

  3. Une fois autorisé, le client diffuse des données contextuelles et reçoit des réponses en temps réel de vos produits Atlassian connectés.

[!WARNING] Après le 30 juin 2026, le point de terminaison hérité Server-Sent Events (https://mcp.atlassian.com/v1/sse) ne sera plus pris en charge. Mettez à jour tous les clients personnalisés configurés pour utiliser /sse afin qu'ils pointent vers /mcp — de préférence https://mcp.atlassian.com/v2/mcp.

[!NOTE] Les clients qui ne peuvent pas terminer l'authentification après la migration vers les outils v2 peuvent devoir effacer les identifiants client mis en cache ou les identifiants .well-known.

Gestion des autorisations

L'accès n'est accordé qu'aux données que l'utilisateur a déjà l'autorisation de consulter dans Atlassian Cloud. Toutes les actions respectent les rôles existants au niveau du projet ou de l'espace. L'authentification OAuth et par jeton API honorent toutes deux les portées configurées et les autorisations Atlassian.

Authentification par jeton API (sans interface)

L'authentification par jeton API est disponible pour les configurations de clients sans interface, de type service ou non interactives (par exemple, les systèmes backend ou les automatisations). Elle est également requise pour les outils Jira Service Management.

Deux mécanismes sont pris en charge :

MécanismeEn-tête
Jeton API personnel (authentification de base)Authorization: Basic <base64(email:api_token)>
Clé API de compte de service (jeton Bearer)Authorization: Bearer <api_key>
  • Activation requise par l'administrateur : Un administrateur d'organisation doit activer l'authentification par jeton API pour le serveur Atlassian MCP (Administration Atlassian → Rovo → Serveur Rovo MCP → Authentification).
  • Jeton à portée requise : Créez un jeton API personnel, ou demandez à votre administrateur une clé API de compte de service, avec les portées requises pour les outils et les données auxquels vous devez accéder.
  • Guide de configuration : Configurer l'authentification via jeton API
  • Référence des paramètres d'administration : Contrôler les paramètres du serveur Atlassian MCP : Configurer l'authentification

Exemples de flux de travail

Une fois connecté, vous pouvez exécuter des tâches comme celles-ci depuis votre client.

Flux de travail Jira

  • Recherche : « Trouver tous les bugs ouverts dans le projet Alpha. »
  • Créer/mettre à jour : « Créer une histoire intitulée « Refonte de l'intégration ». »
  • Création en masse : « Créer cinq tickets Jira à partir de ces notes. »

Flux de travail Confluence

  • Résumer : « Résumer la page de planification du T2. »
  • Créer : « Créer une page intitulée « Objectifs de l'équipe T3 ». »
  • Naviguer : « À quels espaces ai-je accès ? »

Flux de travail Compass

  • Créer : « Créer un composant de service basé sur le dépôt actuel. »
  • Création en masse : « Importer des composants et des champs personnalisés à partir de ce CSV/JSON. »
  • Interroger : « Qu'est-ce qui dépend du service api-gateway ? »

Flux de travail Loom

  • Récupérer : « Trouver l'enregistrement Loom de la revue de conception de la semaine dernière. »
  • Résumer : « Résumer cette démonstration Loom et lister les éléments d'action. »

Flux de travail Projets et Objectifs

  • Statut : « Quel est le statut actuel du projet Checkout Revamp ? »
  • Consolider : « Quels objectifs sont à risque ce trimestre, et pourquoi ? »

Tâches combinées

  • Lier du contenu : « Lier ces trois éléments de travail Jira à la page « Plan de publication ». »
  • Trouver de la documentation : « Récupérer la page de documentation Confluence liée à ce composant Compass. »
  • Faire avancer le travail : « Déplacer PROJ-456 vers « En revue » et ajouter un commentaire indiquant que la PR est en ligne. »

[!NOTE] Les capacités réelles varient en fonction de votre niveau d'autorisation et de la plateforme client.


Conseils et astuces

Définir le CloudId par défaut, le projet Jira et l'espace Confluence

Mettez à jour votre AGENTS.md avec le Markdown ci-dessous pour réduire les appels d'outils de découverte, économiser du temps et des jetons, et définir un nombre maximal de résultats de recherche.

## Atlassian MCP

When connected to atlassian-rovo-mcp:
- **MUST** use Jira project key = YOURPROJ
- **MUST** use Confluence spaceId = "123456"
- **MUST** use cloudId = "https://yoursite.atlassian.net" (do NOT call getAccessibleAtlassianResources)
- **MUST** use `maxResults: 10` or `limit: 10` for ALL Jira JQL and Confluence CQL search operations.

Utiliser les compétences

Si vous utilisez un client de bureau comme Claude, vous pouvez créer ou réutiliser des compétences pour les tâches répétitives. Voir les compétences Atlassian MCP par défaut.

Pour Cursor, les compétences font partie du plugin de la place de marché.


Notes d'administration : gestion de l'accès

Si vous êtes un administrateur préparant votre organisation à utiliser le serveur Atlassian MCP, examinez les points ci-dessous. Pour des conseils d'administration plus détaillés, voir :

Gérer, surveiller et révoquer l'accès

  • Contrôles d'administration : Les administrateurs de site et d'organisation peuvent gérer, examiner ou révoquer l'accès de l'application MCP depuis Gérer les applications Marketplace et tierces de votre organisation.
  • Contrôles de domaine : Utilisez la page de paramètres Serveur Rovo MCP dans l'administration Atlassian pour contrôler quels outils IA externes et domaines sont autorisés à se connecter. Par défaut, les domaines pris en charge par Atlassian sont autorisés ; vous pouvez ajouter des domaines de confiance ou bloquer les domaines pris en charge. Les contrôles de domaine s'appliquent aux connexions OAuth 2.1. Pour plus de détails, voir Domaines disponibles du serveur Atlassian MCP.
  • Contrôles IP : Si votre organisation utilise la liste blanche d'adresses IP pour les applications Atlassian Cloud, les requêtes effectuées via le serveur Atlassian MCP doivent provenir d'une adresse IP autorisée par la liste blanche d'adresses IP de votre organisation pour l'application concernée. Pour les détails de configuration, voir Spécifier les adresses IP pour l'accès aux produits. Les restrictions IP de Bitbucket Cloud sont configurées séparément par les administrateurs d'espace de travail sous Paramètres de l'espace de travail → Contrôles d'accès. Voir Contrôler l'accès au contenu privé dans un espace de travail.
  • Contrôles de l'utilisateur final : Les utilisateurs individuels peuvent révoquer leurs propres autorisations d'application depuis leurs paramètres de profil.
  • Journalisation d'audit : Chaque fois qu'un outil est utilisé via le serveur Atlassian MCP, un événement est enregistré dans le journal d'audit de votre organisation. Les administrateurs peuvent les examiner dans l'administration Atlassian sous Insights → Journal d'audit (filtrer pour Actions utilisateur Rovo MCP ou rechercher MCP). Pour plus d'informations, voir Surveiller l'activité du serveur Atlassian MCP.

Résolution des problèmes courants

  • « Vous n'avez pas la permission de vous connecter depuis cette adresse IP. Veuillez demander l'accès à votre administrateur. » Cela indique généralement que la liste blanche d'adresses IP est activée et que l'adresse IP source de la requête n'est pas autorisée à accéder à l'application concernée via le serveur Atlassian MCP. Demandez à votre administrateur de site, d'organisation ou d'espace de travail Bitbucket d'examiner la liste blanche d'adresses IP applicable.

    Les clients IA hébergés peuvent envoyer des requêtes depuis les adresses IP sortantes du fournisseur d'IA plutôt que depuis le réseau d'entreprise ou le VPN de l'utilisateur. Être sur un VPN autorisé peut donc être insuffisant. Demandez à votre administrateur d'examiner les plages d'adresses IP sortantes publiées par le fournisseur et d'approuver l'accès requis. Pour les connecteurs hébergés par OpenAI, voir Guide de sortie IP d'OpenAI. Les connexions MCP locales peuvent utiliser l'adresse IP sortante du réseau local. Voir comment la liste blanche d'adresses IP fonctionne avec Atlassian MCP.

  • La connexion OAuth réussit, mais les appels d'outils renvoient 403. Une connexion réussie ne garantit pas que les appels d'outils passeront les restrictions IP. Un 403 peut également indiquer des portées insuffisantes, des autorisations d'application ou une autre politique d'accès. Confirmez la raison du refus avant de modifier une liste blanche d'adresses IP.


Sécurité

Le protocole Model Context Protocol (MCP) permet aux agents IA de se connecter à des outils et à des données Atlassian en utilisant les autorisations de votre compte, ce qui crée des flux de travail puissants mais aussi des risques structurels. Tout client ou serveur MCP que vous activez (par exemple, les plugins IDE, les applications de bureau, les serveurs MCP hébergés ou les intégrations « en un clic ») peut amener un agent IA à effectuer des actions en votre nom.

Les grands modèles de langage (LLM) sont vulnérables à l'injection de prompt et aux attaques associées (telles que l'injection de prompt indirecte et l'empoisonnement d'outils). Ces attaques peuvent ordonner à l'agent d'exfiltrer des données ou d'apporter des modifications non intentionnelles sans demandes explicites. Pour réduire les risques, utilisez uniquement des clients et serveurs MCP de confiance, examinez attentivement les outils et données auxquels chaque agent peut accéder, et appliquez le principe du moindre privilège (jetons limités, accès minimal au projet/espace de travail). Pour toute action à fort impact ou destructive, exigez une confirmation humaine et surveillez les journaux d'audit pour détecter toute activité inhabituelle. Nous vous recommandons vivement de consulter les recommandations d'Atlassian sur les risques liés à MCP dans MCP Clients: Understanding the potential security risks.


Support et retours

Nous utilisons vos retours pour améliorer le serveur MCP Atlassian. Si vous rencontrez un bug ou une limitation, ou si vous avez une suggestion :


Avertissement

Les clients MCP peuvent effectuer des actions sur les produits Atlassian avec vos autorisations existantes. Utilisez le moindre privilège, examinez les modifications à fort impact avant de les confirmer, et surveillez les journaux d'audit pour détecter toute activité inhabituelle.

En savoir plus : MCP Clients: Understanding the potential security risks.