GitLab MCP Server

GitLab MCP Server è un server MCP remoto: non c’è niente da installare. Il suo endpoint, servito tramite Streamable HTTP, è https://mcp.jmrp.io/gitlab. In un assistente che accetta server MCP remoti (spesso in un’impostazione chiamata connettori, integrazioni o strumenti) si aggiunge un nuovo server indicando questo URL; in un client configurato tramite file lo si aggiunge come server remoto (HTTP) con lo stesso URL.

La voce del registro dichiara un header HTTP per la connessione: Authorization (segreto). Un header segreto contiene di solito una chiave API o un token rilasciato dal servizio; i client che accettano header personalizzati lo impostano insieme all’URL del server.

Può essere eseguito anche in locale a partire da un MCP Bundle: un unico archivio scaricabile che contiene un server locale e un manifest che lo descrive: https://github.com/jmrplens/gitlab-mcp-server/releases/download/v3.1.0/gitlab-mcp-server.mcpb, versione 3.1.0. Comunica via MCP su stdio, quindi il client lo avvia come programma e dialoga con esso tramite standard input e standard output. Richiede un client in grado di installare gli MCP Bundle; il file va aperto in quel client o aggiunto a esso. Legge queste variabili d’ambiente: GITLAB_URL, GITLAB_TOKEN (obbligatorio, segreto), GITLAB_MCP_SKIP_TLS_VERIFY, GITLAB_MCP_TOOL_SURFACE, GITLAB_MCP_CAPABILITY_SURFACE, GITLAB_MCP_META_PARAM_SCHEMA, GITLAB_MCP_TIER, GITLAB_MCP_READ_ONLY, GITLAB_MCP_SAFE_MODE, GITLAB_MCP_EMBEDDED_RESOURCES, GITLAB_MCP_EXCLUDE_TOOLS, GITLAB_MCP_IGNORE_SCOPES, GITLAB_MCP_UPLOAD_MAX_FILE_SIZE, GITLAB_MCP_ALLOWED_IMPORT_DIRS, GITLAB_MCP_RATE_LIMIT_RPS, GITLAB_MCP_RATE_LIMIT_BURST e GITLAB_MCP_LOG_LEVEL; vanno impostate nella configurazione del client per questo server.

Può essere eseguito anche in locale a partire da un’immagine container in un registro OCI come Docker Hub o GitHub Container Registry: ghcr.io/jmrplens/gitlab-mcp-server:3.1.0@sha256:87e483299a2663a7a5d4d28679859b0c7fba2b1a421b7de2652441a569d4a2fc. Comunica via MCP su stdio, quindi il client lo avvia come programma e dialoga con esso tramite standard input e standard output. Richiede Docker o un altro runtime di container OCI; si avvia con docker run - il comando abituale è docker run -i --rm -e GITLAB_URL -e GITLAB_TOKEN -e GITLAB_MCP_SKIP_TLS_VERIFY -e GITLAB_MCP_TOOL_SURFACE -e GITLAB_MCP_CAPABILITY_SURFACE -e GITLAB_MCP_META_PARAM_SCHEMA -e GITLAB_MCP_TIER -e GITLAB_MCP_READ_ONLY -e GITLAB_MCP_SAFE_MODE -e GITLAB_MCP_EMBEDDED_RESOURCES -e GITLAB_MCP_EXCLUDE_TOOLS -e GITLAB_MCP_IGNORE_SCOPES -e GITLAB_MCP_UPLOAD_MAX_FILE_SIZE -e GITLAB_MCP_ALLOWED_IMPORT_DIRS -e GITLAB_MCP_RATE_LIMIT_RPS -e GITLAB_MCP_RATE_LIMIT_BURST -e GITLAB_MCP_LOG_LEVEL ghcr.io/jmrplens/gitlab-mcp-server:3.1.0@sha256:87e483299a2663a7a5d4d28679859b0c7fba2b1a421b7de2652441a569d4a2fc. Legge queste variabili d’ambiente: GITLAB_URL, GITLAB_TOKEN (obbligatorio, segreto), GITLAB_MCP_SKIP_TLS_VERIFY, GITLAB_MCP_TOOL_SURFACE, GITLAB_MCP_CAPABILITY_SURFACE, GITLAB_MCP_META_PARAM_SCHEMA, GITLAB_MCP_TIER, GITLAB_MCP_READ_ONLY, GITLAB_MCP_SAFE_MODE, GITLAB_MCP_EMBEDDED_RESOURCES, GITLAB_MCP_EXCLUDE_TOOLS, GITLAB_MCP_IGNORE_SCOPES, GITLAB_MCP_UPLOAD_MAX_FILE_SIZE, GITLAB_MCP_ALLOWED_IMPORT_DIRS, GITLAB_MCP_RATE_LIMIT_RPS, GITLAB_MCP_RATE_LIMIT_BURST e GITLAB_MCP_LOG_LEVEL; vanno impostate nella configurazione del client per questo server.

