gitlab-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| GITLAB_URL | Yes | Base da instância, ex.: https://gitlab.empresa.com. Barra final e sufixo /api/v4 são removidos automaticamente. | |
| GITLAB_TOKEN | Yes | Personal Access Token. | |
| GITLAB_CA_CERT | No | Caminho para CA privada / cert self-signed em PEM. | |
| GITLAB_READ_ONLY | No | Só o literal 'false' habilita as tools de escrita. | true |
| GITLAB_TIMEOUT_MS | No | Timeout por request, em ms. | 20000 |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| 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
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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