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 .envConteúdo do .env:
ATLASSIAN_API_TOKEN=seu_token
[email protected]
ATLASSIAN_SITE=nomedosite.atlassian.netRodando o servidor:
yarn install
yarn devTestando endpoints:
GET /spacesGET /pages?spaceKey=ENGGET /issues?jql=assignee=currentUser() AND status="In Progress"
Outros MCPs que vale conhecer
mcp-github: para navegar, buscar e criar issues/PRs diretamente no GitHubmcp-google-drive: leitura e escrita em arquivos do Drive e Google Docsmcp-postgres: acesso a banco de dados PostgreSQL com estrutura de schemamcp-filesystem: acesso local a arquivos com leitura e escrita assistidamcp-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.
