Atlassian MCP Server

oficial

Servidor MCP oficial da Atlassian para conectar agentes de IA ao Jira, Confluence, Opsgenie e outros produtos Atlassian.

GitHub

856

O que você pode fazer com Atlassian MCP?

Pesquise e resuma conteúdo do Jira, Confluence ou Bitbucket — peça à sua IA para encontrar bugs abertos, resumir páginas ou pesquisar em projetos usando ferramentas search.
Crie e atualize issues do Jira ou páginas do Confluence — use linguagem natural para gerar histórias, tarefas ou documentação por meio de ferramentas write.
Consulte e gerencie componentes do Compass — consulte dependências de serviço ou crie componentes a partir do seu repositório com as ferramentas read e write do Compass.
Crie itens em massa a partir de notas ou especificações — transforme notas de reunião em várias issues do Jira ou importe componentes de dados estruturados de uma só vez.
Vincule trabalhos relacionados entre produtos — conecte tickets do Jira a páginas do Confluence ou busque documentação vinculada a um componente do Compass.

Documentação

Atlassian

Atlassian Rovo MCP Server

O servidor oficial do Model Context Protocol (MCP) para Atlassian: uma ponte hospedada na nuvem que oferece às suas ferramentas de IA acesso seguro e em tempo real ao Jira, Confluence, Jira Service Management, Bitbucket e Compass.

Primeiros passos · Ferramentas suportadas · Segurança e administração · Comunidade

O servidor oficial Atlassian Rovo MCP é uma ponte baseada em nuvem entre seu site Atlassian Cloud e ferramentas externas compatíveis. Uma vez configurado, ele permite que essas ferramentas interajam com dados do Jira, Confluence, Jira Service Management, Bitbucket e Compass em tempo real. A autenticação usa OAuth 2.1 ou tokens de API, para que cada ação respeite os controles de acesso existentes do usuário.

Com o Atlassian Rovo MCP Server, você pode:

Resumir e pesquisar conteúdo do Jira, Confluence, Jira Service Management e Bitbucket sem alternar entre ferramentas.
Criar e atualizar itens ou páginas com base em comandos em linguagem natural.
Automatizar trabalhos repetitivos, como gerar tickets a partir de notas de reunião ou especificações.

Ele foi criado para desenvolvedores, criadores de conteúdo e equipes de projeto que trabalham em IDEs ou ferramentas de IA e desejam usar dados da Atlassian sem mudar constantemente de contexto.

Configuração com um clique

Escolha seu cliente de IA abaixo para instalar o servidor oficial Atlassian Rovo MCP. Cada botão usa o link de instalação nativo do seu cliente, para que você não precise editar nenhuma configuração JSON manualmente.

Adicionar ao Cursor
_{Referencie itens e registre trabalho em sua base de código.}

Adicionar ao VS Code
_{Pesquise e crie itens do Jira via GitHub Copilot.}

Adicionar ao ChatGPT
_{Pesquise, resuma e crie diretamente do ChatGPT.}

Adicionar ao Claude
_{Traga o Jira e o Confluence para os fluxos de trabalho do Claude.}

Conteúdo

Configuração com um clique
Clientes suportados
Produtos e ferramentas suportados
Antes de começar
Dados e segurança
Como funciona
Exemplos de fluxos de trabalho
Dicas e truques
Notas do administrador: gerenciando o acesso
Segurança
Suporte e feedback
Aviso legal

Clientes suportados

O Atlassian Rovo MCP Server funciona com uma lista crescente de clientes compatíveis com MCP:

Cliente	Referência de configuração
OpenAI ChatGPT	Guia de Conectores / MCP
Claude (Claude.ai, Desktop e Code)	Documentação do Claude MCP
Cursor	Atlassian no marketplace do Cursor
Visual Studio Code (GitHub Copilot)	Documentação do VS Code MCP
GitHub Copilot CLI	Sobre o Copilot CLI
Google Gemini CLI	Documentação do Gemini CLI MCP
Amazon Quick Suite	Guia de integração MCP

O Atlassian Rovo MCP Server também oferece suporte a qualquer cliente local compatível com MCP que possa ser executado em localhost e se conectar ao servidor por meio do proxy mcp-remote. Isso permite integrações personalizadas ou de terceiros que sigam a especificação MCP.

