Guia Completo: Integrando o MCP com Atlassian

O Model Context Protocol (MCP) é uma proposta emergente que define um padrão para conectar modelos de linguagem com sistemas reais de forma estruturada e segura. Ao funcionar como uma camada de integração semântica, ele permite que copilotos de IA consultem fontes como bancos de dados, sistemas de arquivos, CRMs ou — como neste caso — ferramentas da Atlassian, como Jira e Confluence.

Se você já entendeu os fundamentos do MCP no nosso artigo introdutório, este guia mostra como aplicar o conhecimento na prática. Você aprenderá a integrar o MCP com sua IDE (Cursor) e também a rodá-lo localmente, aproveitando ao máximo o potencial do mcp-atlassian.

Por isso, dando continuidade ao nosso artigo sobre o Model Context Protocol (MCP), este guia prático mostra como utilizar o projeto mcp-atlassian para conectar modelos de linguagem ao seu espaço de trabalho Atlassian — seja localmente ou integrado ao Cursor IDE.

Se você quer permitir que assistentes de IA acessem, leiam e contextualizem conteúdos de Confluence e Jira, este tutorial é para você.

O que você poderá fazer com esse MCP

📝 Confluence:

• “Busque por páginas sobre ‘arquitetura de microsserviços’ no espaço DEV”
• “Crie uma nova página no espaço PSC chamada ‘Guia de Deploy’ com o conteúdo que acabamos de conversar”
• “Atualize a página com ID 12345 adicionando uma seção de segurança”
• “Liste os espaços disponíveis no Confluence”

🎫 Jira:

• “Liste todos os tickets atribuídos a mim no projeto ‘PLATFORMS’ em andamento”
• “Crie um novo ticket com título ‘Erro ao logar no app’ e atribua ao time de backend”
• “Altere o status do ticket ABC-123 para ‘Em Testes'”
• “Adicione um comentário no ticket DEF-456: ‘Revisado e validado pelo QA'”

📊 Casos de uso avançados:

• “Gere um relatório de bugs abertos nos últimos 30 dias por projeto”
• “Crie uma página em Confluence com resumo dos tickets finalizados nesta sprint”
• “Compare o número de issues abertos entre os times da squad X no último mês”
• “Documente as mudanças desta release automaticamente”

---

Entendendo o MCP e o mcp-atlassian

O mcp-atlassian é um servidor MCP que atua como ponte entre o ecossistema Atlassian (Jira e Confluence) e qualquer modelo de linguagem compatível com o protocolo. Na arquitetura do MCP, ele é o servidor que expõe dados estruturados; o host (por exemplo, o Cursor IDE) é o ambiente onde o modelo de linguagem opera; e o cliente é o intermediário que faz as chamadas entre ambos.

A beleza do MCP é que ele abstrai o acesso a sistemas corporativos por meio de uma API semântica, com estrutura padronizada. Isso viabiliza copilotos de IA que “entendem” seu contexto de trabalho real — seja seu backlog no Jira ou sua documentação viva no Confluence.

---

Como conectar o MCP ao Cursor IDE

Você pode rodar o servidor MCP via Docker e conectar diretamente no Cursor. Isso transforma o chat da IDE em uma interface natural com acesso à sua base de conhecimento corporativa.

Requisitos básicos

• Cursor IDE instalado, também funciona em outras IDEs como Windsurf ou IDEs compatíveis com agentes MCP
• Docker instalado e funcionando
• Conta Atlassian com acesso ao Jira e Confluence

Passo a passo da configuração

1. Gere o token de API da Atlassian:
Acesse https://id.atlassian.com/manage-profile/security/api-tokens e crie um novo token. Nomeie como “Cursor MCP Integration” e copie o valor gerado imediatamente.

2. Crie o arquivo de configuração mcp.json:
Esse arquivo descreve o servidor MCP que será rodado via Docker. Use este template:

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "CONFLUENCE_URL",
        "-e", "CONFLUENCE_USERNAME",
        "-e", "CONFLUENCE_API_TOKEN",
        "-e", "JIRA_URL",
        "-e", "JIRA_USERNAME",
        "-e", "JIRA_API_TOKEN",
        "ghcr.io/sooperset/mcp-atlassian:latest"
      ],
      "env": {
        "CONFLUENCE_URL": "https://<seusite>.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "[email protected]",
        "CONFLUENCE_API_TOKEN": "SEU_TOKEN",
        "JIRA_URL": "https://<seusite>.atlassian.net",
        "JIRA_USERNAME": "[email protected]",
        "JIRA_API_TOKEN": "SEU_TOKEN"
      }
    }
  }
}

3. Posicione o mcp.json no local correto:

• Global: ~/.cursor/mcp.json
• Projeto: .cursor/mcp.json <= eu recomendo começar por aqui

4. Reinicie o Cursor IDE
Após reiniciar, abra o chat e pergunte algo como:

• “Você consegue acessar meu Confluence?”
• “Quais issues estão atribuídas a mim no Jira?”

---

Rodando o MCP localmente (sem usar Cursor)

Se você deseja testar ou integrar o MCP em um ambiente fora do Cursor IDE, como um servidor de copiloto próprio, é possível rodá-lo localmente com Node.js.

Requisitos

• Node.js 18+
• Yarn ou npm
• Conta Atlassian com token

Etapas:

git clone https://github.com/sooperset/mcp-atlassian.git
cd mcp-atlassian
touch .env

Conteúdo do .env:

ATLASSIAN_API_TOKEN=seu_token
[email protected]
ATLASSIAN_SITE=nomedosite.atlassian.net

Rodando o servidor:

yarn install
yarn dev

Testando endpoints:

• GET /spaces
• GET /pages?spaceKey=ENG
• GET /issues?jql=assignee=currentUser() AND status="In Progress"

---

Outros MCPs que vale conhecer

• mcp-github: para navegar, buscar e criar issues/PRs diretamente no GitHub
• mcp-google-drive: leitura e escrita em arquivos do Drive e Google Docs
• mcp-postgres: acesso a banco de dados PostgreSQL com estrutura de schema
• mcp-filesystem: acesso local a arquivos com leitura e escrita assistida
• mcp-calendar: integração com calendários corporativos (Google, Outlook)

---

Dúvidas comuns e boas práticas

O MCP altera dados por padrão?
Não. Mas se quiser garantir isso, defina:

"READ_ONLY_MODE": "true"

Posso limitar espaços ou projetos?
Sim, via filtros:

"CONFLUENCE_SPACES_FILTER": "ENG,PROD",
"JIRA_PROJECTS_FILTER": "COREAPP,PLATFORM"

É seguro?
Sim — usa tokens de API, sem persistência local. Para produção, recomenda-se logging, autenticação avançada e controle de escopo via proxy.

Informação Importante

Este tutorial, é sobre um mcp-server feito pela comunidade. A Atlassian, recentemente lançou a versão beta oficial do mcp que você pode conferir acessando o link: https://www.atlassian.com/blog/announcements/remote-mcp-server

---

Conclusão

O mcp-atlassian transforma o modelo de copilotos em algo útil e conectado à realidade. Seja dentro do Cursor ou via sua própria stack, ele permite criar experiências de IA que entendem o contexto, falam a linguagem do seu negócio e ajudam a operar sistemas críticos com mais inteligência.

Essa é a nova fronteira da produtividade com IA: copilotos com contexto real, estruturado e seguro.