kwb-atlassian-mcp

O que kwb-atlassian-mcp faz?

Habilidade para agentes de IA que utiliza o MCP da Atlassian para acessar JIRA e Confluence.

Funcionalidades

JIRA

• Criar issues (com tipo, projeto, resumo, descrição, prioridade, etc.)
• Atualizar issues (status, atribuição, resumo, etc.)
• Buscar issues por ID ou consulta JQL
• Listar projetos disponíveis
• Obter detalhes de boards e sprints
• Adicionar comentários a issues
• Anexar arquivos a issues

Confluence

• Buscar páginas por título ou conteúdo
• Criar novas páginas
• Atualizar conteúdo de páginas existentes
• Listar espaços disponíveis

Pré-requisitos

• Node.js 18 ou superior
• Conta Atlassian com acesso ao JIRA e/ou Confluence
• Token de acesso pessoal da Atlassian

Configuração

1. Gere um token de acesso pessoal em: https://id.atlassian.com/manage/api-tokens
2. Defina as seguintes variáveis de ambiente:

export ATLASSIAN_HOST="sua-instancia.atlassian.net"
export ATLASSIAN_EMAIL="[email protected]"
export ATLASSIAN_API_TOKEN="seu-token-aqui"

Uso com agentes de IA

Cursor

Adicione ao arquivo .cursor/mcp.json:

{
  "mcpServers": {
    "atlassian": {
      "command": "npx",
      "args": ["-y", "@KWB-SchMa/kwb-atlassian-mcp"],
      "env": {
        "ATLASSIAN_HOST": "sua-instancia.atlassian.net",
        "ATLASSIAN_EMAIL": "[email protected]",
        "ATLASSIAN_API_TOKEN": "seu-token-aqui"
      }
    }
  }
}

Claude Code

Configure o servidor MCP conforme a documentação do Claude Code.

Codex

Utilize a configuração padrão de servidores MCP do Codex.

Comandos disponíveis

JIRA

• list_projects - Lista todos os projetos do JIRA
• get_issue - Busca detalhes de uma issue pelo ID
• search_issues - Busca issues usando JQL
• create_issue - Cria uma nova issue
• update_issue - Atualiza uma issue existente
• add_comment - Adiciona comentário a uma issue
• get_sprints - Lista sprints de um board

Confluence

• search_pages - Busca páginas no Confluence
• get_page - Obtém detalhes de uma página específica
• create_page - Cria uma nova página no Confluence
• update_page - Atualiza uma página existente

Exemplos

# Criar uma issue no JIRA
mcp_call create_issue \
  project: "PROJ" \
  summary: "Minha nova issue" \
  description: "Descrição detalhada" \
  issuetype: "Task"

# Buscar páginas no Confluence
mcp_call search_pages \
  query: "documentação técnica" \
  limit: 10

Solução de problemas

• Verifique se as variáveis de ambiente estão configuradas corretamente
• Confirme que o token de API tem permissões adequadas
• Certifique-se de que o host da Atlassian está acessível

Licença

MIT