Atlassian MCP Server

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

Atlassian 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, Compass, Loom e à plataforma Atlassian como um todo — alimentado pelo seu Teamwork Graph.

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

---

O servidor oficial Atlassian 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 Jira, Confluence, Jira Service Management, Bitbucket, Compass, Loom e dados da plataforma Atlassian (Projects, Goals, Teams, Focus, Talent e Teamwork Graph) em tempo real. A autenticação usa OAuth 2.1 ou API tokens, então cada ação respeita os controles de acesso existentes do usuário.

Com o Atlassian MCP Server, você pode:

• Resumir e pesquisar em Jira, Jira Service Management, Confluence, Bitbucket, Projects, Goals e muito mais sem alternar de ferramenta.
• Recuperar e revisar gravações de vídeos e reuniões do Loom.
• Criar e atualizar itens de trabalho ou páginas com base em comandos em linguagem natural.
• Automatizar trabalhos repetitivos, como gerar itens de trabalho a partir de notas de reunião ou especificações.

Conecte uma vez e depois descreva o que você quer — sem alternar de aba e sem copiar e colar. Sua IA seleciona e executa as ações certas.

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

[!IMPORTANT] v2 agora é a versão recomendada. Novas configurações devem usar https://mcp.atlassian.com/v2/mcp, que expõe mais ferramentas e mais produtos. Conexões v1 existentes começam automaticamente a expor e usar ferramentas v2; clientes incompatíveis podem precisar limpar IDs de cliente em cache ou credenciais .well-known para continuar autenticando. Para etapas de configuração, consulte Introdução ao Atlassian MCP Server.

Configuração em um clique

Escolha seu cliente de IA abaixo para instalar o servidor oficial Atlassian 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 Referencie issues e registre horas de trabalho 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.

Deixe seu agente fazer a configuração

A maioria dos agentes de codificação de IA pode instalar, autenticar e configurar o servidor sozinho. Copie e cole este prompt no seu agente:

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 adicione o servidor manualmente com o comando do seu próprio cliente:

Cliente	Comando ou configuração
Claude Code	claude mcp add --transport http atlassian https://mcp.atlassian.com/v2/mcp, depois execute /mcp em uma sessão para autenticar
Codex	codex mcp add atlassian --url https://mcp.atlassian.com/v2/mcp
Claude Desktop	Configurações → Extensões → Procurar extensões → Plugins, depois pesquise por Atlassian
Codex Desktop	Plugins ou Connectors, depois instale Atlassian Rovo
VS Code / GitHub Copilot	Visualização de extensões → pesquise @mcp Atlassian → Instalar
Cursor	Plugin Atlassian para Cursor com MCP → Adicionar ao Cursor
Windsurf	Cascade → MCP servers → Add Server → Add custom server, com serverUrl definido como https://mcp.atlassian.com/v2/mcp
Qualquer outro cliente MCP	Use a URL do servidor https://mcp.atlassian.com/v2/mcp

Conteúdo

• Configuração em um clique
• Clientes compatíveis
• Empacotamento e compatibilidade de plugins
• Produtos e ferramentas compatíveis
• Como o servidor expõe ferramentas
• MCP gateways
• 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 MCP Server funciona com uma lista crescente de clientes compatíveis com MCP:

Cliente	Referência de configuração
OpenAI ChatGPT	Guia de Connectors / MCP
OpenAI Codex (CLI e Desktop)	Documentação MCP do Codex
Claude (Claude.ai, Desktop e Code)	Documentação MCP do Claude
Cursor	Atlassian no marketplace do 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
Windsurf	Documentação MCP do Windsurf
Docker	Catálogo e Toolkit MCP do Docker
Kiro e outros clientes de Agent Plugins	Documentação do Kiro Powers
Amazon Quick Suite	Guia de integração MCP

O Atlassian MCP Server também suporta qualquer cliente MCP local compatível que possa rodar em localhost e se conectar ao servidor via 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 Introdução ao Atlassian 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

As skills em skills/ têm como alvo o endpoint /v2/mcp e são o que todo plugin empacotado instala. A geração anterior está arquivada em skills/v1/ para quem ainda usa um endpoint v1; ela não é instalada por nenhum plugin e é configurada manualmente. Consulte skills/README.md para ver as diferenças.

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; 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. Manifestos específicos de clientes 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 (ler, escrever, pesquisar, excluir ou gerenciar). 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	API token
Jira	read_jira · write_jira · search_jira	✅	✅
Jira (habilitado por admin)	delete_jira · manage_jira	✅	✅
Confluence	read_confluence · write_confluence · search_confluence	✅	✅
Bitbucket Cloud	read_bitbucket · write_bitbucket	✅	✅
Jira Service Management	read_jsm · write_jsm	—	✅ (somente)
Plataforma Atlassian	read_teamwork_graph · write_teamwork_graph · search_atlassian	✅	✅
Loom	read_loom · write_loom	✅	✅
Goals	read_goals · write_goals	✅	✅
Projects	read_projects · write_projects	✅	✅
Teams	read_teams · write_teams	✅	✅
Focus	read_focus · write_focus	✅	✅
Talent	read_talent · write_talent	✅	✅
Compass	read_compass · write_compass	✅ (somente)	—

