What is Gitlab Mcp Zed

gitlab-mcp-zed is a Zed extension that integrates the Model Context Protocol (MCP) server for GitLab, allowing users to manage projects and perform file operations directly within the Zed editor.

Use cases

Use cases for gitlab-mcp-zed include managing GitLab projects, performing file operations like commits and merges, and enhancing productivity in coding workflows by integrating GitLab functionalities directly into the Zed editor.

How to use

To use gitlab-mcp-zed, install it via the Zed Extensions menu or command palette. Configure the required settings in your settings.json file, including your GitLab personal access token. For self-hosted instances, you can also specify a custom API URL.

Key features

Key features include seamless GitLab integration for project management and file operations, support for both gitlab.com and self-hosted GitLab instances, and automatic authentication using personal access tokens.

Where to use

gitlab-mcp-zed is primarily used in software development environments where GitLab is utilized for version control and project management, particularly within the Zed code editor.

GitLab MCP Server Extension for Zed

This is a Zed extension that integrates the Model Context Protocol (MCP) server for GitLab, enabling project management, file operations, and more within the Zed editor.

Features

• GitLab Integration: Seamless integration with GitLab API for project management and file operations
• Optional API URL: Support for both gitlab.com and self-hosted GitLab instances
• Automatic Authentication: Handles GitLab authentication using personal access tokens

Installation

Navigate to: Zed > Extensions Or use the command palette (macOS, Linux) to search extensions

Configuration

Required Settings

You need to configure the following settings in your settings.json:

{
  "context_server": {
    "mcp-server-gitlab": {
      "settings": {
        "gitlab_personal_access_token": "YOUR_TOKEN"
      }
    }
  }
}

Optional Settings

For self-hosted GitLab instances, you can specify a custom API URL:

{
  "context_server": {
    "mcp-server-gitlab": {
      "settings": {
        "gitlab_personal_access_token": "YOUR_TOKEN",
        "gitlab_api_url": "https://your-gitlab-instance.com/api/v4"
      }
    }
  }
}

Agent Mode Configuration

If you’re using Zed’s agent mode, you need to enable this context server for your assistant:

1. Open Zed’s Agent settings
2. Enable the Gitlab MCP server. If you see that the status of the tool is a red dot, make sure you added your gitlab_personal_access_token in settings.json.
3. Enable the Gitlab MCP Server in the active assistant profile. In the chat section, click on the Write | Ask button, then click on tools, then enable the Gitlab MCP server.

Personal Access Token

To create a GitLab Personal Access Token:

1. Go to GitLab User Settings > Access Tokens
2. Select the required scopes:
   • api for full API access
   • read_api for read-only access
   • read_repository and write_repository for repository operations
3. Create the token and save it securely
4. Add the token to your Zed settings as shown above

Building from Source

1. Ensure you have Rust and Cargo installed
2. Clone the repository
3. Run cargo build --release

License

Apache-2.0

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.