O MCP Server do Kanban conecta assistentes de IA diretamente ao GitLab da plataforma, permitindo gerenciar issues, milestones, labels e relações entre tarefas via linguagem natural. O servidor opera sobre a API do GitLab e expõe as operações como tools MCP, transformando o assistente de IA em um gerente de projeto integrado ao Kanban.

Conectar

A URL de conexão do MCP Server é:

mcp.git.embrapa.io

A autenticação é feita pelo OAuth do próprio GitLab. Ao conectar, o fluxo de login abrirá automaticamente no browser para autenticação na instância do GitLab da plataforma.

Funcionalidades

O servidor expõe 36 tools organizadas nos seguintes domínios:

Issues — Ciclo completo de gestão de issues: criação com título, descrição, labels, milestone e responsáveis; consulta individual ou listagem com filtros avançados (estado, labels, milestone, responsável, datas, tipo); atualização de qualquer campo (título, descrição, labels, estado, milestone, responsáveis, peso, confidencialidade, tipo); exclusão; e listagem das issues atribuídas ao usuário autenticado.

Relações entre Issues — Criação de vínculos entre issues de um mesmo projeto ou entre projetos diferentes, com três tipos de relação: relates_to (relacionada), blocks (bloqueia) e is_blocked_by (bloqueada por). Consulta e remoção de vínculos existentes.

Notas e Discussões — Adição de comentários em issues e merge requests. Criação de notas em threads de discussão existentes, edição de notas e marcação como resolvidas/não-resolvidas. Listagem de todas as discussões de uma issue.

Labels — Criação, consulta, atualização (nome, cor, descrição, prioridade) e exclusão de labels em projetos. Suporte a labels herdados de grupos ancestrais.

Milestones — Criação, consulta, edição (título, descrição, datas, estado) e exclusão de milestones. Promoção de milestone de projeto para grupo. Consulta de issues e merge requests associados a um milestone. Eventos de burndown para acompanhamento de progresso.

Projetos e Membros — Consulta de detalhes de projetos e listagem de projetos acessíveis (com filtros por visibilidade, linguagem, funcionalidades habilitadas). Listagem de projetos dentro de um grupo. Consulta de membros de um projeto (com suporte a herança de grupo).

Namespaces e Iterações — Consulta e listagem de namespaces (grupos e usuários), verificação de existência de namespace. Listagem de iterações de grupo com filtros por estado e período.

Exemplos de Prompts

Abaixo, exemplos do que pode ser solicitado em linguagem natural a um assistente de IA conectado a este MCP:

Quais são as minhas issues abertas no GitLab?

Liste todas as issues do projeto controlpec/pwa com label "Doing".

Crie uma issue no projeto controlpec/api com título "Implementar endpoint de relatórios",
label "To Do" e atribua ao usuário matheus.amorim.

Mova todas as issues com label "To Do" do projeto controlpec/pwa para "Doing".

Crie um milestone "Sprint 2026-Q2" no projeto controlpec/pwa
com início em 2026-04-01 e término em 2026-06-30.

Mostre o progresso do milestone 1.26.12: quantas issues abertas vs. fechadas,
e quais merge requests estão associados.

Adicione um comentário na issue #3 do controlpec/pwa informando que
o layout foi validado pelo Sânzio na reunião de hoje.

Crie um vínculo de bloqueio: a issue #1 (plano de contas) bloqueia a issue #2
(filtro por texto) no projeto controlpec/pwa.

Feche todas as issues com label "Doing" atribuídas a simoes.leonardo
no projeto controlpec/pwa.

Liste os membros do projeto controlpec/pwa e seus níveis de acesso.

Configuração em IDEs e CLIs

A configuração segue o padrão unificado descrito em Configuração em IDEs e CLIs. Basta usar a URL https://mcp.git.embrapa.io. Exemplo no Claude Code:

claude mcp add --scope user --transport http git-kanban https://mcp.git.embrapa.io

Dica! Ao configurar o conector no Claude Desktop/Web ele ficará disponível automaticamente no Claude Code.

Referência Técnica

Tools (36)

Issues

Tool Descrição
my_issues Lista issues atribuídas ao usuário autenticado. Filtros: estado, labels, milestone, projeto, datas e busca textual.
list_issues Lista issues com filtros avançados: projeto, estado, labels, milestone, responsável, autor, tipo (issue, incident, test_case, task), datas e escopo (created_by_me, assigned_to_me, all).
get_issue Detalhes de uma issue específica: título, descrição, estado, labels, milestone, responsáveis, peso, datas e referências.
create_issue Cria uma issue com título, descrição, labels, milestone, responsáveis e tipo.
update_issue Atualiza qualquer campo de uma issue: título, descrição, labels, estado (close/reopen), milestone, responsáveis, peso, confidencialidade, tipo e data de entrega.
delete_issue Remove uma issue permanentemente de um projeto.

Relações entre Issues

Tool Descrição
create_issue_link Cria vínculo entre duas issues (mesmo projeto ou entre projetos). Tipos: relates_to, blocks, is_blocked_by.
get_issue_link Consulta detalhes de um vínculo específico entre issues.
list_issue_links Lista todos os vínculos de uma issue.
delete_issue_link Remove um vínculo entre issues.

Notas e Discussões

Tool Descrição
create_note Adiciona um comentário a uma issue ou merge request.
create_issue_note Adiciona uma nota a um thread de discussão existente em uma issue.
update_issue_note Edita o conteúdo de uma nota existente. Permite marcar como resolvida ou não-resolvida.
list_issue_discussions Lista todas as discussões (threads) de uma issue com paginação.

Labels

Tool Descrição
list_labels Lista labels de um projeto, com opção de incluir labels de grupos ancestrais e contagem de issues/merge requests.
get_label Detalhes de um label específico (por ID ou nome).
create_label Cria um label com nome, cor (hex), descrição e prioridade.
update_label Atualiza nome, cor, descrição ou prioridade de um label existente.
delete_label Remove um label de um projeto.

Milestones

Tool Descrição
list_milestones Lista milestones de um projeto com filtros: estado (active/closed), título, IIDs, datas e milestones de grupos ancestrais.
get_milestone Detalhes de um milestone específico.
create_milestone Cria um milestone com título, descrição, data de início e data de entrega.
edit_milestone Atualiza título, descrição, datas ou estado (close/activate) de um milestone.
delete_milestone Remove um milestone de um projeto.
promote_milestone Promove um milestone de nível de projeto para nível de grupo.
get_milestone_issue Lista issues associadas a um milestone.
get_milestone_merge_requests Lista merge requests associados a um milestone com paginação.
get_milestone_burndown_events Eventos de burndown de um milestone para acompanhamento de progresso.

Projetos e Membros

Tool Descrição
get_project Detalhes de um projeto: nome, visibilidade, URLs, branches, funcionalidades habilitadas e permissões.
list_projects Lista projetos acessíveis com filtros: visibilidade, membership, linguagem, ordenação e funcionalidades.
list_group_projects Lista projetos de um grupo com filtros adicionais: subgrupos, nível de acesso mínimo e estatísticas.
list_project_members Lista membros de um projeto com nível de acesso, incluindo membros herdados do grupo. Filtros por nome, username e IDs.

Namespaces e Iterações

Tool Descrição
list_namespaces Lista namespaces acessíveis (grupos e usuários) com filtros de busca e propriedade.
get_namespace Detalhes de um namespace por ID ou caminho completo.
verify_namespace Verifica se um caminho de namespace existe no GitLab.
list_group_iterations Lista iterações de um grupo com filtros: estado (opened, upcoming, current, closed), busca por título e datas.