Può essere eseguito anche in locale a partire da un’immagine container in un registro OCI come Docker Hub o GitHub Container Registry: docker.io/jmrplens/gitlab-mcp-server:3.1.0@sha256:87e483299a2663a7a5d4d28679859b0c7fba2b1a421b7de2652441a569d4a2fc. Comunica via MCP su stdio, quindi il client lo avvia come programma e dialoga con esso tramite standard input e standard output. Richiede Docker o un altro runtime di container OCI; si avvia con docker run - il comando abituale è docker run -i --rm -e GITLAB_URL -e GITLAB_TOKEN -e GITLAB_MCP_SKIP_TLS_VERIFY -e GITLAB_MCP_TOOL_SURFACE -e GITLAB_MCP_CAPABILITY_SURFACE -e GITLAB_MCP_META_PARAM_SCHEMA -e GITLAB_MCP_TIER -e GITLAB_MCP_READ_ONLY -e GITLAB_MCP_SAFE_MODE -e GITLAB_MCP_EMBEDDED_RESOURCES -e GITLAB_MCP_EXCLUDE_TOOLS -e GITLAB_MCP_IGNORE_SCOPES -e GITLAB_MCP_UPLOAD_MAX_FILE_SIZE -e GITLAB_MCP_ALLOWED_IMPORT_DIRS -e GITLAB_MCP_RATE_LIMIT_RPS -e GITLAB_MCP_RATE_LIMIT_BURST -e GITLAB_MCP_LOG_LEVEL docker.io/jmrplens/gitlab-mcp-server:3.1.0@sha256:87e483299a2663a7a5d4d28679859b0c7fba2b1a421b7de2652441a569d4a2fc. Legge queste variabili d’ambiente: GITLAB_URL, GITLAB_TOKEN (obbligatorio, segreto), GITLAB_MCP_SKIP_TLS_VERIFY, GITLAB_MCP_TOOL_SURFACE, GITLAB_MCP_CAPABILITY_SURFACE, GITLAB_MCP_META_PARAM_SCHEMA, GITLAB_MCP_TIER, GITLAB_MCP_READ_ONLY, GITLAB_MCP_SAFE_MODE, GITLAB_MCP_EMBEDDED_RESOURCES, GITLAB_MCP_EXCLUDE_TOOLS, GITLAB_MCP_IGNORE_SCOPES, GITLAB_MCP_UPLOAD_MAX_FILE_SIZE, GITLAB_MCP_ALLOWED_IMPORT_DIRS, GITLAB_MCP_RATE_LIMIT_RPS, GITLAB_MCP_RATE_LIMIT_BURST e GITLAB_MCP_LOG_LEVEL; vanno impostate nella configurazione del client per questo server.

Può essere eseguito anche in locale a partire da un pacchetto Node.js pubblicato nel registro npm: @jmrp.io/gitlab-mcp-server, versione 3.1.0. Comunica via MCP su stdio, quindi il client lo avvia come programma e dialoga con esso tramite standard input e standard output. Richiede Node.js; i client in genere lo avviano con npx - il comando abituale è npx -y @jmrp.io/gitlab-mcp-server@3.1.0. Legge queste variabili d’ambiente: GITLAB_URL, GITLAB_TOKEN (obbligatorio, segreto), GITLAB_MCP_SKIP_TLS_VERIFY, GITLAB_MCP_TOOL_SURFACE, GITLAB_MCP_CAPABILITY_SURFACE, GITLAB_MCP_META_PARAM_SCHEMA, GITLAB_MCP_TIER, GITLAB_MCP_READ_ONLY, GITLAB_MCP_SAFE_MODE, GITLAB_MCP_EMBEDDED_RESOURCES, GITLAB_MCP_EXCLUDE_TOOLS, GITLAB_MCP_IGNORE_SCOPES, GITLAB_MCP_UPLOAD_MAX_FILE_SIZE, GITLAB_MCP_ALLOWED_IMPORT_DIRS, GITLAB_MCP_RATE_LIMIT_RPS, GITLAB_MCP_RATE_LIMIT_BURST e GITLAB_MCP_LOG_LEVEL; vanno impostate nella configurazione del client per questo server.

Può essere eseguito anche in locale a partire da un pacchetto Python pubblicato su PyPI: jmrplens-gitlab-mcp-server, versione 3.1.0. Comunica via MCP su stdio, quindi il client lo avvia come programma e dialoga con esso tramite standard input e standard output. Richiede Python; i client in genere lo avviano con uvx (di uv) o dopo pip install - il comando abituale è uvx jmrplens-gitlab-mcp-server. Legge queste variabili d’ambiente: GITLAB_URL, GITLAB_TOKEN (obbligatorio, segreto), GITLAB_MCP_SKIP_TLS_VERIFY, GITLAB_MCP_TOOL_SURFACE, GITLAB_MCP_CAPABILITY_SURFACE, GITLAB_MCP_META_PARAM_SCHEMA, GITLAB_MCP_TIER, GITLAB_MCP_READ_ONLY, GITLAB_MCP_SAFE_MODE, GITLAB_MCP_EMBEDDED_RESOURCES, GITLAB_MCP_EXCLUDE_TOOLS, GITLAB_MCP_IGNORE_SCOPES, GITLAB_MCP_UPLOAD_MAX_FILE_SIZE, GITLAB_MCP_ALLOWED_IMPORT_DIRS, GITLAB_MCP_RATE_LIMIT_RPS, GITLAB_MCP_RATE_LIMIT_BURST e GITLAB_MCP_LOG_LEVEL; vanno impostate nella configurazione del client per questo server.

