O Kanban de cada projeto do Embrapa I/O vive no grupo do projeto no GitLab da plataforma: as colunas são os labels (To Do, Doing, Alpha, Beta…) e as entregas são os milestones do grupo. Há três formas de um agente de IA trabalhar nesse Kanban:

  Para quê Onde funciona
MCP oficial do GitLab Recomendado. O dia a dia do Kanban: listar colunas, criar e mover issues, comentar Qualquer cliente MCP: Claude Desktop e Web, ChatGPT, VS Code, Cursor, Claude Code
CLI glab O que o MCP oficial ainda não faz: criar milestones de grupo, labels e boards Só agentes de terminal, como o Claude Code e o Codex
MCP do Embrapa I/O (mcp.git.embrapa.io) Perdeu a serventia diante dos dois anteriores Será descontinuado

MCP oficial do GitLab (recomendado)

Desde a versão 19.5 do GitLab, o MCP Server oficial é um recurso estável, mantido pela própria GitLab e disponível em todas as edições, inclusive a Community Edition da plataforma. Ele roda dentro do GitLab, é atualizado junto com ele e é o caminho recomendado pela GitLab para conectar assistentes de IA. É o ideal para agentes usados no desktop e na web.

A URL de conexão é:

git.embrapa.io/api/v4/mcp

A autenticação é feita pelo OAuth do GitLab: na primeira conexão, o login abre no browser e o assistente passa a agir com as suas permissões, nem mais nem menos.

No Claude Code:

claude mcp add -s user --transport http GitLab https://git.embrapa.io/api/v4/mcp

Depois, digite /mcp na conversa, escolha GitLab e autentique. Nos demais clientes, siga o padrão de Configuração em IDEs e CLIs com a URL acima, ou as instruções da documentação do GitLab.

O que faz no Kanban

  • Listar as issues do grupo inteiro (list_work_items), com filtros por label (a coluna), milestone, responsável, autor, estado e datas. Diferentemente do MCP do Embrapa I/O, que opera projeto a projeto, ele enxerga o Kanban do grupo de uma vez.
  • Criar e atualizar issues (save_work_item): título, descrição, labels, milestone, responsáveis, prazo e estado. Mover um card de coluna é adicionar um label e remover outro. Labels e milestones são procurados no projeto e nos grupos acima dele, e um nome inexistente gera erro em vez de ser ignorado.
  • Ler uma issue com comentários e discussões (get_work_item) e comentar (save_note).
  • Navegar pelos grupos (list_groups) e buscar em todo o GitLab (search).
  • Além do Kanban: merge requests, revisão de código, pipelines, jobs e commits. Veja a lista completa de tools.

O que ele ainda não faz: criar, editar ou listar milestones e labels, nem gerir boards. Ele só usa os que já existem. Para isso, use o glab ou a interface do GitLab.

Dica! Para expor só as tools do Kanban e deixar o contexto do assistente mais leve, envie o cabeçalho X-Gitlab-Enabled-Mcp-Server-Toolsets com os grupos desejados. No Claude Code: claude mcp add -s user --transport http GitLab https://git.embrapa.io/api/v4/mcp --header "X-Gitlab-Enabled-Mcp-Server-Toolsets: core,work_items".

CLI glab (agentes de terminal)

O glab é a linha de comando oficial do GitLab. Ele cobre o que o MCP oficial ainda não faz, principalmente criar milestones de grupo e boards, e serve a quem usa agentes que executam comandos no terminal, como o Claude Code e o Codex. Assistentes que rodam só no browser ou no desktop, sem terminal, não conseguem usá-lo.

Instale (por exemplo, brew install glab ou o pacote da sua distribuição) e autentique na instância da plataforma:

glab auth login --hostname git.embrapa.io

Atenção! Fora de um clone de repositório do git.embrapa.io, o glab usa o gitlab.com por padrão. Defina export GITLAB_HOST=git.embrapa.io ou, nas chamadas à API, use glab api … --hostname git.embrapa.io.

Comandos úteis no Kanban (<grupo> é o nome Unix do projeto na plataforma):

glab issue list -g <grupo> -l Doing                     # uma coluna do Kanban do grupo
glab issue list -g <grupo> -m 1.26.11 -O json           # issues de um milestone, em JSON
glab issue update 42 -l Alpha -u Doing                  # move a issue #42 de Doing para Alpha
glab issue note 42 -m "Validado na reunião de hoje."    # comenta
glab milestone create --group <grupo> --title 1.26.11 \
  --start-date 2026-11-02T00:00:00Z --due-date 2026-11-06T00:00:00Z
glab milestone list --group <grupo>
glab label list -g <grupo>                              # labels do grupo (criação: só em projeto)
glab issue board view                                   # board interativo no terminal

Peça ao agente em linguagem natural (“crie os milestones das próximas quatro semanas no grupo controlpec”) e ele monta os comandos.

MCP do Embrapa I/O (será descontinuado)

O mcp.git.embrapa.io foi criado em março de 2026, quando o GitLab ainda não tinha um MCP estável. Com o MCP oficial, que opera no grupo inteiro e é mantido pela GitLab, e o glab para o que falta, ele perdeu a serventia e será descontinuado. Quem o utiliza deve migrar para o MCP oficial.

Enquanto estiver no ar, a URL de conexão é https://mcp.git.embrapa.io, também com OAuth do GitLab:

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

Ele expõe 36 tools, sempre por projeto (não por grupo): issues (criação, consulta, atualização, exclusão), vínculos entre issues (relates_to, blocks, is_blocked_by), notas e discussões, labels e milestones de projeto (inclusive a promoção de milestone para o grupo e os eventos de burndown), projetos, membros e namespaces.

Exemplos de Prompts

Com o MCP oficial conectado (ou o glab, num agente de terminal):

Quais são as minhas issues abertas no GitLab?
Liste as issues do grupo controlpec na coluna "Doing", com responsável e milestone.
Crie uma issue no projeto controlpec/api com título "Implementar endpoint de relatórios",
label "To Do", milestone 1.26.11 e atribua ao usuário matheus.amorim.
Mova todas as issues do grupo controlpec que estão em "To Do" para "Doing".
Adicione um comentário na issue #3 do controlpec/pwa informando que
o layout foi validado pelo Sânzio na reunião de hoje.

Só com o glab, num agente de terminal:

Crie no grupo controlpec os milestones das próximas quatro semanas,
um por semana (segunda a sexta), com os títulos no formato das versões.