Как подключить GitLab к Cursor через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → GitLab, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

GitLab + Cursor

Дайте ИИ работать в GitLab: находить проекты, разбирать и обновлять issues, проверять merge requests с диффами и комментариями, следить за пайплайнами и читать логи упавших джобов, а также читать ветки, коммиты и файлы. GitLab.com или ваш собственный экземпляр GitLab, с персональным токеном доступа.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

GITLAB_URL, GITLAB_TOKEN

Шаг 1 — Получите учётные данные

1. В GitLab нажмите на свой аватар → Edit profile → Access → Personal access tokens → Generate token. На GitLab.com это страница gitlab.com/-/user_settings/personal_access_tokens.
2. Задайте имя токена (например, «AnythingMCP»), укажите срок действия (на GitLab.com не больше 365 дней) и отметьте scope api. Для режима только для чтения отметьте вместо него read_api.
3. Сразу скопируйте токен: GitLab показывает его только один раз. Он начинается с glpat-.
4. Вставьте токен в GITLAB_TOKEN без слова Bearer. В GITLAB_URL укажите https://gitlab.com для GitLab.com или адрес вашего экземпляра Self-Managed или Dedicated в том виде, в каком вы открываете его в браузере (например, https://gitlab.example.com), без /api/v4 и без слеша в конце. Затем установите коннектор.
5. Начните с gitlab_get_current_user: инструмент показывает, какому пользователю GitLab принадлежит токен, и подтверждает, что адрес верный. Затем назовите ИИ проект по его пути, например my-group/my-project, или попросите найти его через gitlab_list_projects.

Срок действия и права токена: на GitLab.com токен действует не больше 365 дней. Когда срок истечёт, создайте новый токен с тем же scope и снова вставьте его в GITLAB_TOKEN. Коннектор действует от имени пользователя токена: ИИ видит и меняет ровно то, что может этот пользователь. Fine-grained персональный токен доступа (GitLab 19.2 и новее) работает так же: дайте ему права на чтение и запись для issues, merge requests, репозитория, пайплайнов и джобов нужных проектов. Некоторые группы на GitLab.com требуют fine-grained токены, и тогда классический токен получает в их проектах ошибку «Access denied: This operation requires a fine-grained personal access token». Project и group access tokens тоже подходят, но на GitLab.com для них нужен Premium или Ultimate.

Режим только для чтения: используйте токен с read_api и отключите gitlab_create_issue, gitlab_update_issue, gitlab_add_issue_note, gitlab_create_merge_request, gitlab_update_merge_request, gitlab_add_merge_request_note и gitlab_create_branch.

Выключены при установке: gitlab_delete_issue, который удаляет issue безвозвратно (это могут только владельцы проекта и администраторы, и обычно достаточно закрыть issue через gitlab_update_issue), и gitlab_delete_branch. Включайте их, только если ИИ должен удалять issues или ветки.

Проекты, issues и merge requests: инструменты принимают проект по числовому идентификатору или полному пути, например my-group/my-project. Issues и merge requests указываются по номеру, который показывает GitLab (#42, !17), а не по глобальному идентификатору. gitlab_list_project_members даёт идентификаторы пользователей для исполнителей и ревьюеров. gitlab_list_my_issues и gitlab_list_my_merge_requests работают по всем проектам и по умолчанию показывают элементы пользователя токена, включая merge requests, ожидающие его ревью.

Ревью, пайплайны и код: для ревью merge request ИИ читает gitlab_get_merge_request (статус слияния и конфликты), затем gitlab_get_merge_request_diffs постранично, gitlab_list_merge_request_commits и gitlab_list_merge_request_notes. Файл со слишком большим диффом возвращается без текста; тогда ИИ читает его через gitlab_get_file_content в исходной ветке. Для упавшего пайплайна он идёт от gitlab_list_pipelines к gitlab_list_pipeline_jobs (только упавшие джобы) и к gitlab_get_job_log. Файлы и логи джобов обрезаются на 200 КБ, начало сохраняется: более длинный лог откройте в GitLab. gitlab_search_project ищет по коду внутри одного проекта на любом тарифе; поиск по коду во всём экземпляре через gitlab_search требует advanced search, функции Premium.

Сначала подтверждение, потом запись: issues, комментарии, merge requests и ветки создаются от имени пользователя токена. ИИ сначала показывает вам заголовок, текст или ветку и ждёт подтверждения. Quick actions в комментарии, например /label, /assign, /close, /approve или /merge, GitLab выполняет, поэтому ИИ добавляет их, только если вы об этом просите. Для создания ветки нужен доступ уровня Developer.

Лимиты запросов: GitLab.com допускает около 2000 запросов к API в минуту на пользователя, 200 новых issues и 60 новых комментариев в минуту и 100 поисковых запросов в минуту. На экземпляре Self-Managed лимиты задаёт администратор. При превышении лимита GitLab отвечает 429: подождите и повторите попытку.

Частые ошибки: 401 означает, что токен неверный, истёк или отозван, либо GITLAB_URL указывает не на тот экземпляр, который его выдал. 403 означает, что не хватает scope (например, токен с read_api при записи) или роли недостаточно для действия. 404 означает, что проекта, issue или файла нет или пользователь их не видит: GitLab скрывает приватные ресурсы за ответом 404. 400 указывает на отсутствующее или неверное поле. 409 при создании merge request означает, что для этих веток уже есть открытый. Переименованный проект ещё отвечает на чтение по старому пути, но запись туда завершается ошибкой 405: используйте новый путь или числовой идентификатор.

У коннектора нет инструментов, чтобы сливать или одобрять merge requests, пушить коммиты, редактировать файлы или запускать, перезапускать и отменять пайплайны, и он не работает с переменными CI/CD, релизами, вики, пакетами, container registry и администрированием.

Шаг 2 — Установите адаптер

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Шаг 3 — Добавьте коннектор в Cursor

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Cursor читает MCP-серверы из ~/.cursor/mcp.json. Добавь эту запись:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
2. Сохрани файл и перезапусти Cursor.
3. Открой Cursor → Settings → MCP и проверь, что anythingmcp есть в списке и подключён.
4. Начинай общаться: агент теперь может вызывать инструменты GitLab.

Доступные инструменты

Примеры запросов

• «Какие merge requests во всех проектах ждут моего ревью, и у каких из них есть конфликты или упавший пайплайн?»
• «Почему упал последний пайплайн на main в my-group/web-app? Покажи упавший джоб и ошибку из его лога.»
• «Кратко опиши merge request !128 в my-group/web-app: что изменилось, в каких файлах и какие комментарии ревью ещё не решены.»
• «Создай issue в my-group/web-app с заголовком «Кнопка оформления заказа съезжает на мобильных», с меткой bug, и назначь его на Лену.»

FAQ

Поддерживает ли Cursor собственные MCP-серверы на бесплатном тарифе? Да, MCP доступен на тарифах Hobby, Pro и Business.

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT