​

MatterAI GitLab Integration

• Automatically initiating AI-powered code reviews for new merge requests
• Displaying intelligent review comments directly within merge requests
• Providing real-time assistance through the MatterAI bot

​

Step 1: Choose Your GitLab Access Token Type

• Personal Access Token (PAT): Create a dedicated MatterAI service account and generate a PAT for it
• Group Access Token: For GitLab Premium/Ultimate users, generate a token that automatically creates a bot user

​

Step 2: Set Up a Personal Access Token

1. Create a new GitLab user specifically for MatterAI integration
2. Name the account matterai-yourdomain for easy identification
3. Use a **dedicated email address **for this account
4. Upload the MatterAI logo as the profile picture. You can find it here: https://raw.githubusercontent.com/GravityCloudAI/public-assets/refs/heads/main/logos/matter-logo.svg
5. Ensure this user has at least Developer access to your target repositories

​

Step 3: Generate Your Personal Access Token

1. Log in using the dedicated MatterAI service account
2. Click your avatar on the left sidebar
3. Select Edit Profile
4. Choose Access Tokens from the left menu
5. Click Add New Token
6. Enter a descriptive name and set an expiration date
7. Select the following scopes: api, read_api, read_user
8. Click Create Personal Access Token
9. Save the token securely (it will only be displayed once)

​

Alternative: Using Group Access Tokens

1. Navigate to your target group
2. Select Settings from the left sidebar
3. Choose Access Tokens within Settings
4. Create a Group Access Token with the api scope
5. Ensure Developer Access is granted

​

Step 4: Setup MatterAI Webhook

​

GitLab Configuration

1. Navigate to GitLab Webhooks for your Project. GitLab -> Projects -> Your Project -> Settings -> Webhooks
2. Click on Add a Webhook
3. Enter the webhook name and description. We recommend adding name as matterai and description as MatterAI Webhook for AI Code Reviews
4. Enter the following URL: https://api.matterai.so/api/v1/gitlab/webhook
5. Generate a Secret Token and copy it, this will be used to store in MatterAI Connectors
6. Select the Triggers for the Webhook**, MatterAI requires three triggers: Push events, Merge Request events and Comments
7. Save the Webhook

​

MatterAI Configuration

1. Navigate to MatterAI -> Connectors -> GitLab and click on Connect. Console URL: https://app.matterai.dev/connectors
2. Enter the GitLab Access Token and Webhook Secret Token in the form.
3. If you have self-hosted GitLab, enter then add Self-Hosted GitLab URL in the form. MatterAI IPs can be whitelisted in your network.
4. Click on Save
5. On GitLab, you can click on Test webhook with any of the event to confirm the webhook is working.
6. Your GitLab integration is now ready to use!

​

GitLab Code Reviews

​

AI Merge Request Summary

​

AI Merge Review Threads