Jira

Interaja com o Jira para gerenciar issues, projetos e workflows usando a REST API da Jira Cloud Platform.

Documentação

Jira MCP (Model Context Protocol)

Visão Geral

Este servidor Model Context Protocol (MCP) permite que Modelos de Linguagem de Grande Porte (LLMs) interajam com o Jira por meio de uma API padronizada. Ele permite que assistentes de IA executem operações comuns do Jira sem exigir integração direta com a API, facilitando a criação de ferramentas baseadas em IA que funcionam com sua instância do Jira.

Recursos

Integração com a API da Plataforma Jira: Acesso abrangente à API REST da Jira Cloud Platform
Integração com a API do Jira Software: Trabalhe com recursos do Jira Software, como quadros, sprints e épicos
Suporte ao Protocolo MCP: Interface padronizada para assistentes de IA e ferramentas de automação
Autenticação: Suporte a autenticação básica usando PAT (Personal Access Token) da Atlassian

Ferramentas MCP suportadas

O servidor MCP suporta as seguintes operações do Jira:

Ferramentas de Agile e Quadros

get_all_agile_boards: Recuperar todos os quadros ágeis disponíveis
get_epics_from_board: Obter todos os épicos associados a um quadro específico
get_issues_from_board: Obter todos os problemas de um quadro especificado
get_issues_from_epic: Recuperar todos os problemas associados a um épico específico
get_issues_from_sprint: Obter todos os problemas de um sprint especificado
get_sprints_from_board: Recuperar todos os sprints associados a um quadro
move_issues_to_epic: Mover problemas especificados para um épico

Operações de Problemas

add_jira_comment: Adicionar um comentário a um problema do Jira
create_issue: Criar um novo problema no Jira
delete_issue: Excluir um problema existente do Jira
get_issue: Recuperar detalhes de um problema específico
get_issue_fields: Obter todos os campos disponíveis para problemas
get_issue_transitions: Obter possíveis transições de status para um problema
get_project_versions: Obter todas as versões em um projeto com suporte a paginação
search_issue_by_jql: Pesquisar problemas usando JQL (Jira Query Language)
transition_jira_issue: Alterar o status de um problema
update_issue: Atualizar os detalhes de um problema existente
add_jira_attachments: Adicionar anexos a um problema existente

Operações de Usuário

search_user: Encontrar usuários do Jira com base em critérios de pesquisa
get_myself_info: Obter informações sobre o usuário autenticado

Como usar esta imagem

MCP SSE

Uso simples

docker run -d --name jira-mcp \
  -p 8080:8080 \
  -e atlassian.url=https://your-company.atlassian.net \
  -e atlassian.username=your-jira-email \
  -e atlassian.pat=your-jira-pat \
  guang1/jira-mcp:latest

Usando um arquivo de ambiente

Crie um arquivo de configuração (por exemplo, atlassian.config):

atlassian.url=https://your-company.atlassian.net
atlassian.username=your-jira-email
atlassian.pat=your-jira-pat

Em seguida, execute:

docker run -d --name jira-mcp \
  -p 8080:8080 \
  --env-file atlassian.config \
  guang1/jira-mcp:latest

Docker Compose para SSE

Exemplo básico

services:
  jira:
    container_name: jira-mcp
    image: guang1/jira-mcp
    environment:
      - atlassian.url=https://your-company.atlassian.net
      - atlassian.username=your-jira-email
      - atlassian.pat=your-jira-pat
    ports:
      - "8080:8080"
    restart: always

Com arquivo de ambiente

services:
  jira:
    container_name: jira-mcp
    image: guang1/jira-mcp
    env_file:
      - jira.config
    ports:
      - "8080:8080"
    restart: always

URL do MCP SSE

http://localhost:8080/mcp/sse

MCP STDIO

Must pass quarkus.mcp.server.stdio.enabled=true, quarkus.log.console.enable=false and quarkus.log.console.stderr=false environment variables with -i interactive option.

Simple usage

docker run --rm \
  -e atlassian.url=https://your-company.atlassian.net \
  -e atlassian.username=your-jira-email \
  -e atlassian.pat=your-jira-pat \
  -e quarkus.mcp.server.stdio.enabled=true \
  -e quarkus.log.console.enable=false \
  -e quarkus.log.console.stderr=false \
  -i guang1/jira-mcp:latest

