MCP Atlassian — Installer & Démo en direct

Name: MCP Atlassian MCP Server
Author: sooperset

Pourquoi l'utiliser

Fonctionnalités clés

Jira : recherche JQL, get/create/update issue, transition, ajout de commentaire, liste de workflow
Confluence : recherche de pages, récupération de contenu, création/modification de pages, commentaires, pièces jointes
Support Cloud + Server/Data Center
Mode lecture seule pour les déploiements au moindre privilège
Filtres de site — restreignez à un seul projet/space si vous en avez beaucoup
Transport stdio + HTTP/SSE

Démo en direct

Aperçu en pratique

mcp-atlassian-sooperset.replay ▶ prêt

0/0

Installer

Choisissez votre client

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "mcp-atlassian-sooperset": {
      "command": "uvx",
      "args": [
        "mcp-atlassian"
      ],
      "env": {
        "JIRA_URL": "https://yourorg.atlassian.net",
        "JIRA_USERNAME": "[email protected]",
        "JIRA_API_TOKEN": "${JIRA_API_TOKEN}",
        "CONFLUENCE_URL": "https://yourorg.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "[email protected]",
        "CONFLUENCE_API_TOKEN": "${CONFLUENCE_API_TOKEN}"
      }
    }
  }
}

Ouvrez Claude Desktop → Settings → Developer → Edit Config. Redémarrez après avoir enregistré.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "mcp-atlassian-sooperset": {
      "command": "uvx",
      "args": [
        "mcp-atlassian"
      ],
      "env": {
        "JIRA_URL": "https://yourorg.atlassian.net",
        "JIRA_USERNAME": "[email protected]",
        "JIRA_API_TOKEN": "${JIRA_API_TOKEN}",
        "CONFLUENCE_URL": "https://yourorg.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "[email protected]",
        "CONFLUENCE_API_TOKEN": "${CONFLUENCE_API_TOKEN}"
      }
    }
  }
}

Cursor utilise le même schéma mcpServers que Claude Desktop. La config projet l'emporte sur la globale.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "mcp-atlassian-sooperset": {
      "command": "uvx",
      "args": [
        "mcp-atlassian"
      ],
      "env": {
        "JIRA_URL": "https://yourorg.atlassian.net",
        "JIRA_USERNAME": "[email protected]",
        "JIRA_API_TOKEN": "${JIRA_API_TOKEN}",
        "CONFLUENCE_URL": "https://yourorg.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "[email protected]",
        "CONFLUENCE_API_TOKEN": "${CONFLUENCE_API_TOKEN}"
      }
    }
  }
}

Cliquez sur l'icône MCP Servers dans la barre latérale Cline, puis "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-atlassian-sooperset": {
      "command": "uvx",
      "args": [
        "mcp-atlassian"
      ],
      "env": {
        "JIRA_URL": "https://yourorg.atlassian.net",
        "JIRA_USERNAME": "[email protected]",
        "JIRA_API_TOKEN": "${JIRA_API_TOKEN}",
        "CONFLUENCE_URL": "https://yourorg.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "[email protected]",
        "CONFLUENCE_API_TOKEN": "${CONFLUENCE_API_TOKEN}"
      }
    }
  }
}

Même format que Claude Desktop. Redémarrez Windsurf pour appliquer.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "mcp-atlassian-sooperset",
      "command": "uvx",
      "args": [
        "mcp-atlassian"
      ]
    }
  ]
}

Continue utilise un tableau d'objets serveur plutôt qu'une map.

~/.config/zed/settings.json

{
  "context_servers": {
    "mcp-atlassian-sooperset": {
      "command": {
        "path": "uvx",
        "args": [
          "mcp-atlassian"
        ]
      }
    }
  }
}

Ajoutez dans context_servers. Zed recharge à chaud à la sauvegarde.

claude mcp add mcp-atlassian-sooperset -- uvx mcp-atlassian

Une seule ligne. Vérifiez avec claude mcp list. Supprimez avec claude mcp remove.

Cas d'usage

Usages concrets : MCP Atlassian

