It integrates the Model Context Protocol (MCP) server for GitLab into the Zed editor, enabling project management and file operations through the GitLab API. Designed for Zed users who want to interact with GitLab directly within their editor.
Details
Author
akbxr
Downloads
258
Categories
Developer Tools
Jump to
- Seamless integration with GitLab API for project management and file operations.
- Support for both gitlab.com and self-hosted GitLab instances via optional API URL.
- Automatic authentication using GitLab personal access tokens.
- Agent mode support for AI-assisted interactions within Zed.
Install via Zed’s extension system (Zed > Extensions or command palette). Configure your personal access token in settings.json under context_server > mcp-server-gitlab > settings. For self-hosted GitLab, add a gitlab_api_url. To use in agent mode, enable the server in agent settings and in the assistant profile under tools.
# 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](https://github.com/zed-industries/zed/blob/main/assets/keymaps/default-macos.json#L581), [Linux](https://github.com/zed-industries/zed/blob/main/assets/keymaps/default-linux.json#L459)) to search `extensions`
## Configuration
### Required Settings
You need to configure the following settings in your `settings.json`:
```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:
```json
{
"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.
No reviews yet — be the first
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
Social sign-in isn’t configured yet. You can still create an account with email below, or ask an admin to add Google/GitHub/Discord OAuth credentials.
A collection of reference implementations for the Model Context Protocol (MCP), demonstrating secure and controlled access to tools and data sources for Large…