[!TIP] Para obter a lista atual e canônica de clientes suportados e a configuração passo a passo, consulte Primeiros passos com o Atlassian Rovo MCP Server. Você também pode consultar a documentação MCP do seu cliente ou o assistente integrado.

Produtos e ferramentas suportados

As ferramentas são organizadas por produto e intenção (ler, escrever ou pesquisar). Os administradores da organização concedem ou revogam o acesso no nível do grupo de permissões, e cada ferramenta herda o acesso do seu grupo pai.

Produto	Grupos de permissão	OAuth 2.1	Token de API
Jira	`read` · `write` · `search`	✅	✅
Confluence	`read` · `write` · `search`	✅	✅
Jira Service Management	`read` · `write`	—	✅ (somente)
Bitbucket Cloud	`read` · `write`	—	✅ (com escopo, somente)
Compass	`read` · `write`	✅ (somente)	—
Plataforma Atlassian	`read_teamwork_graph` · `search_atlassian`	✅	✅

[!NOTE] As ferramentas do Jira Service Management e do Bitbucket Cloud estão disponíveis somente via autenticação por token de API, enquanto as ferramentas do Compass estão disponíveis somente via OAuth 2.1. Para obter a referência completa e atual das ferramentas, consulte Ferramentas suportadas.

Antes de começar

Verifique se seu ambiente atende a estes requisitos antes de configurar o servidor.

Pré-requisitos

Os requisitos dependem de como você se conecta:

Para clientes suportados

Um site Atlassian Cloud com um ou mais dos produtos: Jira, Confluence, Jira Service Management, Bitbucket ou Compass
Acesso ao cliente de sua escolha
Um navegador moderno para concluir o fluxo de autorização OAuth 2.1 ou credenciais de token de API para autenticação headless

Para IDEs ou clientes locais (configuração desktop)

Um site Atlassian Cloud com um ou mais produtos suportados
Uma IDE suportada (por exemplo, Claude Desktop, VS Code ou Cursor) ou um cliente personalizado compatível com MCP
Node.js v18+ instalado para executar o proxy MCP local (mcp-remote)
Um navegador moderno para concluir o login OAuth ou credenciais de token de API para autenticação headless

Dados e segurança

O servidor aplica vários controles de segurança:

Todo o tráfego é criptografado em trânsito por HTTPS (TLS 1.2 ou posterior), de acordo com as práticas de segurança da Atlassian.
A autenticação por OAuth 2.1 e token de API fornece controle de acesso seguro.
O acesso aos dados respeita as permissões de usuário do Jira, Confluence, Jira Service Management, Bitbucket e Compass.
Se sua organização usa lista de permissões de IP para produtos Atlassian Cloud, as chamadas de ferramentas feitas por meio do Atlassian Rovo MCP Server também respeitam essas regras de IP.

Para uma visão geral mais aprofundada do modelo de segurança e dos controles administrativos, consulte:

Como funciona

Arquitetura e comunicação

Um cliente suportado se conecta ao endpoint do servidor. O endpoint recomendado para a maioria dos clientes é:
```
https://mcp.atlassian.com/v1/mcp/authv2
```
O endpoint https://mcp.atlassian.com/v1/mcp também é suportado (por exemplo, para configurações de token de API).
Dependendo da sua configuração, um fluxo seguro de OAuth 2.1 baseado em navegador é acionado ou a autenticação por token de API é usada.
Uma vez autorizado, o cliente transmite dados contextuais e recebe respostas em tempo real de seus produtos Atlassian conectados.

[!NOTE] O endpoint legado de Server-Sent Events (https://mcp.atlassian.com/v1/sse) ainda é suportado, mas recomendamos atualizar quaisquer clientes personalizados configurados para usar /sse para que agora apontem para /mcp (ou /mcp/authv2).

Gerenciamento de permissões

O acesso é concedido apenas aos dados que o usuário já tem permissão para visualizar no Atlassian Cloud. Todas as ações respeitam as funções existentes no nível do projeto ou espaço. A autenticação OAuth e por token de API respeitam os escopos configurados e as permissões da Atlassian.

Autenticação por token de API (headless)

A autenticação por token de API está disponível para configurações de cliente headless, estilo serviço ou não interativas (por exemplo, sistemas de backend ou automações). Ela também é necessária para as ferramentas do Jira Service Management e Bitbucket Cloud.

Habilitação pelo administrador necessária: Um administrador da organização deve habilitar a autenticação por token de API para o Rovo MCP Server (Administração Atlassian → Rovo → Servidor Rovo MCP → Autenticação).
Token com escopo necessário: Crie um token de API pessoal com os escopos necessários para as ferramentas e dados que você precisa acessar.
Guia de configuração: Configurar autenticação via token de API
Referência de configuração do administrador: Controlar as configurações do Atlassian Rovo MCP Server: Configurar autenticação

Exemplos de fluxos de trabalho

Uma vez conectado, você pode executar tarefas como estas a partir do seu cliente.

Fluxos de trabalho do Jira

Pesquisar: "Encontre todos os bugs abertos no Projeto Alpha."
Criar/atualizar: "Crie uma história intitulada 'Redesenhar integração'."
Criar em lote: "Crie cinco itens do Jira a partir destas notas."

Fluxos de trabalho do Confluence

Resumir: "Resuma a página de planejamento do Q2."
Criar: "Crie uma página intitulada 'Metas da Equipe Q3'."
Navegar: "A quais espaços eu tenho acesso?"

Fluxos de trabalho do Compass

Criar: "Crie um componente de serviço baseado no repositório atual."
Criar em lote: "Importe componentes e campos personalizados deste CSV/JSON."
Consultar: "O que depende do serviço api-gateway?"

Tarefas combinadas

Vincular conteúdo: "Vincule estes três tickets do Jira à página 'Plano de Lançamento'."
Encontrar documentação: "Busque a página de documentação do Confluence vinculada a este componente do Compass."

[!NOTE] As capacidades reais variam dependendo do seu nível de permissão e da plataforma do cliente.

Dicas e truques

Defina CloudId, projeto Jira e espaço Confluence padrão

Atualize seu AGENTS.md com o Markdown abaixo para reduzir chamadas de ferramentas de descoberta, economizar tempo e tokens e definir o máximo de resultados de pesquisa.

## Atlassian Rovo 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.

Use habilidades

Se você estiver usando um cliente desktop como o Claude, poderá criar ou reutilizar habilidades para tarefas repetidas. Veja as habilidades padrão do Rovo MCP.

Para o Cursor, as habilidades fazem parte do plugin do marketplace.

Notas do administrador: gerenciando o acesso

Se você é um administrador preparando sua organização para usar o Atlassian Rovo MCP Server, revise os pontos abaixo. Para orientações administrativas mais detalhadas, consulte:

Instalação e acesso

Não é um aplicativo do Marketplace: O Atlassian Rovo MCP Server não é instalado pelo Atlassian Marketplace ou pela tela Gerenciar apps. Em vez disso, ele é instalado automaticamente na primeira vez que um usuário conclui o fluxo de consentimento OAuth 2.1 (3LO) (instalação just-in-time, ou "carregamento preguiçoso").
Requisitos para a primeira instalação: O primeiro usuário a concluir o fluxo de consentimento 3LO para o seu site deve ter acesso aos aplicativos Atlassian solicitados pelos escopos do MCP (por exemplo, Jira e/ou Confluence). Isso garante que o app MCP seja registrado com as permissões corretas para o seu site.
Acesso de usuários subsequentes: Após a instalação inicial, usuários com acesso a apenas um aplicativo Atlassian (por exemplo, apenas Jira ou apenas Confluence) também podem concluir o fluxo 3LO para acessar esse aplicativo por meio do MCP.

Gerenciar, monitorar e revogar acesso

Controles de administrador: Administradores do site e da organização podem gerenciar, revisar ou revogar o acesso do app MCP em Gerenciar os apps do Marketplace e de terceiros da sua organização. O app aparece na lista de Apps conectados do seu site após o primeiro consentimento 3LO bem-sucedido.
Controles de domínio: Use a página de configurações do Rovo MCP server na Administração do Atlassian para controlar quais ferramentas de IA externas e domínios têm permissão para se conectar. Por padrão, os domínios suportados pela Atlassian são permitidos; você pode adicionar domínios confiáveis ou bloquear os suportados. Os controles de domínio se aplicam a conexões OAuth 2.1. Para detalhes, veja Domínios disponíveis do Atlassian Rovo MCP server.
Controles de IP: Se sua organização usa lista de permissões de IP para aplicativos Atlassian Cloud, as solicitações feitas por meio do Atlassian Rovo MCP Server devem se originar de um endereço IP permitido pela lista de permissões de IP da sua organização para o aplicativo relevante. Para detalhes de configuração, veja Especificar endereços IP para acesso ao produto.
Controles de usuário final: Usuários individuais podem revogar suas próprias autorizações de aplicativos nas configurações de perfil.
Registro de auditoria: Toda vez que uma ferramenta é usada por meio do Atlassian Rovo MCP Server, um evento é registrado no log de auditoria da sua organização. Os administradores podem revisá-los na Administração do Atlassian em Insights → Log de auditoria (filtre por Ações de usuário do Rovo MCP ou pesquise MCP). Para mais informações, veja Monitorar a atividade do Atlassian Rovo MCP server.

Solução de problemas comuns

Erro "O administrador do seu site deve autorizar este aplicativo": Um administrador do site deve concluir o fluxo de consentimento 3LO antes que qualquer outra pessoa possa usar o app MCP. Veja Erro "O administrador do seu site deve autorizar este aplicativo" em aplicativos Atlassian Cloud para mais detalhes.
"Você não tem permissão para se conectar deste endereço IP. Solicite acesso ao seu administrador." Isso geralmente indica que a lista de permissões de IP está ativada e o endereço IP atual do usuário não tem permissão para acessar Jira, Confluence, Jira Service Management, Bitbucket ou Compass por meio do Atlassian Rovo MCP Server. Peça ao administrador do site ou da organização para revisar a configuração da lista de permissões de IP e adicionar os intervalos de IP de rede ou VPN relevantes, se apropriado.
App não aparece em Apps conectados: Certifique-se de que o usuário está usando a conta e o site Atlassian corretos e confirme se o app está solicitando os escopos corretos do aplicativo Atlassian (por exemplo, escopos do Jira). Se os problemas persistirem, verifique Gerenciar os apps do Marketplace e de terceiros da sua organização ou entre em contato com o Suporte Atlassian. Verifique também as permissões de produto do usuário na Administração do Atlassian.

Segurança

O Model Context Protocol (MCP) permite que agentes de IA se conectem a ferramentas e dados do Atlassian usando as permissões da sua conta, o que cria fluxos de trabalho poderosos, mas também riscos estruturais. Qualquer cliente ou servidor MCP que você habilitar (por exemplo, plugins de IDE, aplicativos de desktop, servidores MCP hospedados ou integrações de "um clique") pode fazer com que um agente de IA execute ações em seu nome.

Modelos de linguagem grandes (LLMs) são vulneráveis a injeção de prompt e ataques relacionados (como injeção indireta de prompt e envenenamento de ferramentas). Esses ataques podem instruir o agente a exfiltrar dados ou fazer alterações não intencionais sem solicitações explícitas.

Para reduzir o risco, use apenas clientes e servidores MCP confiáveis, revise cuidadosamente quais ferramentas e dados cada agente pode acessar e aplique o princípio do menor privilégio (tokens com escopo definido, acesso mínimo a projetos/workspaces). Para qualquer ação de alto impacto ou destrutiva, exija confirmação humana e monitore os logs de auditoria em busca de atividades incomuns. Recomendamos fortemente revisar a orientação da Atlassian sobre riscos do MCP em Clientes MCP: Entendendo os potenciais riscos de segurança.

Suporte e feedback

Usamos seu feedback para melhorar o Atlassian Rovo MCP Server. Se você encontrar um bug ou limitação, ou tiver uma sugestão:

Visite o Portal de Suporte Atlassian para relatar problemas e solicitações de recursos.
Compartilhe suas experiências e perguntas na Comunidade Atlassian, e questões relacionadas a desenvolvimento na Comunidade de Desenvolvedores Atlassian.
Acesse nosso Portal do Desenvolvedor do Ecossistema se você estiver criando um aplicativo e encontrou um bug ou problema, ou tiver sugestões.

Aviso legal

Clientes MCP podem realizar ações no Jira, Confluence, Jira Service Management, Bitbucket e Compass com suas permissões existentes. Use o princípio do menor privilégio, revise alterações de alto impacto antes de confirmar e monitore os logs de auditoria em busca de atividades incomuns.

Saiba mais: Clientes MCP: Entendendo os potenciais riscos de segurança.