Atlassian MCP Server

oficial

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

GitHub

Experimente este MCPPatrocinado

O que você pode fazer com Atlassian MCP?

Pesquisar nos produtos Atlassian — Peça ao seu assistente para encontrar issues do Jira, páginas do Confluence ou conteúdo do Bitbucket usando consultas em linguagem natural.
Criar e atualizar itens de trabalho — Faça sua IA criar histórias do Jira, atualizar issues ou gerar páginas do Confluence a partir das suas instruções.
Criação em massa de issues — Transforme notas de reunião ou especificações em vários tickets do Jira de uma só vez com uma única solicitação.
Resumir conteúdo do Confluence — Obtenha resumos concisos de páginas como o documento de planejamento do Q2 sem abrir o Confluence.
Consultar componentes do Compass — Pergunte sobre dependências de serviços, como "O que depende do serviço api-gateway?"
Vincular conteúdo relacionado — Conecte tickets do Jira a páginas do Confluence, como vincular três issues a um plano de release.

Documentação

Atlassian

Atlassian Rovo MCP Server

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

Primeiros passos · Ferramentas compatíveis · Segurança e administração · Comunidade

O servidor oficial Atlassian Rovo MCP Server é 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 de 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 de Jira, Confluence, Jira Service Management e Bitbucket sem alternar de ferramenta.
Criar e atualizar issues 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 desenvolvido para desenvolvedores, criadores de conteúdo e equipes de projeto que trabalham em IDEs ou ferramentas de IA e desejam usar dados do Atlassian sem alternar de contexto constantemente.

Configuração em um clique

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

Adicionar ao Cursor
_{Consulte issues e registre horas trabalhadas no seu código.}

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

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

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

Conteúdo

Configuração em um clique
Clientes compatíveis
Empacotamento e compatibilidade de plugins
Produtos e ferramentas compatíveis
Antes de começar
Dados e segurança
Como funciona
Exemplos de fluxos de trabalho
Dicas e truques
Notas de administração: gerenciando acesso
Segurança
Suporte e feedback
Aviso legal

Clientes compatíveis

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 MCP do Claude
Cursor	Atlassian no marketplace da Cursor
Visual Studio Code (GitHub Copilot)	Documentação MCP do VS Code
GitHub Copilot CLI	Sobre o Copilot CLI
Google Gemini CLI	Documentação MCP do Gemini CLI
Kiro e outros clientes de Agent Plugins	Documentação do Kiro Powers
Amazon Quick Suite	Guia de integração MCP

O Atlassian Rovo MCP Server também é compatível com qualquer cliente MCP local 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 a lista atual e canônica de clientes compatíveis e 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 próprio cliente ou o assistente integrado.

Empacotamento e compatibilidade de plugins

Este repositório publica o mesmo servidor MCP e as mesmas skills em vários formatos de pacote para que os clientes possam usar seus fluxos nativos de descoberta e instalação:

Formato	Manifesto e configuração	Componentes compartilhados
Agent Plugins v1	`plugin.json` e `mcp.json`	`skills/`
Plugin Claude Code	`.claude-plugin/plugin.json` e `.claude-plugin/marketplace.json`	`.mcp.json` e `skills/`
Plugin Cursor	`.cursor-plugin/plugin.json`	`.mcp.json` e `skills/`
Extensão Gemini	`gemini-extension.json`	Configuração do servidor MCP incorporada no manifesto
MCP Registry	`server.json`	Metadados do servidor remoto

Tanto mcp.json quanto .mcp.json são intencionais. O Agent Plugins exige o nome de arquivo raiz mcp.json e seu vocabulário de transporte portátil; os clientes existentes continuam usando .mcp.json e seu vocabulário de configuração nativo. Mantenha as configurações de endpoint alinhadas ao alterar qualquer um dos arquivos.

O pacote raiz pode ser importado por clientes que implementam Agent Plugins, incluindo Kiro Powers. Os manifestos específicos do cliente permanecem disponíveis e não são substituídos pelo pacote portátil.

Produtos e ferramentas compatíveis

As ferramentas são organizadas por produto e intenção (leitura, escrita ou pesquisa). Os administradores da organização concedem ou revogam 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 de Jira Service Management e 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 a referência completa e atual de ferramentas, consulte Ferramentas compatíveis.

Antes de começar

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

Pré-requisitos

Os requisitos dependem de como você se conecta:

Para clientes compatíveis

Um site Atlassian Cloud com um ou mais dos seguintes: 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 em desktop)

Um site Atlassian Cloud com um ou mais produtos compatíveis
Uma IDE compatível (por exemplo, Claude Desktop, VS Code ou Cursor) ou um cliente MCP personalizado compatível
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 via HTTPS (TLS 1.2 ou posterior), de acordo com as práticas de segurança da Atlassian.
A autenticação OAuth 2.1 e token de API fornece controle de acesso seguro.
O acesso aos dados respeita as permissões de usuário de Jira, Confluence, Jira Service Management, Bitbucket e Compass.
Se sua organização usar allowlisting de IP para produtos Atlassian Cloud, as chamadas de ferramenta feitas por meio do Atlassian Rovo MCP Server também respeitarão essas regras de IP.

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