Trier une erreur de production en ticket Jira avec runbook Confluence lié

👤 Ingénieurs d'astreinte ⏱ ~10 min intermediate

Quand l'utiliser : Une alerte Sentry vient de se déclencher — vous voulez un ticket Jira trié et un lien vers le runbook, rapidement.

Prérequis

Tokens API — Atlassian → Mon compte → Sécurité → Tokens API

Déroulement

Rechercher les issues liées

Atlassian : recherche dans Jira les issues contenant 'NullPointerException OrderService' dans les 30 derniers jours. Recherche aussi dans Confluence les pages de runbook mentionnant OrderService.✓ Copié

→ Les deux ensembles de résultats retournés
Décider : doublon ou nouveau

S'il y a une issue BUG ouverte dans les 14 derniers jours, commente dessus avec le nouveau stack trace. Sinon crée un nouveau BUG, lie la page de runbook, définit la priorité Haute.✓ Copié

→ Soit jira_add_comment soit jira_create_issue appelé une fois
Transmettre

Donne-moi la clé du ticket et un résumé court pour que je puisse le poster dans Slack.✓ Copié

→ ABC-1234 + résumé en 1 ligne

Résultat : Ticket trié avec lien runbook en moins de 2 minutes ; pas de doublons.

Pièges

Stack trace collé dans Jira en texte brut perd le formatage — Encadrez avec les marqueurs {code} ; le MCP transmet tel quel
Injection JQL via les entrées utilisateur — Mettez toujours les paramètres de chaîne entre guillemets ; l'outil échappe mais soyez explicite

Combiner avec : sentry · github

Générer un rapport de statut hebdomadaire depuis Jira

👤 Tech leads / EM ⏱ ~10 min beginner

Quand l'utiliser : Lundi matin : vous devez résumer ce qui a été livré + ce qui est bloqué.

Déroulement

Récupérer les tâches terminées la semaine passée

Atlassian : JQL project = PLAT AND status changed to Done during (-7d, now()) ORDER BY updated DESC✓ Copié

→ Liste d'issues avec assigné, clé, résumé
Récupérer les bloquées

Maintenant JQL project = PLAT AND status = Blocked — pour chacune, résume le dernier commentaire.✓ Copié

→ Liste des bloquées avec résumé du dernier commentaire par issue
Composer

Formatte en rapport hebdomadaire de 200 mots groupé par Livré / Bloqué / À risque.✓ Copié

→ Rapport concis prêt à coller

Résultat : Rapport de statut assemblé en 90 secondes avec les clés d'issues citées.

Pièges

De longs fils de commentaires gonflent le contexte — Utilisez jira_get_issue avec fields=summary,status,assignee uniquement

Rédiger une RFC Confluence à partir d'une discussion

👤 Ingénieurs rédigeant des documents de conception ⏱ ~20 min intermediate

Quand l'utiliser : Vous avez débattu d'une approche en chat ; vous voulez en faire une page Confluence.

Déroulement

Trouver l'espace parent

Atlassian : trouve l'espace 'Engineering RFC'. Liste ses pages de premier niveau.✓ Copié

→ Espace + page parent identifiés
Composer

Crée une nouvelle page dessous intitulée 'RFC : migration de Redis vers Valkey'. Sections : contexte, objectifs/non-objectifs, options considérées, décision, plan. Utilise la discussion ci-dessus comme matière première.✓ Copié

→ confluence_create_page retourne une URL

Résultat : RFC rédigée prête pour la revue.

Pièges

Mauvais ID de page parent — Lancez toujours confluence_search par space d'abord

Nettoyer en masse les tickets obsolètes

👤 Responsables d'ingénierie ⏱ ~30 min intermediate

Quand l'utiliser : Le backlog compte 200 tickets zombies ; vous voulez les trier.

Déroulement

Identifier les obsolètes

JQL : project = PLAT AND status = Open AND updated < -90d. Limite 50.✓ Copié

→ Liste des issues obsolètes
Proposer une action

