JIRA

Interaja com o JIRA para pesquisar issues usando JQL e obter informações detalhadas das issues.

Documentação

Servidor MCP JIRA

Um servidor MCP que permite que Modelos de Linguagem de Grande Porte (LLMs) interajam com o JIRA por meio de ferramentas e contexto padronizados. Este servidor fornece recursos para pesquisar issues usando JQL e recuperar informações detalhadas de issues.

Recursos

Pesquisa JQL: Execute consultas JQL complexas com suporte a paginação
Detalhes da Issue: Recupere informações detalhadas sobre issues específicas do JIRA

Pré-requisitos

npm instalado
Uma instância do JIRA com acesso à API
Token da API do JIRA ou Token de Acesso Pessoal
E-mail do usuário do JIRA associado ao token da API

Obtendo Credenciais da API do JIRA

Faça login na sua conta Atlassian em https://id.atlassian.com
Navegue até as configurações de Segurança
Em Tokens da API, selecione "Criar token da API"
Dê ao seu token um nome significativo (ex.: "Servidor MCP")
Copie o token gerado — você não poderá vê-lo novamente!
Use este token como seu JIRA_API_KEY
Use o endereço de e-mail associado à sua conta Atlassian como JIRA_USER_EMAIL

Uso

Integração com o Claude Desktop

Adicione a configuração do servidor ao arquivo de configuração do Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "jira": {
      "command": "npx",
      "args": ["-y", "jira-mcp"],
      "env": {
        "JIRA_INSTANCE_URL": "https://your-instance.atlassian.net",
        "JIRA_USER_EMAIL": "your-email@company.com",
        "JIRA_API_KEY": "your-api-token"
      }
    }
  }
}

Reinicie o Claude Desktop para carregar a nova configuração.

Ferramentas Disponíveis

1. Pesquisa JQL (`jql_search`)

Executa uma consulta de pesquisa JQL com parâmetros personalizáveis.

Parâmetros:

jql (obrigatório): string da consulta JQL
nextPageToken: Token para paginação
maxResults: Número máximo de resultados a retornar
fields: Matriz de nomes de campos a incluir
expand: Informações adicionais a incluir

Exemplo:

{
  "jql": "project = 'MyProject' AND status = 'In Progress'",
  "maxResults": 10,
  "fields": ["summary", "status", "assignee"]
}

2. Obter Issue (`get_issue`)

Recupera informações detalhadas sobre uma issue específica.

Parâmetros:

issueIdOrKey (obrigatório): ID ou chave da issue
fields: Matriz de nomes de campos a incluir
expand: Informações adicionais a incluir
properties: Matriz de propriedades a incluir
failFast: Se deve falhar rapidamente em caso de erros

Exemplo:

{
  "issueIdOrKey": "PROJ-123",
  "fields": ["summary", "description", "status"],
  "expand": "renderedFields,names"
}

Desenvolvimento

Configuração

Configure suas variáveis de ambiente antes de executar o servidor. Crie um arquivo .env no diretório raiz:

JIRA_INSTANCE_URL=https://your-instance.atlassian.net
JIRA_USER_EMAIL=your-email@company.com
JIRA_API_KEY=your-api-token

Substitua os valores por:

A URL real da sua instância do JIRA
O endereço de e-mail associado à sua conta do JIRA
Seu token da API do JIRA (pode ser gerado nas Configurações da Conta Atlassian)

Instalação

Instalando via Smithery

Para instalar o JIRA para o Claude Desktop automaticamente via Smithery:

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

Instalação Manual

Clone este repositório:

git clone <repository-url>
cd jira-mcp

Instale as dependências:

npm install

Executando com o MCP Inspector

Para testes e desenvolvimento, você pode usar o MCP Inspector:

npm run inspect

Adicionando Novas Ferramentas

Para adicionar novas ferramentas, modifique o manipulador ListToolsRequestSchema em index.js:

server.setRequestHandler(ListToolsRequestSchema, async () => {
  return {
    tools: [
      // Existing tools...
      {
        name: "your_new_tool",
        description: "Description of your new tool",
        inputSchema: {
          // Define input schema...
        }
      }
    ]
  };
});

Em seguida, implemente a ferramenta no manipulador CallToolRequestSchema.

Licença

MIT

Contribuição

Contribuições são bem-vindas! Sinta-se à vontade para enviar um PR.