Connect GitLab

The onboarding wizard opens automatically after you create a tenant. This page covers the first two steps: setting the GitLab base URL and registering the bot user.

Step 1 — GitLab base URL

Enter the root URL of your GitLab instance.

• For GitLab.com: https://gitlab.com
• For a self-managed instance: the URL you use to access the web UI, for example https://gitlab.example.com

Click Save and continue. Mate validates that the URL is well-formed before advancing.

Step 2 — Add a bot

Mate acts in GitLab as a dedicated bot account. You register the bot by pasting its Personal Access Token (PAT).

Create the PAT on GitLab

The console shows a direct link — Create a PAT on <your GitLab URL> — that opens the GitLab token creation page with the name mate-bot and the api scope pre-filled. Follow that link, set an expiry date if your policy requires one, and click Create personal access token. Copy the token before leaving the page.

If you prefer to navigate manually: in GitLab, go to User settings → Access tokens → Personal access tokens and create a token with the api scope.

Caution

The PAT must belong to the bot user account, not your own GitLab account. Every action the agent takes in GitLab will appear to come from the bot user.

Paste the PAT into Mate

Paste the token into the GitLab Personal Access Token (glpat-…) field and click Validate. Mate immediately validates it against GitLab (checking scope and that the account is active), encrypts it at rest, and registers the bot.

The PAT is not retrievable after submission. If you need to rotate it, return to Settings → Bots, remove the bot, and add a new one with the updated token.

Bot user prerequisites

Before submitting, confirm:

• The bot account is active in GitLab (not blocked or deactivated).
• The bot account has Maintainer access on every GitLab project you want Mate to work in. Add it via Project → Members in GitLab.

Once at least one bot is registered, click Continue.

Next: Create your first agent