Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
GITLAB_URLYesBase da instância, ex.: https://gitlab.empresa.com. Barra final e sufixo /api/v4 são removidos automaticamente.
GITLAB_TOKENYesPersonal Access Token.
GITLAB_CA_CERTNoCaminho para CA privada / cert self-signed em PEM.
GITLAB_READ_ONLYNoSó o literal 'false' habilita as tools de escrita.true
GITLAB_TIMEOUT_MSNoTimeout por request, em ms.20000

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
whoamiA

Retorna a identidade do Personal Access Token configurado (id, username, name, web_url). Use para validar que o token funciona antes de investigar outros erros, ou quando precisar saber qual é o seu username. Não use antes de list_mrs_awaiting_my_review: aquela tool já descobre o username sozinha.

list_my_projectsA

Lista os projetos GitLab onde você é membro, ordenados por atividade recente. Use para descobrir o path exato de um projeto (grupo/subgrupo/projeto) antes de chamar get_mr, get_mr_diff etc. Não use para procurar um MR específico — para isso use list_my_authored_mrs ou list_mrs_awaiting_my_review.

list_my_authored_mrsA

Lista os merge requests que VOCÊ criou, atravessando todos os projetos a que tem acesso. Use para responder "quais MRs eu abri" ou "o que ainda está em aberto meu". Não use para MRs em que você é reviewer — para isso use list_mrs_awaiting_my_review. A descrição do MR não vem aqui; use get_mr quando precisar dela.

list_mrs_awaiting_my_reviewA

Lista os merge requests abertos em que VOCÊ está como reviewer (não assignee) — ou seja, o que está esperando review seu. Este é o ponto de partida do fluxo de review: use esta tool, depois get_mr, depois get_mr_diff. Não precisa passar seu username: a tool descobre sozinha pelo token.

get_mrA

Detalhe completo de um merge request: título, descrição, branches, reviewers, status de merge e diff_refs. Use depois de localizar o MR numa listagem, antes de ler o diff. O parâmetro iid é o número da URL do MR, não o id global. diff_refs (base_sha/start_sha/head_sha) sai daqui e é o que comment_on_mr_line precisa.

get_mr_diffA

Diff do merge request em texto, com o número de linha de cada lado impresso explicitamente (old=/new=). Use antes de comentar em linha: os números old= e new= que aparecem aqui são exatamente os que comment_on_mr_line espera. Prefixos: "add" = linha só no lado novo, "del" = linha só no antigo, "ctx" = linha inalterada (tem os dois números). Se a saída vier truncada, chame de novo com path="" para ver aquele arquivo inteiro. Não use para ler o arquivo completo do repositório — só mostra o que mudou no MR.

list_mr_discussionsA

Lista as threads de comentário de um merge request, com o discussion_id de cada uma e a posição no diff quando o comentário está ancorado em código. Use para ver o que já foi comentado antes de comentar de novo, e para pegar o discussion_id que reply_to_mr_discussion precisa. Notas de sistema ("changed target branch", "assigned to...") são filtradas — não aparecem aqui.

comment_on_mrA

Publica um comentário geral no merge request, sem âncora em código. Use para resumo de review, dúvida ampla ou aprovação informal. Para comentar numa linha específica do diff use comment_on_mr_line; para responder numa thread existente use reply_to_mr_discussion. Requer GITLAB_READ_ONLY=false e token com escopo api.

comment_on_mr_lineA

Cria uma thread de review ancorada numa linha específica do diff do merge request. Chame get_mr_diff antes: os números old=/new= de lá são exatamente o que esta tool espera, e ela valida localmente antes de postar. Para linha de contexto (prefixo "ctx"), passe side="context" com line = new= e context_old_line = old=; os dois são obrigatórios. Só suporta comentário em linha única — comentário multi-linha está fora de escopo neste MVP. Requer GITLAB_READ_ONLY=false e token com escopo api.

reply_to_mr_discussionA

Responde numa thread de comentário já existente do merge request. Pegue o discussion_id em list_mr_discussions. Fecha o loop: ler threads, responder. Para abrir uma thread nova numa linha use comment_on_mr_line; para comentário solto use comment_on_mr. Requer GITLAB_READ_ONLY=false e token com escopo api.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/vinihcrosa/gitlab-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server