Contact Us
Help Center Home > AI Gateway > Configure GitLab for the AI Gateway

Configure GitLab for the AI Gateway

To allow your users to securely query projects, issues, and merge requests using their AI clients, you can configure the GitLab Model Context Protocol (MCP) server within the JumpCloud AI Gateway.

Prerequisites

Before configuring specific enterprise applications, we recommend reviewing the Get Started: AI Gateway guide to familiarize yourself with the gateway architecture and core AI concepts (such as MCP servers and AI clients).

Completing Application Setup

Before you can connect this server to JumpCloud, you must configure the required authentication parameters within your GitLab workspace.

Refer to the official documentation for the GitLab MCP server to understand its architecture, and ensure the following prerequisites are met:

  • Enable the Server: The GitLab MCP server requires a Premium or Ultimate subscription. Ensure that GitLab Duo is enabled for your organization and that you are running a supported version of GitLab (the MCP server feature was introduced in Beta in GitLab 18.6).
  • Configure Server Settings: You must create an OAuth application in your GitLab workspace (either instance-wide or group-level, depending on your access policies). To allow JumpCloud to securely route authentication tokens, you must add the following Redirect URI in your GitLab OAuth application settings: https://ai.jumpcloud.com.
  • Authentication Method: JumpCloud strongly recommends using OAuth authentication for a seamless and secure end-user experience. You will need your GitLab Client ID, Client Secret, and the required scope (typically api for full access to GitLab Duo tools) to complete the setup.

Configuring the Server in JumpCloud

Once your prerequisites are met, register the GitLab server in the JumpCloud Admin Portal.

  1. Log in to the JumpCloud Admin Portal.

Important:

If your data is stored outside of the US, check which login URL you should be using depending on your region. If your organization uses LDAP, RADIUS, or requires firewall allow list configuration, the Fully Qualified Domain Names (FQDNs) will also be region specific. See JumpCloud Data Centers for the URLs, FQDNs, and IP addresses.

  1. Go to Access > AI Gateway.
  2. Select the Servers tab.
  3. Click + Add Server.
  4. In the App dropdown, select GitLab.
  5. Enter a name for the server and an optional prefix to prepend to the MCP tool names (for example, gitlab_).
  6. Enter the GitLab MCP server URL.
    • If you use GitLab.com, enter https://gitlab.com/api/v4/mcp.
    • If you use GitLab Self-Managed, enter https://<your-gitlab-domain>/api/v4/mcp.
  7. Under Authentication method, select OAuth.
  8. Under Advanced fields, enter your GitLab Client ID and required Scope.
  9. Click Create.

Your users will now see GitLab listed as an available application when they authenticate their AI clients through the JumpCloud gateway.

Back to Top

List IconIn this Article

Notebook IconLearn More

Get Started: AI Gateway

Supported AI Gateway Integrations

Still Have Questions?

If you cannot find an answer to your question in our FAQ, you can always contact us.

Submit a Case