Può essere eseguito anche in locale a partire da un pacchetto .NET pubblicato su NuGet: gitlab-mcp-server, versione 3.1.0. Comunica via MCP su stdio, quindi il client lo avvia come programma e dialoga con esso tramite standard input e standard output. Richiede l’SDK .NET; si esegue come strumento .NET; la voce indica dnx come ambiente di esecuzione. Legge queste variabili d’ambiente: GITLAB_URL, GITLAB_TOKEN (obbligatorio, segreto), GITLAB_MCP_SKIP_TLS_VERIFY, GITLAB_MCP_TOOL_SURFACE, GITLAB_MCP_CAPABILITY_SURFACE, GITLAB_MCP_META_PARAM_SCHEMA, GITLAB_MCP_TIER, GITLAB_MCP_READ_ONLY, GITLAB_MCP_SAFE_MODE, GITLAB_MCP_EMBEDDED_RESOURCES, GITLAB_MCP_EXCLUDE_TOOLS, GITLAB_MCP_IGNORE_SCOPES, GITLAB_MCP_UPLOAD_MAX_FILE_SIZE, GITLAB_MCP_ALLOWED_IMPORT_DIRS, GITLAB_MCP_RATE_LIMIT_RPS, GITLAB_MCP_RATE_LIMIT_BURST e GITLAB_MCP_LOG_LEVEL; vanno impostate nella configurazione del client per questo server.

Nel formato JSON mcpServers, letto da molti client MCP desktop e per editor di codice, la voce si presenta così (segnaposto tra parentesi angolari):

{
  "mcpServers": {
    "gitlab-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GITLAB_URL",
        "-e",
        "GITLAB_TOKEN",
        "-e",
        "GITLAB_MCP_SKIP_TLS_VERIFY",
        "-e",
        "GITLAB_MCP_TOOL_SURFACE",
        "-e",
        "GITLAB_MCP_CAPABILITY_SURFACE",
        "-e",
        "GITLAB_MCP_META_PARAM_SCHEMA",
        "-e",
        "GITLAB_MCP_TIER",
        "-e",
        "GITLAB_MCP_READ_ONLY",
        "-e",
        "GITLAB_MCP_SAFE_MODE",
        "-e",
        "GITLAB_MCP_EMBEDDED_RESOURCES",
        "-e",
        "GITLAB_MCP_EXCLUDE_TOOLS",
        "-e",
        "GITLAB_MCP_IGNORE_SCOPES",
        "-e",
        "GITLAB_MCP_UPLOAD_MAX_FILE_SIZE",
        "-e",
        "GITLAB_MCP_ALLOWED_IMPORT_DIRS",
        "-e",
        "GITLAB_MCP_RATE_LIMIT_RPS",
        "-e",
        "GITLAB_MCP_RATE_LIMIT_BURST",
        "-e",
        "GITLAB_MCP_LOG_LEVEL",
        "ghcr.io/jmrplens/gitlab-mcp-server:3.1.0@sha256:87e483299a2663a7a5d4d28679859b0c7fba2b1a421b7de2652441a569d4a2fc"
      ],
      "env": {
        "GITLAB_URL": "<valore>",
        "GITLAB_TOKEN": "<segreto>",
        "GITLAB_MCP_SKIP_TLS_VERIFY": "<valore>",
        "GITLAB_MCP_TOOL_SURFACE": "<valore>",
        "GITLAB_MCP_CAPABILITY_SURFACE": "<valore>",
        "GITLAB_MCP_META_PARAM_SCHEMA": "<valore>",
        "GITLAB_MCP_TIER": "<valore>",
        "GITLAB_MCP_READ_ONLY": "<valore>",
        "GITLAB_MCP_SAFE_MODE": "<valore>",
        "GITLAB_MCP_EMBEDDED_RESOURCES": "<valore>",
        "GITLAB_MCP_EXCLUDE_TOOLS": "<valore>",
        "GITLAB_MCP_IGNORE_SCOPES": "<valore>",
        "GITLAB_MCP_UPLOAD_MAX_FILE_SIZE": "<valore>",
        "GITLAB_MCP_ALLOWED_IMPORT_DIRS": "<valore>",
        "GITLAB_MCP_RATE_LIMIT_RPS": "<valore>",
        "GITLAB_MCP_RATE_LIMIT_BURST": "<valore>",
        "GITLAB_MCP_LOG_LEVEL": "<valore>"
      }
    }
  }
}

Ricavato dalla voce del registro; la verifica live riportata sopra mostra solo se l’endpoint ha risposto. Cosa fa il server, e a quali condizioni, lo stabilisce il suo editore; prima di concedergli l’accesso ai propri account o file conviene consultarne il repository o il sito web. Come aggiungere un server MCP a un assistente · Prima di collegare un server