Jira MCP Server

Servidor MCP do Jira

Um servidor Model Context Protocol que fornece integração com a API REST do Jira, permitindo que assistentes de IA gerenciem issues do Jira programaticamente.

Recursos

Este servidor fornece ferramentas para gerenciar issues do Jira:

• Criar novas issues (Tarefas, Épicos, Subtarefas)
• Listar issues com filtro opcional por status
• Atualizar issues existentes (resumo, descrição, status)
• Obter informações detalhadas de issues
• Excluir issues
• Adicionar comentários a issues

Configuração

Pré-requisitos

1. Uma conta Jira com acesso à API
2. Token da API do Jira (pode ser gerado em Configurações da Conta Atlassian)

Instalação

Instalação via Smithery

Para instalar o Jira Server para Claude Desktop automaticamente via Smithery:

npx -y @smithery/cli install jira-server --client claude

Instalação Manual

1. Instale as dependências:

npm install

2. Compile o servidor:

npm run build

Configuração

1. Crie um arquivo .jira-config.json no seu diretório de trabalho:

{
  "projectKey": ["YOUR_PROJECT_KEY", "YOUR_OTHER_PROJECT_KEY"]
}

2. Configure o servidor MCP com suas credenciais do Jira:

No MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json No Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "jira": {
      "command": "node",
      "args": ["/path/to/jira-server/build/index.js"],
      "env": {
        "JIRA_EMAIL": "your-email@example.com",
        "JIRA_API_TOKEN": "your-api-token",
        "JIRA_DOMAIN": "your-domain"
      }
    }
  }
}

Ferramentas Disponíveis

create_issue

Cria uma nova issue no Jira

• Parâmetros obrigatórios:
  • working_dir: Diretório contendo .jira-config.json
  • summary: Título da issue
  • description: Descrição da issue
  • type: Tipo da issue (Task, Epic ou Subtask)

list_issues

Lista issues no projeto

• Parâmetros obrigatórios:
  • working_dir: Diretório contendo .jira-config.json
• Parâmetros opcionais:
  • status: Filtrar por status (ex.: "To Do", "In Progress", "Done")

update_issue

Atualiza uma issue existente

• Parâmetros obrigatórios:
  • working_dir: Diretório contendo .jira-config.json
  • issue_key: Chave da issue (ex.: PRJ-123)
• Parâmetros opcionais:
  • summary: Novo título
  • description: Nova descrição
  • status: Novo status

get_issue

Obtém informações detalhadas sobre uma issue específica

• Parâmetros obrigatórios:
  • working_dir: Diretório contendo .jira-config.json
  • issue_key: Chave da issue (ex.: PRJ-123)

delete_issue

Exclui uma issue do Jira

• Parâmetros obrigatórios:
  • working_dir: Diretório contendo .jira-config.json
  • issue_key: Chave da issue (ex.: PRJ-123)

add_comment

Adiciona um comentário a uma issue existente

• Parâmetros obrigatórios:
  • working_dir: Diretório contendo .jira-config.json
  • issue_key: Chave da issue (ex.: PRJ-123)
  • comment: Texto do comentário a ser adicionado

Desenvolvimento

Para desenvolvimento com recompilação automática:

npm run watch

Tratamento de Erros

O servidor inclui tratamento abrangente de erros para:

• Chaves de projeto inválidas
• Configuração ausente
• Tipos de issue inválidos
• Erros de autenticação da API
• Transições de status inválidas

Formatação de Saída

As informações das issues são formatadas para incluir:

• Chave e resumo da issue
• Tipo e status da issue
• Data de criação e criador
• Descrição
• Comentários (se houver) com autor e data/hora