Condições específicas do produto:

• delete_jira e manage_jira estão desabilitados por padrão e precisam ser habilitados por um administrador antes de serem usados.
• As ferramentas do Bitbucket Cloud só estão disponíveis se o seu workspace do Bitbucket estiver vinculado a uma organização. Workspaces que não estão vinculados a uma organização não podem ser selecionados durante a autenticação.
• As ferramentas do Jira Service Management só suportam autenticação via token de API e só estão disponíveis se um administrador da organização tiver habilitado a autenticação por token de API.
• As ferramentas do Loom só estão disponíveis para workspaces do Loom vinculados a um site da Atlassian.
• As ferramentas do Teamwork Graph podem recuperar dados de serviços de terceiros conectados ao Jira, como pull requests, builds e deployments vinculados. Para o GitHub for Atlassian, acesso total significa que as ferramentas recuperam dados do GitHub com base nas permissões do usuário no GitHub, enquanto acesso limitado significa que elas recuperam dados com base nas permissões do usuário no Jira. Os conectores do Azure DevOps, GitLab, Jenkins e Spinnaker seguem o modelo de acesso limitado.

[!NOTE] Para a referência completa e atual das ferramentas, incluindo o escopo necessário para cada grupo de permissões, consulte Ferramentas suportadas.

---

Como o servidor expõe as ferramentas

Em vez de enviar todas as definições de ferramentas ao cliente de IA no momento da conexão, o Atlassian MCP Server expõe um pequeno conjunto das ferramentas mais usadas e permite que o cliente descubra o restante sob demanda. As ferramentas marcadas como Primárias ficam visíveis diretamente para os agentes.

Isso traz dois benefícios:

• O contexto do seu cliente fica livre para a tarefa em questão, em vez de ser preenchido com definições de ferramentas.
• Novas ferramentas ficam disponíveis sem que o cliente precise se reconectar.

Gateways MCP

Se você estiver usando um gateway MCP ou precisar que todas as ferramentas estejam disponíveis antecipadamente, em vez de usar os métodos de descoberta e execução, use a substituição tools=all para expor todas as ferramentas como uma lista plana paginada:

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

---

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 suportados

• Um site Atlassian Cloud com um ou mais dos seguintes 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

Se o administrador da sua organização desabilitou a autenticação via token de API, os clientes MCP não podem se conectar com um token e precisam usar OAuth 2.1.