Using an Environment File

docker run --rm --env-file=atlassian.config \
   -e quarkus.mcp.server.stdio.enabled=true \
   -e quarkus.log.console.enable=false \
   -e quarkus.log.console.stderr=false \
   -i guang1/jira-mcp:latest

Claude Desktop Configuration (STDIO)

To use the Docker version with Claude Desktop, add this to your claude_desktop_config.json or server_config.json file:

Simple usage

{
  "mcpServers": {
    "jira": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-e",
        "atlassian.url=https://your-company.atlassian.net",
        "-e",
        "atlassian.username=your-jira-email",
        "-e",
        "atlassian.pat=your-jira-pat",       
        "-e",
        "quarkus.log.console.enable=false",
        "-e",
        "quarkus.log.console.stderr=false",
        "-i",
        "guang1/jira-mcp:latest"
      ]
    }
  }
}

Using an Environment File

{
  "mcpServers": {
    "jira": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "--env-file=atlassian.conf",
        "-e",
        "quarkus.mcp.server.stdio.enabled=true",
        "-e",
        "quarkus.log.console.enable=false",
        "-e",
        "quarkus.log.console.stderr=false",
        "-i",
        "guang1/jira-mcp:latest"
      ]
    }
  }
}

Configuração

Variáveis de Ambiente

Variável	Descrição	Obrigatório
`atlassian.url`	URL da instância do Atlassian (por exemplo, https://your-company.atlassian.net)	Sim
`atlassian.username`	Endereço de e-mail da conta Atlassian	Sim
`atlassian.pat`	Token de Acesso Pessoal (API Token) da Atlassian	Sim

Criando um Token de API do Jira

Para gerar um Token de Acesso Pessoal para o Jira:

Acesse https://id.atlassian.com/manage-profile/security/api-tokens
Clique em "Create API token"
Dê um nome ao seu token (por exemplo, "MCP Server")
Copie o token gerado para usar com este servidor MCP

Considerações de Segurança

⚠️ Aviso: Este servidor MCP requer credenciais de autenticação com acesso à sua instância do Jira. Considere as seguintes práticas de segurança:

Crie uma conta de serviço dedicada no Jira com permissões apropriadas
Rotacione regularmente seu token de API
Execute o contêiner em um ambiente seguro e isolado
Use regras de segurança de rede para restringir o acesso ao servidor MCP
Tenha cuidado com quais operações você permite que LLMs executem

Exemplos de Casos de Uso

Definir um Prefixo de Ticket Padrão
Defina um prefixo de ticket padrão em suas regras (por exemplo, MyProj-). Isso permite que você faça referência a tickets no chat apenas pelo número (por exemplo, 1234 em vez de MyProj-1234).
Configurar ID de Conta Pessoal do Jira
Especifique seu ID de conta do Jira nas regras para evitar chamadas repetidas de API (como get_myself_info) para cada operação.
Personalizar Campos do Jira
Defina campos personalizados (por exemplo, story points, desenvolvedor, etc.) em suas regras para impedir que a IA chame get_issue_fields toda vez.
Automatizar Gerenciamento de Problemas
Crie e atualize problemas do Jira automaticamente com base em solicitações em linguagem natural.
Gerar Relatórios e Resumos
Produza relatórios e resumos do Jira sob demanda.
Planejamento de Sprint e Gerenciamento de Épicos
Auxilie no planejamento de sprints e no gerenciamento de épicos.
Interação Conversacional com o Jira
Permita que membros da equipe interajam com o Jira usando linguagem natural e conversacional.

Solução de Problemas

Se você encontrar problemas:

Verifique se seu token de API tem as permissões necessárias
Verifique se a URL do Atlassian está correta e acessível
Certifique-se de que seu nome de usuário (e-mail) do Atlassian esteja correto
Verifique os logs do contêiner para obter informações detalhadas sobre erros

Licença

Este projeto é licenciado sob a Licença MIT - consulte o arquivo LICENSE para obter detalhes.