/ Diretório / Playground / MCP Atlassian
← Todos os servidores ↗ GitHub
● Comunidade sooperset 🔑 Requer sua chave

MCP Atlassian

por sooperset · sooperset/mcp-atlassian

O padrão ouro da comunidade para Jira + Confluence no Claude — busca por JQL, arquive/transite tickets, leia/escreva páginas Confluence, tudo atrás de um único servidor stdio.

O MCP Atlassian é o conector Atlassian de terceiros mais estrelado, suportando Cloud e Server/Data Center. Ele expõe busca JQL, CRUD de issues, transições, comentários, anexos e a API Storage completa do Confluence. Autenticação via token de API (cloud) ou PAT (server). O modo somente-leitura é suportado quando você não quer expor ferramentas de escrita.

▶ Ver demo 📦 Instalar 💡 Casos de uso

Por que usar

Principais recursos

Demo ao vivo

Como fica na prática

mcp-atlassian-sooperset.replay ▶ pronto
0/0

Instalar

Escolha seu cliente

~/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}"
      }
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.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 usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

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}"
      }
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "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}"
      }
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "mcp-atlassian-sooperset",
      "command": "uvx",
      "args": [
        "mcp-atlassian"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json
{
  "context_servers": {
    "mcp-atlassian-sooperset": {
      "command": {
        "path": "uvx",
        "args": [
          "mcp-atlassian"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

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

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: MCP Atlassian

Triagem de um erro de produção em ticket Jira com runbook do Confluence vinculado

👤 Engenheiros de plantão ⏱ ~10 min intermediate

Quando usar: Alerta do Sentry disparou — você quer um ticket Jira triado e um link de runbook, rápido.

Pré-requisitos
  • Tokens de API — Atlassian → Minha Conta → Segurança → Tokens de API
Fluxo
  1. Busque relacionados
    Atlassian: busque no Jira issues contendo 'NullPointerException OrderService' nos últimos 30 dias. Também busque no Confluence páginas de runbook mencionando OrderService.✓ Copiado
    → Ambos os conjuntos de resultados retornados
  2. Decida: duplicata ou novo
    Se houver um BUG em aberto nos últimos 14 dias, comente nele com o novo stack trace. Caso contrário, crie um novo BUG, vincule à página do runbook, defina prioridade Alta.✓ Copiado
    → Ou jira_add_comment ou jira_create_issue chamado uma vez
  3. Passe adiante
    Me diga a chave do ticket e o resumo curto para eu postar no Slack.✓ Copiado
    → ABC-1234 + resumo de 1 linha

Resultado: Ticket triado com link de runbook em menos de 2 minutos; sem duplicatas.

Armadilhas
  • Stack trace colado no Jira como texto simples perde a formatação — Envolva com marcadores {code}; o MCP encaminha como está
  • Injeção JQL via input do usuário — Sempre aspas parâmetros string; a ferramenta escapa, mas seja explícito
Combine com: sentry · github

Gere um relatório de status semanal a partir do Jira

👤 Tech leads / EMs ⏱ ~10 min beginner

Quando usar: Segunda de manhã: você precisa resumir o que foi entregue + o que está bloqueado.

Fluxo
  1. Busque o concluído da semana passada
    Atlassian: JQL project = PLAT AND status changed to Done during (-7d, now()) ORDER BY updated DESC✓ Copiado
    → Lista de issues com responsável, chave e resumo
  2. Busque os bloqueados
    Agora JQL project = PLAT AND status = Blocked — para cada um, resuma o comentário mais recente.✓ Copiado
    → Lista de bloqueados com resumo do último comentário por issue
  3. Componha
    Formate como um relatório semanal de 200 palavras agrupado por Entregue / Bloqueado / Em Risco.✓ Copiado
    → Relatório conciso pronto para colar

Resultado: Relatório de status montado em 90 segundos com chaves de issues citadas.

Armadilhas
  • Threads longas de comentários inflam o contexto — Use jira_get_issue com fields=summary,status,assignee apenas

Rascunhe um RFC no Confluence a partir de uma discussão

👤 Engenheiros escrevendo design docs ⏱ ~20 min intermediate

Quando usar: Você debateu uma abordagem no chat; quer uma página Confluence para documentar.

Fluxo
  1. Encontre o espaço pai
    Atlassian: encontre o espaço 'Engineering RFC'. Liste suas páginas de nível superior.✓ Copiado
    → Espaço + página pai identificados
  2. Componha
    Crie uma nova página abaixo dela com o título 'RFC: migrar de Redis para Valkey'. Seções: contexto, objetivos/não-objetivos, opções consideradas, decisão, plano. Use a discussão acima como material bruto.✓ Copiado
    → confluence_create_page retorna uma URL

Resultado: RFC rascunhado pronto para revisão.

Armadilhas
  • ID da página pai errado — Sempre faça confluence_search por espaço primeiro

Limpeza em massa de tickets obsoletos

👤 Gerentes de engenharia ⏱ ~30 min intermediate

Quando usar: O backlog tem 200 zumbis; você quer organizá-los.

Fluxo
  1. Identifique os obsoletos
    JQL: project = PLAT AND status = Open AND updated < -90d. Limite 50.✓ Copiado
    → Lista de issues obsoletos
  2. Proponha ação
    Para cada um, proponha: fechar-como-obsoleto, reatribuir-para-triagem ou manter. Mostre-me 10 por vez antes de transicionar.✓ Copiado
    → Recomendação por issue; você aprova em lotes
  3. Aplique
    Feche os que eu aprovei com um comentário 'fechando como obsoleto'.✓ Copiado
    → jira_transition_issue + jira_add_comment chamados por issue

Resultado: Backlog limpo com trilha de auditoria por issue.

Armadilhas
  • Fechar automaticamente tickets legítimos mas silenciosos — Sempre faça lote + confirmação antes de transicionar

Combinações

Combine com outros MCPs para 10× de alavancagem

mcp-atlassian-sooperset + sentry

Converter erros do Sentry em tickets Jira bem formatados

Sentry: obtenha o issue crítico mais recente. Atlassian: abra um BUG Jira com o stack trace e vincule a URL do Sentry.✓ Copiado
mcp-atlassian-sooperset + github

Vincule PRs a tickets Jira automaticamente

GitHub: encontre PRs mergeados hoje. Atlassian: para cada um, comente no issue Jira vinculado com a URL do PR.✓ Copiado

Ferramentas

O que este MCP expõe

FerramentaEntradasQuando chamarCusto
jira_search jql: str, limit? Qualquer busca no Jira 1 API call
jira_get_issue key: str, fields? Precisa do corpo completo de um issue 1 call
jira_create_issue project, type, summary, description, fields? Abrir novo ticket 1 call
jira_transition_issue key, transition, comment? Mover issue pelo workflow 1 call
jira_add_comment key, body Adicionar contexto 1 call
confluence_search cql: str Encontrar docs 1 call
confluence_get_page id: str Ler conteúdo de página 1 call
confluence_create_page space, parent_id, title, body Novo documento 1 call
confluence_update_page id, title, body, version Editar documento 1 call

Custo e limites

O que custa rodar

Cota de API
Atlassian Cloud: 5000 req/h por usuário/token (varia por plano)
Tokens por chamada
300–4000
Monetário
OSS gratuito; seu plano Atlassian se aplica
Dica
Use fields= para diminuir payloads; os padrões do jira_get_issue são pesados

Segurança

Permissões, segredos, alcance

Escopos mínimos: read:jira-work write:jira-work read:confluence-content.all write:confluence-content
Armazenamento de credenciais: Token de API em variável de ambiente; rotacione via Minha Conta
Saída de dados: Apenas sua instância atlassian.net (ou self-hosted)
Nunca conceda: site-admin

Solução de problemas

Erros comuns e correções

401 Unauthorized

Token expirado ou nome de usuário errado (deve ser email para Cloud)

Verificar: curl -u email:token $URL/rest/api/3/myself
JQL parse error

Aspas em valores de string, escape caracteres especiais; pré-visualize com a UI do Jira primeiro

Forbidden when creating in space

O usuário do token não tem permissão 'Add page' nesse espaço

Rate-limited 429

Backoff; reduza fan-out paralelo; verifique rate limit por token do Atlassian

Verificar: X-RateLimit headers

Alternativas

MCP Atlassian vs. outros

AlternativaQuando usarTroca
Atlassian official MCP (Cloud)Você usa apenas Cloud e quer OAuthMais novo, conjunto de ferramentas mais estreito; não cobre Server/DC
Linear MCPVocê usa Linear, não JiraSistema diferente; mais rápido/limpo mas sem equivalente ao Confluence

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills