Jira

Jira MCP Server

Um servidor Model Context Protocol (MCP) para interagir com a API REST do Jira usando a biblioteca jira-python. Este servidor integra-se com o Claude Desktop e outros clientes MCP, permitindo que você interaja com o Jira usando comandos em linguagem natural.

Funcionalidades

• Obter todos os projetos acessíveis do Jira
• Obter detalhes de um problema específico do Jira
• Pesquisar problemas usando JQL (Jira Query Language)
• Criar novos problemas no Jira
• Adicionar comentários a problemas
• Obter transições disponíveis para um problema
• Transicionar problemas para novos status

Instalação

Pré-requisitos

• Python 3.9 ou superior
• Uma instância do Jira (Cloud, Server ou Data Center)
• uv (opcional, mas recomendado para gerenciamento de dependências)

Ative um ambiente virtual (recomendado)

# Install a Virtual Environment (VENV) in the mcp server directory
python -m venv .
# Activate the virtual environment
source bin/activate

Usando uv (recomendado)

# Install uv if you don't have it
pip install uv

# Install the Jira MCP server
uv pip install mcp-server-jira

Usando pip

pip install mcp-server-jira

Configuração

Variáveis de Ambiente

Configure o servidor usando variáveis de ambiente:

• JIRA_SERVER_URL: URL do seu servidor Jira
• JIRA_AUTH_METHOD: Método de autenticação ('basic_auth' ou 'token_auth')
• JIRA_USERNAME: Nome de usuário para autenticação básica
• JIRA_PASSWORD: Senha para autenticação básica
• JIRA_TOKEN: Token de API ou Personal Access Token

Arquivo de Ambiente (Desenvolvimento Local)

Você também pode criar um arquivo .env no diretório raiz com sua configuração:

JIRA_SERVER_URL=https://your-jira-instance.atlassian.net
JIRA_AUTH_METHOD=basic_auth
JIRA_USERNAME=your_email@example.com
JIRA_TOKEN=your_api_token

Uso

Linha de Comando

python -m mcp_server_jira

Docker

docker build -t mcp-jira .
docker run --env-file .env -p 8080:8080 mcp-jira

Integração com Claude Desktop

Para usar este servidor com o Claude Desktop:

1. Instale o servidor usando um dos métodos acima
2. No Claude Desktop:
   • Vá para Configurações -> Desenvolvedor
   • Clique em Editar Configuração
   • Abra a configuração JSON no editor de sua preferência
   • Adicione o seguinte JSON: (NOTE: As variáveis de ambiente usadas são para autenticação por token e não funcionarão com outros métodos de autenticação)

{
  "mcpServers": {
    "jira": {
      "command": "<PATH TO UV> i.e. /Users/<MYUSERNAME>/.local/bin/uv",
      "args": [
          "--directory",
          "<PATH TO JIRA MCP>",
          "run",
          "mcp-server-jira"
      ],
      "env": {
          "JIRA_SERVER_URL": "https://<ORG>.atlassian.net/",
          "JIRA_AUTH_METHOD": "token_auth",
          "JIRA_USERNAME": "<USERNAME>",
          "JIRA_TOKEN": "<TOKEN>"
      }
    }
  }
}

3. Agora você pode interagir com o Jira fazendo perguntas ao Claude, como:
   • "Mostre-me todos os meus projetos no Jira"
   • "Obtenha detalhes do problema PROJECT-123"
   • "Crie um novo bug no PROJECT com o resumo 'Corrigir problema de login'"
   • "Encontre todos os bugs abertos atribuídos a mim"

Autenticação

O servidor suporta múltiplos métodos de autenticação:

Autenticação Básica

Para Jira Server/Data Center com nome de usuário e senha:

JIRA_SERVER_URL="https://jira.example.com"
JIRA_AUTH_METHOD="basic_auth"
JIRA_USERNAME="your_username"
JIRA_PASSWORD="your_password"

API Token (Jira Cloud)

Para Jira Cloud usando um token de API:

JIRA_SERVER_URL="https://your-domain.atlassian.net"
JIRA_AUTH_METHOD="basic_auth"
JIRA_USERNAME="your_email@example.com"
JIRA_TOKEN="your_api_token"

Personal Access Token (Jira Server/Data Center)

Para Jira Server/Data Center (8.14+) usando um PAT:

JIRA_SERVER_URL="https://jira.example.com"
JIRA_AUTH_METHOD="token_auth"
JIRA_TOKEN="your_personal_access_token"

Ferramentas Disponíveis

1. get_projects: Obter todos os projetos acessíveis do Jira
2. get_issue: Obter detalhes de um problema específico do Jira pela chave
3. search_issues: Pesquisar problemas do Jira usando JQL
4. create_issue: Criar um novo problema no Jira
5. add_comment: Adicionar um comentário a um problema do Jira
6. get_transitions: Obter transições de fluxo de trabalho disponíveis para um problema do Jira
7. transition_issue: Transicionar um problema do Jira para um novo status

Licença

MIT