[Go to site: main page, start]
Skip to main content

Command Palette

Search for a command to run...

Integrations

GitLab

The GitLab integration connects your repositories so you can use features like Cloud Agents and Bugbot.

Setup

Requires Cursor admin access and GitLab maintainer access.

  1. Go to Integrations in the dashboard
  2. Click Connect next to GitLab (or Manage Connections if already connected)
  3. Follow the GitLab installation flow
  4. Back on the Integrations tab, click Manage next to your GitLab connection and select Sync Repos
  5. Return to the dashboard to configure features on your repositories

To disconnect your GitLab account, return to the integrations dashboard and click Disconnect Account.

Advanced networking

Self-hosted instances support multiple connection methods beyond IP whitelisting.

Available for Enterprise customers. Allow Cursor to access your instance over a private network connection. See Private Connectivity or contact your Cursor representative for setup.

Best for: Instances behind a firewall on a private network, including AWS-hosted instances and environments that can run cloudflared

Security: HTTPS encryption, AWS PrivateLink, Cloudflare Tunnel, VPC allowlisting, service account access tokens

Drawbacks: Requires coordination with Cursor. Google Private Service Connect is not currently supported.

Available for Enterprise customers. Run a reverse proxy tunnel on-premises that establishes a long-lived websocket connection to Cursor's servers. Network requests are forwarded through to your instance. Requires no inbound network access. Contact your Cursor representative for setup.

Best for: Environments without inbound network access

Security: HTTPS encryption, service account access tokens

Drawbacks: Introduces additional complexity, maintenance requirements, and potential security considerations compared to more direct connection methods

Protected Git Scopes

Lock your GitLab group or namespace to your Cursor organization so only your teams can use its repositories with Cloud Agents, automations, and Bugbot. Protecting a scope requires the GitLab Owner role. See Protected Git Scopes.

Next steps

Once your GitLab integration is connected, configure the features that use it:

  • Bugbot — automated PR reviews that catch bugs and security issues
  • Cloud Agents — AI agents that run in the cloud on your repositories