Close Menu
Código Simples .NETCódigo Simples .NET
    Facebook X (Twitter) Instagram
    Trending
    • Guia Completo: Integrando o MCP com Atlassian
    • Model Context Protocol (MCP): O Futuro da Interação com Modelos de IA
    • Processamento Assíncrono: Os Desafios da Escalabilidade
    • NewSQL em 2025: O Estado Atual, Tendências e o Futuro dos Bancos de Dados Relacionais Escaláveis
    • 12 Regras Essenciais para Reduzir a Latência de Aplicações
    • Cache Hit Ratio: Como uma Simples Métrica Pode Revolucionar sua Arquitetura
    • Como a Uber calcula o tempo estimado de chegada
    • 30 APIs Gratuitas para desenvolvedores
    Facebook X (Twitter) Instagram
    Código Simples .NETCódigo Simples .NET
    Código Simples .NETCódigo Simples .NET
    Home»Boas práticas»Gestão & Produtividade»Guia Completo: Integrando o MCP com Atlassian

    Guia Completo: Integrando o MCP com Atlassian

    Jhonathan SoaresBy Jhonathan Soares5 de junho de 20255 Mins Read Gestão & Produtividade
    Share
    Facebook Twitter LinkedIn WhatsApp Copy Link

    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.


    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.

    ia jira mcp
    Share. Facebook Twitter LinkedIn Telegram WhatsApp Copy Link
    Jhonathan Soares
    • Website
    • Facebook
    • X (Twitter)
    • LinkedIn

    Criador do blog Código Simples e com mais 15 anos de experiência em TI, com títulos de MVP Microsoft na área de Visual Studio Development, Neo4j Top 50 Certificate, Scrum Master e MongoDB Evangelist.

    Posts Relacionados

    Model Context Protocol (MCP): O Futuro da Interação com Modelos de IA

    IA 22 de maio de 20257 Mins Read

    O Impacto das Interrupções no trabalho e como mitigá-las

    Gestão & Produtividade 17 de junho de 20245 Mins Read

    Um guia de estudos resumido sobre IA Generativa

    IA 3 de junho de 202414 Mins Read
    Newsletter

    Digite seu endereço de e-mail para receber notificações de novas publicações por e-mail.

    Junte-se a 25mil outros assinantes
    Posts recentes
    • Guia Completo: Integrando o MCP com Atlassian
    • Model Context Protocol (MCP): O Futuro da Interação com Modelos de IA
    • Processamento Assíncrono: Os Desafios da Escalabilidade
    • NewSQL em 2025: O Estado Atual, Tendências e o Futuro dos Bancos de Dados Relacionais Escaláveis
    • 12 Regras Essenciais para Reduzir a Latência de Aplicações
    Categorias
    • Arquitetura (15)
      • Testes (2)
    • Asp.net (120)
      • C# (89)
      • Mvc (13)
    • Banco de dados (90)
      • NoSql (58)
      • Sql (38)
    • Boas práticas (30)
      • Gestão & Produtividade (2)
      • Metodologias Ágeis (6)
    • Cursos (52)
    • Dicas (105)
    • Front-End (92)
    • IA (3)
    • Linux (6)
    • NodeJS (4)
    • Post do Leitor (9)
    • Python (5)
    • Seo (12)
    • Tecnologia (30)
      • ITIL (1)
      • Padrões de Projeto (4)
    • Testes (2)

    VEJA TAMBÉM

    Cursos
    12 de fevereiro de 20166 Mins Read

    1000 livros gratuitos sobre programação!

    Olha que dica bacana! A pagina só com livros sobre programação é mantida no GitHub…

    30 APIs Gratuitas para desenvolvedores

    Facebook X (Twitter) Instagram LinkedIn

    Type above and press Enter to search. Press Esc to cancel.

    Vá para versão mobile