Jira MCP Server

Servidor MCP do Jira

Este é um servidor Model Context Protocol (MCP) que conecta o Jira ao Claude.

Recursos

• Pesquisa de issues: Pesquise issues do Jira usando JQL
• Consulta de issues: Verifique informações detalhadas de uma issue específica
• Criação de issues: Crie novas issues no Jira
• Atualização de issues: Modifique issues existentes (título, descrição, status, responsável)
• Adicionar comentários: Adicione comentários a uma issue
• Informações do projeto: Consulte informações do projeto

Instalação e configuração

1. Configuração das variáveis de ambiente

Crie o arquivo .env e insira as seguintes informações:

JIRA_URL=https://your-domain.atlassian.net
JIRA_USERNAME=your-email@domain.com
JIRA_API_TOKEN=your-api-token
DEFAULT_PROJECT_KEY=PROJ

Observação: Os arquivos de configuração são criados automaticamente na pasta config/.

2. Geração do token da API do Jira

1. Faça login no Jira
2. Acesse Configurações da conta > Segurança > Criar token da API
3. Insira o token gerado em JIRA_API_TOKEN no arquivo .env

3. Instalação das dependências

npm install

4. Configuração automática (recomendado)

Você pode configurar facilmente usando a ferramenta de configuração interativa:

npm run setup

Este comando:

• Solicita as informações de conexão do Jira
• Cria automaticamente o arquivo config/.env
• Cria automaticamente o arquivo config/claude_desktop_config.json
• Fornece instruções para configurar o Claude Desktop

5. Configuração manual (opcional)

Se preferir configurar manualmente em vez de usar a configuração automática, copie o arquivo config/.env.example e renomeie para config/.env, depois edite os valores.

6. Execução do servidor

npm start

Configuração do Claude Desktop

Para usar este servidor MCP no Claude Desktop, você precisa editar o arquivo de configuração.

Windows

Edite o arquivo %APPDATA%\\Claude\\claude_desktop_config.json:

{
  "mcpServers": {
    "jira": {
      "command": "node",
      "args": ["C:\\path\\to\\jira-mcp-server\\index.js"],
      "env": {
        "JIRA_URL": "https://your-domain.atlassian.net",
        "JIRA_USERNAME": "your-email@domain.com",
        "JIRA_API_TOKEN": "your-api-token",
        "DEFAULT_PROJECT_KEY": "PROJ"
      }
    }
  }
}

macOS

Edite o arquivo ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "jira": {
      "command": "node",
      "args": ["/path/to/jira-mcp-server/index.js"],
      "env": {
        "JIRA_URL": "https://your-domain.atlassian.net",
        "JIRA_USERNAME": "your-email@domain.com", 
        "JIRA_API_TOKEN": "your-api-token",
        "DEFAULT_PROJECT_KEY": "PROJ"
      }
    }
  }
}

Exemplos de uso

Você pode usar os seguintes comandos no Claude:

Pesquisa de issues

"프로젝트 PROJ에서 상태가 Open인 이슈들을 찾아줘"

Criação de issues

"PROJ 프로젝트에 '새로운 기능 개발' 제목으로 Task 이슈를 생성해줘"

Atualização de issues

"PROJ-123 이슈의 상태를 'In Progress'로 변경해줘"

Adicionar comentários

"PROJ-123 이슈에 '작업을 시작했습니다' 댓글을 추가해줘"

Ferramentas suportadas

1. search_issues: Pesquisa issues com JQL
2. get_issue: Consulta uma issue específica
3. create_issue: Cria uma nova issue
4. update_issue: Atualiza uma issue
5. add_comment: Adiciona um comentário
6. get_project_info: Consulta informações do projeto

Solução de problemas

Erros de autenticação

• Verifique se a URL do Jira está correta
• Verifique se o token da API é válido
• Verifique se o e-mail do usuário está correto

Erros de permissão

• Verifique se o usuário tem acesso ao projeto
• Verifique se o usuário tem permissão para criar/editar issues

Licença

Licença MIT