> ## Documentation Index
> Fetch the complete documentation index at: https://docs.utopikai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GitLab Connector

> Access knowledge from your GitLab repositories

## How it works

The GitLab Connector picks up all of the Merge Requests and Issues in a specified repository.

* It will index both Open and Closed MRs. This includes the Title and Summary.
* It will index Issues (and Incidents) including comments both Open and Closed.
* Includes certain other metadata such as the URL, creator, etc.

## Setting up

### Authorization

1. This Connector uses a GitLab Access Token.
2. Log in to GitLab.
3. On the left sidebar, select your avatar.
4. Select Edit **profile**.
5. Select **Add new token**.

<img src="https://mintcdn.com/utopikai/fX4Gfjw1E606KuQ9/images/connectors/gitlab/GitlabConnectorAuth.gif?s=f476b05e835f53257c2c99ff3a44fcf3" alt="GitlabConnectorAuth" width="2444" height="1462" data-path="images/connectors/gitlab/GitlabConnectorAuth.gif" />

6. Enter a name and expiry date for the token.
   * The token expires on that date at midnight UTC.
   * If you do not enter an expiry date, the expiry date is automatically set to 365 days later than the current date.
   * By default, this date can be a maximum of 365 days later than the current date.
7. Select the desired scopes, further details [here](https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html#personal-access-token-scopes).
8. Select **Create personal access token**.

### Indexing

1. Navigate to the Admin Dashboard and select the **GitLab** Connector
2. If you're using GitLab Cloud and not self-hosting, keep the GitLab URL as the default
3. For a project with a url such as "[https://gitlab.com/UtopikAI-ai/UtopikAI](https://gitlab.com/UtopikAI-ai/UtopikAI)", configure it as below:

<img src="https://mintcdn.com/utopikai/fX4Gfjw1E606KuQ9/images/connectors/gitlab/GitlabConnector.png?fit=max&auto=format&n=fX4Gfjw1E606KuQ9&q=85&s=64dd867760bab83bb5f07b7efd80e7b0" alt="GitLabConnector" width="1442" height="1118" data-path="images/connectors/gitlab/GitlabConnector.png" />
