Overview

GitLab tools let you add to your agent the capability to interact with GitLab issues, merge requests, pipelines, and code. This integration uses the official GitLab Model Context Protocol (MCP) to provide seamless access to your GitLab projects.

When you register the GitLab MCP from Dust, the integration automatically creates the necessary app on GitLab's side, streamlining the setup process.

Available Tools

The GitLab MCP integration provides the following tools:

Version & Info:

• get_mcp_server_version - Get the version of the GitLab MCP server

Issue Management:

• create_issue - Create new issues in GitLab projects
• get_issue - Retrieve issue details, comments, and metadata

Merge Request Operations:

• create_merge_request - Create new merge requests
• get_merge_request - Retrieve merge request details and metadata
• get_merge_request_commits - Get the list of commits in a merge request
• get_merge_request_diffs - Retrieve the diff/changes in a merge request
• get_merge_request_pipelines - Get pipeline information for a merge request

Pipeline Monitoring:

• get_pipeline_jobs - Retrieve jobs and their status for a specific pipeline

Search & Discovery:

• gitlab_search - Search across GitLab projects, issues, merge requests, and more
• semantic_code_search - Perform semantic search across your codebase

Workspace Setup and Authentication

See Managing Tools for details on how to make GitLab tools available to your workspace.

As an administrator:

1. Navigate to Administration → Tools
2. Click Add Tools
3. Select GitLab from the available MCP servers
4. Complete the OAuth authentication flow
5. The GitLab app will be automatically created on GitLab's side

The admin will be able to select if the tool uses personal or workspace credentials.

Workspace Credentials

All actions taken by your agents will be attributed to the authenticated workspace account.

Personal Credentials

All actions are taken as the user who invoked the agent. Each user will need to authenticate their own GitLab credentials to use these tools.

Adding GitLab Tools to Agents

GitLab tools can be added to an agent by selecting them in the agent builder. They require no additional configuration beyond the initial workspace setup.

In general, you will want to mention in the instructions of your agents which GitLab projects or groups you want them to interact with. Example instructions:

Our GitLab projects are:
- gitlab.com/myorg/main-app (main application repository)
- gitlab.com/myorg/infrastructure (infrastructure as code)

If not specified, the default project to consider is gitlab.com/myorg/main-app

Use Cases

Issue Management

Use GitLab tools to create agents that can:

• Automatically file issues based on support tickets or bug reports
• Search for existing issues before creating duplicates
• Retrieve issue details for status updates or reporting

Merge Request Workflows

Create agents that can:

• Create merge requests from code changes or feature descriptions
• Review merge request diffs and provide feedback
• Monitor pipeline status for merge requests
• Track merge request commits and changes

Code Search & Discovery

Enable agents to:

• Perform semantic searches across your codebase
• Find relevant code examples and implementations
• Discover related code changes and patterns

Pipeline Monitoring

Build agents that:

• Monitor CI/CD pipeline status
• Report on job failures and successes
• Track deployment progress