Como funciona

Arquitetura e comunicação

Um cliente compatível 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 é compatível (por exemplo, para configurações com token de API).
Dependendo da sua configuração, um fluxo OAuth 2.1 seguro 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 dos seus produtos Atlassian conectados.

[!NOTE] O endpoint legado de Server-Sent Events (https://mcp.atlassian.com/v1/sse) ainda é compatível, mas recomendamos atualizar qualquer cliente personalizado configurado para usar /sse para que agora aponte para /mcp (ou /mcp/authv2).

Gerenciamento de permissões

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

Autenticação por token de API (headless)

A autenticação por token de API está disponível para configurações de clientes headless, de serviço ou não interativas (por exemplo, sistemas de backend ou automações). Ela também é obrigatória para as ferramentas de 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 → Rovo MCP server → 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

Depois de 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 onboarding'."
Criação em massa: "Crie cinco issues 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 do Time Q3'."
Navegar: "A quais espaços tenho acesso?"

Fluxos de trabalho do Compass

Criar: "Crie um componente de serviço com base no repositório atual."
Criação em massa: "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

Definir CloudId padrão, projeto Jira e espaço do Confluence

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.

Usar skills

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

Para Cursor, as skills fazem parte do plugin do marketplace.

Notas de administração: gerenciando 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, veja:

Instalação e acesso

Não é um aplicativo do Marketplace: O Atlassian Rovo MCP Server não é instalado via Atlassian Marketplace ou pela tela Gerenciar aplicativos. 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 "lazy loading").
Requisitos de instalação pela primeira vez: O primeiro usuário a concluir o fluxo de consentimento 3LO para seu site deve ter acesso aos aplicativos Atlassian solicitados pelos escopos do MCP (por exemplo, Jira e/ou Confluence). Isso garante que o aplicativo MCP seja registrado com as permissões corretas para 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 via MCP.

Gerenciar, monitorar e revogar acesso

Controles de administrador: Administradores de site e organização podem gerenciar, revisar ou revogar o acesso do aplicativo MCP em Gerenciar aplicativos de Marketplace e terceiros da sua organização. O aplicativo aparece na lista Aplicativos conectados do seu site após o primeiro consentimento 3LO bem-sucedido.
Controles de domínio: Use a página de configurações Rovo MCP server na Administração Atlassian para controlar quais ferramentas de IA externas e domínios podem se conectar. Por padrão, 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 allowlisting de IP para aplicativos Atlassian Cloud, as solicitações feitas através do Atlassian Rovo MCP Server devem originar-se de um endereço IP permitido pela allowlist de IP da sua organização para o aplicativo relevante. Para detalhes de configuração, veja Especificar endereços IP para acesso a produtos.
Controles do usuário final: Usuários individuais podem revogar suas próprias autorizações de aplicativo nas configurações de perfil.
Registro de auditoria: Cada vez que uma ferramenta é usada através do Atlassian Rovo MCP Server, um evento é registrado no log de auditoria da sua organização. Administradores podem revisá-los na Administração Atlassian em Insights → Log de auditoria (filtre por Rovo MCP User Actions ou pesquise MCP). Para mais informações, veja Monitore 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 aplicativo 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 conectar a partir deste endereço IP. Peça ao seu administrador acesso." Isso geralmente indica que o allowlisting de IP está habilitado e o endereço IP atual do usuário não tem permissão para acessar Jira, Confluence, Jira Service Management, Bitbucket ou Compass via Atlassian Rovo MCP Server. Peça ao administrador do site ou da organização para revisar a configuração de allowlist de IP e adicionar as faixas de rede ou VPN relevantes, se apropriado.
Aplicativo não aparecendo em Aplicativos conectados: Certifique-se de que o usuário está usando a conta e o site Atlassian corretos, e confirme que o aplicativo está solicitando os escopos corretos dos aplicativos Atlassian (por exemplo, escopos do Jira). Se os problemas persistirem, verifique Gerenciar aplicativos de Marketplace e terceiros da sua organização ou entre em contato com o Suporte Atlassian. Também verifique as permissões de produto do usuário na Administração Atlassian.

Segurança

O Model Context Protocol (MCP) permite que agentes de IA se conectem a ferramentas e dados 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 desktop, servidores MCP hospedados ou integrações "one-click") pode fazer um agente de IA executar 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 riscos, 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, acesso mínimo a projetos/workspaces). Para qualquer ação de alto impacto ou destrutiva, exija confirmação humana e monitore logs de auditoria para atividades incomuns. Recomendamos fortemente revisar a orientação da Atlassian sobre riscos do MCP em Clientes MCP: Entendendo os riscos potenciais 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 perguntas relacionadas a desenvolvedores na Comunidade de Desenvolvedores Atlassian.
Acesse nosso Portal de Desenvolvedores do Ecossistema se você estiver criando um aplicativo e encontrou um bug ou problema, ou tiver sugestões.

Aviso legal

Clientes MCP podem executar 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 logs de auditoria para atividades incomuns.

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