Connect GitLab
Connect GitLab to Claude Tag for repo access and merge-request comments. Covers token permissions, self-managed hostnames, and how it differs from GitHub.
Claude Tag is in public beta. Features and behavior described here may change before general availability.
Note: Connections are added inside an Access bundle. At claude.ai/admin-settings/claude-tag, open Access bundles in the left navigation, click into a bundle (or Create one), and go to its Credentials tab.
Connecting GitLab lets Claude clone repositories, read and search projects, comment on issues and merge requests, and check pipeline status, all through the GitLab REST API. The connection is a single access token added to a bundle.
Pair this connection with the GitLab plugin from Anthropic's plugin marketplace so Claude knows how to call the API; see Attach plugins.
Add the connection
- Create the token in GitLab. A project access token or group access token, so activity is attributed to a bot identity rather than a person. Grant the
apiscope for read and write;read_apifor read-only. The token starts withglpat-. - Add the credential to a bundle. On the bundle's Credentials tab, click Connect next to GitLab and paste the token. For self-managed GitLab, switch to the form's Advanced tab and add your instance's hostname under Allowed websites.
You'll see: GitLab listed in the bundle's connections, and @Claude what can you access from this channel? returns it in a new thread under the bundle's scope.
| Field | Value |
|---|---|
| Claude's personal access token | The token from GitLab, starting with glpat-. Project and group access tokens work here too; the label is the field name, not a token-type constraint. |
| Allowed websites | gitlab.com (preset). For self-managed GitLab, open the Advanced tab and add your instance's hostname here. |
GitLab's own guide for creating tokens is at docs.gitlab.com.
How GitLab differs from GitHub
| GitLab | GitHub | |
|---|---|---|
| Auth | One org-level access token | The Claude GitHub App, installed separately |
| Attaching a repo in a thread | Give Claude the full repository URL; it clones it | Typing owner/repo in the message auto-attaches it |
| Self-managed | Your hostname under Advanced → Allowed websites | GitHub Enterprise setup |
The token is auto-injected on every request to your GitLab host and used as the credential when cloning repositories into a session. The model and the sandbox are not given the key; see how Agent Proxy works.
Related resources
- What this connection adds: the code use cases
- Configure GitHub access: the GitHub App path, which is different
- Give Claude access: the full credential-type and allowed-hosts reference
c9b77dfce0a14d67 · verify