Para IDEs ou clientes locais (configuração de 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 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 fornecem controle de acesso seguro.
• O acesso aos dados respeita as permissões do usuário em todos os produtos Atlassian conectados, incluindo Jira, Confluence, Jira Service Management, Bitbucket, Compass e Loom.
• Se a sua organização usa allowlisting de IP para produtos Atlassian Cloud, as chamadas de ferramentas feitas por meio do Atlassian MCP Server também respeitam essas regras de IP.

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

• Entenda o Atlassian MCP Server
• Controle as configurações do Atlassian MCP Server

---

Como funciona

Arquitetura e comunicação

1. Um cliente suportado se conecta ao endpoint do servidor. O endpoint recomendado para todos os clientes é:

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

   Os endpoints v1 (https://mcp.atlassian.com/v1/mcp/authv2 e https://mcp.atlassian.com/v1/mcp) continuam suportados, e as conexões v1 existentes passam automaticamente a expor e usar as ferramentas v2.

2. 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.

3. Uma vez autorizado, o cliente transmite dados contextuais e recebe respostas em tempo real dos seus produtos Atlassian conectados.

[!WARNING] Após 30 de junho de 2026, o endpoint legado de Server-Sent Events (https://mcp.atlassian.com/v1/sse) não será mais suportado. Atualize quaisquer clientes personalizados configurados para usar /sse para que apontem para /mcp — de preferência https://mcp.atlassian.com/v2/mcp.

[!NOTE] Clientes que não conseguirem concluir a autenticação após a migração para as ferramentas v2 podem precisar limpar os IDs de cliente em cache ou as credenciais .well-known.

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 de 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 clientes headless, estilo serviço ou não interativas (por exemplo, sistemas de backend ou automações). Ela também é obrigatória para as ferramentas do Jira Service Management.

Dois mecanismos são suportados:

Mecanismo	Cabeçalho
Token de API pessoal (autenticação básica)	Authorization: Basic <base64(email:api_token)>
Chave de API de conta de serviço (token Bearer)	Authorization: Bearer <api_key>

• Habilitação pelo administrador obrigatória: Um administrador da organização deve habilitar a autenticação por token de API para o Atlassian MCP Server (Administração Atlassian → Rovo → Servidor Rovo MCP → Autenticação).
• Token com escopo obrigatório: Crie um token de API pessoal ou peça ao seu administrador uma chave de API de conta de serviço, com os escopos necessários para as ferramentas e os 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 MCP Server: Configurar autenticação

---

Fluxos de trabalho de exemplo

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'."
• Criar 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 eu tenho acesso?"

Fluxos de trabalho do Compass

• Criar: "Crie um componente de serviço com base no repositório atual."
• Criar em massa: "Importe componentes e campos personalizados deste CSV/JSON."
• Consultar: "Do que depende o serviço api-gateway?"

Fluxos de trabalho do Loom

• Recuperar: "Encontre a gravação do Loom da revisão de design da semana passada."
• Resumir: "Resuma este passo a passo do Loom e liste os itens de ação."

Fluxos de trabalho de Projetos e Metas

• Status: "Qual é o status atual do projeto Checkout Revamp?"
• Consolidar: "Quais metas estão em risco neste trimestre e por quê?"

Tarefas combinadas

• Vincular conteúdo: "Vincule estes três itens de trabalho 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."
• Avançar o trabalho: "Mova PROJ-456 para 'Em revisão' e adicione um comentário de que o PR está no ar."

[!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 Confluence

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

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

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 Atlassian MCP.

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

---

Notas do administrador: gerenciando o acesso

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

• Entenda o Atlassian MCP Server
• Controle as configurações do Atlassian MCP Server
• Gerencie o Atlassian MCP Server
• Monitore a atividade do Atlassian MCP Server

Gerenciar, monitorar e revogar acesso

• Controles do administrador: Administradores de site e de organização podem gerenciar, revisar ou revogar o acesso do aplicativo MCP em Gerenciar os aplicativos de Marketplace e de terceiros da sua organização.
• Controles de domínio: Use a página de configurações do Servidor Rovo MCP na Administração Atlassian para controlar quais ferramentas e domínios de IA externos podem 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 às conexões OAuth 2.1. Para detalhes, consulte Domínios disponíveis do servidor Atlassian MCP.
• Controles de IP: Se a sua organização usa allowlisting de IP para aplicativos Atlassian Cloud, as solicitações feitas por meio do Atlassian MCP Server devem se originar de um endereço IP permitido pela allowlist de IP da sua organização para o aplicativo relevante. Para detalhes de configuração, consulte Especificar endereços IP para acesso ao produto. As restrições de IP do Bitbucket Cloud são configuradas separadamente pelos administradores do workspace em Configurações do workspace → Controles de acesso. Consulte Controlar o acesso a conteúdo privado em um workspace.
• Controles do usuário final: Usuários individuais podem revogar suas próprias autorizações de aplicativo nas configurações do perfil.
• Registro de auditoria: Toda vez que uma ferramenta é usada por meio do Atlassian MCP Server, um evento é registrado no registro de auditoria da sua organização. Os administradores podem revisá-los na Administração Atlassian em Insights → Registro de auditoria (filtre por Ações do usuário do Rovo MCP ou pesquise MCP). Para mais informações, consulte Monitore a atividade do servidor Atlassian MCP.

Solução de problemas comuns

• "Você não tem permissão para se 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 de origem da solicitação não tem permissão para acessar o aplicativo relevante via Atlassian MCP Server. Peça ao administrador do seu site, organização ou workspace do Bitbucket para revisar a allowlist de IP aplicável.

  Clientes de IA hospedados podem enviar solicitações a partir dos endereços IP de saída do provedor de IA, em vez da rede corporativa ou VPN do usuário. Estar em uma VPN permitida pode, portanto, ser insuficiente. Peça ao seu administrador para revisar os intervalos de IP de saída publicados pelo provedor e aprovar o acesso necessário. Para conectores hospedados pela OpenAI, consulte orientação de egresso de IP da OpenAI. Conexões MCP locais podem usar o endereço IP de saída da rede local. Consulte como o allowlisting de IP funciona com o Atlassian MCP.

• O login OAuth é bem-sucedido, mas as chamadas de ferramentas retornam 403. Um login bem-sucedido não garante que as chamadas de ferramentas passarão pelas restrições de IP. Um 403 também pode indicar escopos insuficientes, permissões de aplicativo ou outra política de acesso. Confirme o motivo da negação antes de alterar uma allowlist de IP.

---

Segurança

O Model Context Protocol (MCP) permite que agentes de IA se conectem a ferramentas e dados da 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 "com 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 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 limitado, 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 as orientações da Atlassian sobre riscos do MCP em MCP Clients: Understanding the potential security risks.

---

Suporte e feedback

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

• Visite o Portal de Suporte da Atlassian para relatar problemas e solicitar recursos.
• Compartilhe suas experiências e dúvidas na Comunidade Atlassian, e perguntas relacionadas a desenvolvimento na Comunidade de Desenvolvedores Atlassian.
• Acesse nosso Portal do Desenvolvedor de Ecossistemas se você estiver criando um aplicativo e encontrou um bug ou problema, ou tiver sugestões.

---

Aviso legal

Os clientes MCP podem executar ações nos produtos Atlassian 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: MCP Clients: Understanding the potential security risks.