Pour chacune, propose : clore-obsolète, réassigner-au-triage, ou garder. Montre-moi 10 à la fois avant de transitionner.✓ Copié

→ Recommandation par issue ; vous approuvez par lots
Appliquer

Ferme celles que j'ai approuvées avec un commentaire 'fermeture pour obsolescence'.✓ Copié

→ jira_transition_issue + jira_add_comment appelés par issue

Résultat : Backlog nettoyé avec trace d'audit par issue.

Pièges

Fermeture automatique de tickets légitimes mais silencieux — Toujours regrouper + confirmer avant la transition

Combinaisons

Associez-le à d'autres MCPs pour un effet X10

mcp-atlassian-sooperset + sentry

Convertir les erreurs Sentry en tickets Jira bien formés

Sentry : récupère la dernière issue critique. Atlassian : crée un BUG Jira avec le stack trace et le lien Sentry.✓ Copié

mcp-atlassian-sooperset + github

Lier automatiquement les PRs aux tickets Jira

GitHub : trouve les PRs mergées aujourd'hui. Atlassian : pour chacune, commente sur l'issue Jira liée avec l'URL de la PR.✓ Copié

Outils

Ce que ce MCP expose

Outil	Entrées	Quand appeler	Coût
jira_search	jql: str, limit?	Toute recherche Jira	1 appel API
jira_get_issue	key: str, fields?	Besoin du corps complet d'une issue	1 appel
jira_create_issue	project, type, summary, description, fields?	Créer un nouveau ticket	1 appel
jira_transition_issue	key, transition, comment?	Faire avancer une issue dans le workflow	1 appel
jira_add_comment	key, body	Ajouter du contexte	1 appel
confluence_search	cql: str	Trouver de la documentation	1 appel
confluence_get_page	id: str	Lire le contenu d'une page	1 appel
confluence_create_page	space, parent_id, title, body	Nouveau document	1 appel
confluence_update_page	id, title, body, version	Modifier un document	1 appel

Coût et limites

Coût d'exécution

Quota d'API: Atlassian Cloud : 5000 req/h par utilisateur/token (varie selon le tier)
Tokens par appel: 300–4000
Monétaire: OSS gratuit ; votre forfait Atlassian s'applique
Astuce: Utilisez fields= pour alléger les payloads ; les valeurs par défaut de jira_get_issue sont lourdes

Sécurité

Permissions, secrets, portée

Portées minimales : read:jira-work write:jira-work read:confluence-content.all write:confluence-content

Stockage des identifiants : Token API dans une variable d'env ; à renouveler via Mon compte

Sortie de données : Uniquement votre instance atlassian.net (ou self-hosted)

Ne jamais accorder : site-admin

Définissez READ_ONLY_MODE=true si Claude ne doit pas pouvoir muter ; couvre tous les outils d'écriture

Dépannage

Erreurs courantes et correctifs

401 Unauthorized

Token expiré ou mauvais nom d'utilisateur (doit être l'email pour Cloud)

Vérifier : curl -u email:token $URL/rest/api/3/myself

Erreur de parsing JQL

Mettez les valeurs de chaînes entre guillemets, échappez les caractères spéciaux ; prévisualisez d'abord dans l'interface Jira

Accès refusé lors de la création dans un space

L'utilisateur du token n'a pas la permission 'Ajouter une page' dans cet espace

429 Rate-limited

Backoff ; réduisez le déploiement parallèle ; vérifiez la limite de débit Atlassian par token

Vérifier : En-têtes X-RateLimit

Alternatives

MCP Atlassian vs autres

Alternative	Quand l'utiliser	Compromis
MCP Atlassian officiel (Cloud)	Vous utilisez uniquement Cloud et voulez OAuth	Plus récent, ensemble d'outils plus restreint ; ne couvre pas Server/DC
Linear MCP	Vous êtes sur Linear, pas Jira	Système différent ; plus rapide/propre mais pas d'équivalent Confluence

Plus

Ressources

📖 Lire le README officiel sur GitHub

🐙 Voir les issues ouvertes

🔍 Parcourir les 400+ serveurs MCP et Skills