Issues do GitHub

Gerencie issues do GitHub usando o servidor MCP @modelcontextprotocol/server-github.

Ferramentas Disponíveis

Ferramentas MCP (operações de leitura)

Ferramentas MCP (operações de escrita)

CLI / API REST (operações de escrita)

gh api executa as mesmas escritas e é a forma usada nos exemplos abaixo. Use-a quando o servidor MCP não estiver conectado, ou quando precisar de um campo REST que as ferramentas MCP não expõem.

Observação: gh issue create funciona para a criação básica de issues, mas não suporta o flag --type. Use gh api quando precisar definir tipos de issue.

Fluxo de Trabalho

1. Determinar ação: Criar, atualizar ou consultar?
2. Coletar contexto: Obter informações do repositório, rótulos existentes, marcos, se necessário
3. Estruturar conteúdo: Usar o template apropriado de references/templates.md
4. Executar: Usar ferramentas MCP para leituras, gh api para escritas
5. Confirmar: Relatar o URL da issue ao usuário

Criando Issues

Use gh api para criar issues. Isso suporta todos os parâmetros, incluindo tipos de issue.

gh api repos/{owner}/{repo}/issues \
  -X POST \
  -f title="Issue title" \
  -f body="Issue body in markdown" \
  -f type="Bug" \
  --jq '{number, html_url}'

Parâmetros Opcionais

Adicione qualquer um destes flags à chamada gh api:

-f type="Bug"                    # Issue type (Bug, Feature, Task, Epic, etc.)
-f 'labels[]=bug'                # Labels (repeat for multiple)
-f 'assignees[]=username'        # Assignees (repeat for multiple)
-f milestone=1                   # Milestone number

Cite todo o par name[]=value. [] é um padrão glob no zsh, o shell padrão no macOS, então um -f labels[]=bug não citado nunca chega ao gh:

zsh: no matches found: labels[]=bug

Tipos de issue são metadados em nível de organização. Para descobrir os tipos disponíveis, use:

gh api graphql -f query='{ organization(login: "ORG") { issueTypes(first: 10) { nodes { name } } } }' --jq '.data.organization.issueTypes.nodes[].name'

Prefira tipos de issue em vez de rótulos para categorização. Quando tipos de issue estiverem disponíveis (por exemplo, Bug, Feature, Task), use o parâmetro type em vez de aplicar rótulos equivalentes como bug ou enhancement. Tipos de issue são a forma canônica de categorizar issues no GitHub. Use rótulos apenas como último recurso quando a organização não tiver tipos de issue configurados.

Diretrizes de Título

• Seja específico e acionável
• Mantenha abaixo de 72 caracteres
• Quando os tipos de issue estiverem definidos, não adicione prefixos redundantes como [Bug]
• Exemplos:
  • Login fails with SSO enabled (com type=Bug)
  • Add dark mode support (com type=Feature)
  • Add unit tests for auth module (com type=Task)

Estrutura do Corpo

Sempre use os templates em references/templates.md. Escolha com base no tipo de issue:

…