gitflic-mcp
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@gitflic-mcplist issues in the project myorg/myproject"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
gitflic-mcp
Первый и единственный MCP-сервер для GitFlic — российской платформы для хостинга Git-репозиториев.
66 инструментов покрывающих 13 категорий GitFlic API: проекты, issue, merge request, ветки, коммиты, файлы, теги, релизы, обсуждения, вебхуки, CI/CD и другие.
Построен на TypeScript и Model Context Protocol SDK.
Зачем
Единственный MCP-сервер для GitFlic. Альтернатив нет — если вам нужен AI-агент для работы с GitFlic, это он.
Широкое покрытие API. 66 инструментов из 182 задокументированных эндпоинтов — все ключевые операции для повседневной работы с репозиториями.
Готов к работе. Подключается к Claude Code, Claude Desktop, Cursor и любому другому MCP-совместимому клиенту за минуту.
Минимальные зависимости. Только MCP SDK и Zod — никаких тяжёлых фреймворков.
Установка
Требования
Node.js 18+
Токен доступа GitFlic
Сборка
git clone https://gitflic.ru/project/sazonovfm/gitflic-mcp.git
cd gitflic-mcp
npm install
npm run buildНастройка MCP-клиента
Добавьте сервер в конфигурацию вашего MCP-клиента. Например, для Claude Code (.mcp.json в корне проекта):
{
"mcpServers": {
"gitflic": {
"command": "node",
"args": ["/абсолютный/путь/к/gitflic-mcp/dist/index.js"],
"env": {
"GITFLIC_TOKEN": "ваш_токен"
}
}
}
}Токен можно получить в настройках GitFlic: Настройки → Токены доступа.
Переменная | Описание | Обязательная |
| Токен доступа GitFlic API | да |
| Базовый URL API (по умолчанию | нет |
Инструменты
66 инструментов, сгруппированных по 13 категориям. Все параметры пагинации (page, size) опциональны: page по умолчанию 0, size по умолчанию 20 (макс. 100).
Пользователи
get_me
Получить текущего авторизованного пользователя.
Параметры: нет.
get_user
Получить пользователя по алиасу.
Параметр | Тип | Обяз. | Описание |
| string | да | Алиас (username) пользователя |
list_user_projects
Список публичных проектов пользователя.
Параметр | Тип | Обяз. | Описание |
| string | да | Алиас пользователя |
| number | нет | Номер страницы (с 0) |
| number | нет | Элементов на странице |
Проекты
list_projects
Список проектов авторизованного пользователя.
Параметр | Тип | Обяз. | Описание |
| string | нет | Поиск по названию |
| number | нет | Номер страницы (с 0) |
| number | нет | Элементов на странице |
get_project
Получить проект по владельцу и алиасу.
Параметр | Тип | Обяз. | Описание |
| string | да | Алиас владельца |
| string | да | Алиас проекта |
search_projects
Поиск публичных проектов.
Параметр | Тип | Обяз. | Описание |
| string | нет | Поисковый запрос |
| number | нет | Номер страницы (с 0) |
| number | нет | Элементов на странице |
list_shared_projects
Список проектов, к которым предоставлен доступ.
Параметр | Тип | Обяз. | Описание |
| string | нет | Поиск по названию |
| number | нет | Номер страницы (с 0) |
| number | нет | Элементов на странице |
update_project
Обновить настройки проекта (название, описание, язык, топики).
Параметр | Тип | Обяз. | Описание |
| string | да | Алиас владельца |
| string | да | Алиас проекта |
| string | нет | Название проекта |
| string | нет | Описание проекта |
| string | нет | Язык программирования |
| string[] | нет | Топики проекта |
list_project_members
Список участников проекта.
Параметр | Тип | Обяз. | Описание |
| string | да | Алиас владельца |
| string | да | Алиас проекта |
| string | нет | Поиск по username |
| number | нет | Номер страницы (с 0) |
| number | нет | Элементов на странице |
Issue
list_issues
Список issue проекта.
Параметр | Тип | Обяз. | Описание |
| string | да | Алиас владельца |
| string | да | Алиас проекта |
| number | нет | Номер страницы (с 0) |
| number | нет | Элементов на странице |
get_issue
Получить issue по локальному ID.
Параметр | Тип | Обяз. | Описание |
| string | да | Алиас владельца |
| string | да | Алиас проекта |
| integer | да | Локальный ID issue |
create_issue
Создать новый issue.
Параметр | Тип | Обяз. | Описание |
| string | да | Алиас владельца |
| string | да | Алиас проекта |
| string | да | Заголовок |
| string | да | Описание |
| string | нет | Статус: |
update_issue
Обновить существующий issue.
Параметр | Тип | Обяз. | Описание |
| string | да | Алиас владельца |
| string | да | Алиас проекта |
| integer | да | Локальный ID issue |
| string | нет | Новый заголовок |
| string | нет | Новое описание |
| string | нет | Новый статус: |
Комментарии к issue
list_issue_comments
Список комментариев к issue.
Параметр | Тип | Обяз. | Описание |
| string | да | Алиас владельца |
| string | да | Алиас проекта |
| integer | да | Локальный ID issue |
| number | нет | Номер страницы (с 0) |
| number | нет | Элементов на странице |
add_issue_comment
Добавить комментарий к issue.
Параметр | Тип | Обяз. | Описание |
| string | да | Алиас владельца |
| string | да | Алиас проекта |
| integer | да | Локальный ID issue |
| string | да | Текст комментария |
Файлы репозитория
get_file_content
Получить содержимое файла (до 15 МБ, только текстовые).
Параметр | Тип | Обяз. | Описание |
| string | да | Алиас владельца |
| string | да | Алиас проекта |
| string | да | Путь к файлу (например |
| string | да | Хеш коммита или имя ветки |
list_files
Список файлов и директорий по указанному пути.
Параметр | Тип | Обяз. | Описание |
| string | да | Алиас владельца |
| string | да | Алиас проекта |
| string | нет | Путь к директории (пусто для корня) |
| string | нет | Имя ветки |
list_files_recursive
Рекурсивный список файлов (дерево репозитория).
Параметр | Тип | Обяз. | Описание |
| string | да | Алиас владельца |
| string | да | Алиас проекта |
| string | нет | Корневая директория |
| string | нет | Хеш коммита или имя ветки |
| number | нет | Глубина рекурсии (0–10) |
Merge Request
list_merge_requests
Список merge request проекта.
Параметр | Тип | Обяз. | Описание |
| string | да | Алиас владельца |
| string | да | Алиас проекта |
| number | нет | Номер страницы (с 0) |
| number | нет | Элементов на странице |
get_merge_request
Получить merge request по локальному ID.
Параметр | Тип | Обяз. | Описание |
| string | да | Алиас владельца |
| string | да | Алиас проекта |
| integer | да | Локальный ID merge request |
create_merge_request
Создать merge request.
Параметр | Тип | Обяз. | Описание |
| string | да | Алиас владельца |
| string | да | Алиас проекта |
| string | да | Заголовок |
| string | да | Описание |
| string | да | Исходная ветка |
| string | да | Целевая ветка |
| boolean | нет | Сжать коммиты при слиянии |
| boolean | нет | Удалить исходную ветку после слияния |
update_merge_request
Обновить merge request.
Параметр | Тип | Обяз. | Описание |
| string | да | Алиас владельца |
| string | да | Алиас проекта |
| string | да | UUID merge request (из ответа get_merge_request) |
| string | да | Заголовок |
| string | да | Целевая ветка |
| string | нет | Описание |
| boolean | нет | Сжать коммиты при слиянии |
| boolean | нет | Удалить исходную ветку после слияния |
approve_merge_request
Одобрить или отменить одобрение merge request (переключатель).
Параметр | Тип | Обяз. | Описание |
| string | да | Алиас владельца |
| string | да | Алиас проекта |
| integer | да | Локальный ID merge request |
merge_merge_request
Выполнить слияние merge request.
Параметр | Тип | Обяз. | Описание |
| string | да | Алиас владельца |
| string | да | Алиас проекта |
| integer | да | Локальный ID merge request |
| string | нет | Сообщение коммита слияния |
| string | нет | Сообщение squash-коммита |
close_merge_request
Закрыть merge request.
Параметр | Тип | Обяз. | Описание |
| string | да | Алиас владельца |
| string | да | Алиас проекта |
| integer | да | Локальный ID merge request |
cancel_merge_request
Отменить merge request.
Параметр | Тип | Обяз. | Описание |
| string | да | Алиас владельца |
| string | да | Алиас проекта |
| integer | да | Локальный ID merge request |
Обсуждения MR
list_mr_discussions
Список обсуждений merge request.
Параметр | Тип | Обяз. | Описание |
| string | да | Алиас владельца |
| string | да | Алиас проекта |
| integer | да | Локальный ID merge request |
| number | нет | Номер страницы (с 0) |
| number | нет | Элементов на странице |
get_mr_discussion
Получить обсуждение по UUID.
Параметр | Тип | Обяз. | Описание |
| string | да | Алиас владельца |
| string | да | Алиас проекта |
| integer | да | Локальный ID merge request |
| string | да | UUID обсуждения |
create_mr_discussion
Создать обсуждение (общий комментарий или к строке кода).
Параметр | Тип | Обяз. | Описание |
| string | да | Алиас владельца |
| string | да | Алиас проекта |
| integer | да | Локальный ID merge request |
| string | да | Текст сообщения |
| string | нет | Путь к файлу (старая версия), для комментария к коду |
| string | нет | Путь к файлу (новая версия), для комментария к коду |
| integer | нет | Номер строки (старая версия) |
| integer | нет | Номер строки (новая версия) |
reply_mr_discussion
Ответить в существующем обсуждении.
Параметр | Тип | Обяз. | Описание |
| string | да | Алиас владельца |
| string | да | Алиас проекта |
| integer | да | Локальный ID merge request |
| string | да | UUID обсуждения |
| string | да | Текст ответа |
resolve_mr_discussion
Разрешить (закрыть) обсуждение.
Параметр | Тип | Обяз. | Описание |
| string | да | Алиас владельца |
| string | да | Алиас проекта |
| integer | да | Локальный ID merge request |
| string | да | UUID обсуждения |
delete_mr_discussion
Удалить обсуждение (весь тред).
Параметр | Тип | Обяз. | Описание |
| string | да | Алиас владельца |
| string | да | Алиас проекта |
| integer | да | Локальный ID merge request |
| string | да | UUID обсуждения |
Ветки
list_branches
Список веток проекта.
Параметр | Тип | Обяз. | Описание |
| string | да | Алиас владельца |
| string | да | Алиас проекта |
| number | нет | Номер страницы (с 0) |
| number | нет | Элементов на странице |
get_branch
Получить ветку по имени.
Параметр | Тип | Обяз. | Описание |
| string | да | Алиас владельца |
| string | да | Алиас проекта |
| string | да | Имя ветки |
get_default_branch
Получить ветку по умолчанию.
Параметр | Тип | Обяз. | Описание |
| string | да | Алиас владельца |
| string | да | Алиас проекта |
create_branch
Создать ветку от существующей.
Параметр | Тип | Обяз. | Описание |
| string | да | Алиас владельца |
| string | да | Алиас проекта |
| string | да | Имя новой ветки |
| string | да | Базовая ветка |
delete_branch
Удалить ветку.
Параметр | Тип | Обяз. | Описание |
| string | да | Алиас владельца |
| string | да | Алиас проекта |
| string | да | Имя ветки |
Внимание:
delete_branchне работает наapi.gitflic.ru— возвращает 405 Method Not Allowed. Это ограничение GitFlic API, не ошибка MCP-сервера. Используйтеgit push origin :refs/heads/имя-веткикак альтернативу.
compare_branches
Сравнить две ветки — список изменённых файлов.
Параметр | Тип | Обяз. | Описание |
| string | да | Алиас владельца |
| string | да | Алиас проекта |
| string | да | Сравниваемая ветка |
| string | нет | Базовая ветка (по умолчанию — ветка по умолчанию) |
Коммиты
list_commits
Список коммитов ветки.
Параметр | Тип | Обяз. | Описание |
| string | да | Алиас владельца |
| string | да | Алиас проекта |
| string | нет | Имя ветки (по умолчанию — ветка по умолчанию) |
| number | нет | Номер страницы (с 0) |
| number | нет | Элементов на странице |
get_commit
Получить коммит по хешу.
Параметр | Тип | Обяз. | Описание |
| string | да | Алиас владельца |
| string | да | Алиас проекта |
| string | да | Хеш коммита |
get_commit_files
Список файлов, изменённых в коммите.
Параметр | Тип | Обяз. | Описание |
| string | да | Алиас владельца |
| string | да | Алиас проекта |
| string | да | Хеш коммита |
diff_commits
Diff между двумя коммитами.
Параметр | Тип | Обяз. | Описание |
| string | да | Алиас владельца |
| string | да | Алиас проекта |
| string | да | Хеш исходного коммита |
| string | да | Хеш целевого коммита |
Теги
list_tags
Список тегов проекта.
Параметр | Тип | Обяз. | Описание |
| string | да | Алиас владельца |
| string | да | Алиас проекта |
| number | нет | Номер страницы (с 0) |
| number | нет | Элементов на странице |
get_tag
Получить тег по имени.
Параметр | Тип | Обяз. | Описание |
| string | да | Алиас владельца |
| string | да | Алиас проекта |
| string | да | Имя тега |
create_tag
Создать тег.
Параметр | Тип | Обяз. | Описание |
| string | да | Алиас владельца |
| string | да | Алиас проекта |
| string | да | Имя тега |
| string | нет | Сообщение (аннотированный тег) |
| string | нет | Хеш коммита (указать |
| string | нет | Имя ветки для тега на HEAD (указать |
Релизы
list_releases
Список релизов проекта.
Параметр | Тип | Обяз. | Описание |
| string | да | Алиас владельца |
| string | да | Алиас проекта |
| number | нет | Номер страницы (с 0) |
| number | нет | Элементов на странице |
get_release
Получить релиз по UUID.
Параметр | Тип | Обяз. | Описание |
| string | да | Алиас владельца |
| string | да | Алиас проекта |
| string | да | UUID релиза |
get_latest_release
Получить последний релиз проекта.
Параметр | Тип | Обяз. | Описание |
| string | да | Алиас владельца |
| string | да | Алиас проекта |
create_release
Создать релиз.
Параметр | Тип | Обяз. | Описание |
| string | да | Алиас владельца |
| string | да | Алиас проекта |
| string | да | Название релиза |
| string | да | Описание релиза |
| string | да | Имя тега |
| boolean | нет | Пометить как пре-релиз |
| boolean | нет | Прикрепить архив проекта |
| string | нет | Формат архива: |
update_release
Обновить релиз.
Параметр | Тип | Обяз. | Описание |
| string | да | Алиас владельца |
| string | да | Алиас проекта |
| string | да | UUID релиза |
| string | да | Название релиза |
| string | да | Имя тега |
| string | нет | Описание релиза |
| boolean | нет | Пометить как пре-релиз |
delete_release
Удалить релиз.
Параметр | Тип | Обяз. | Описание |
| string | да | Алиас владельца |
| string | да | Алиас проекта |
| string | да | UUID релиза |
Вебхуки
list_webhooks
Список вебхуков проекта.
Параметр | Тип | Обяз. | Описание |
| string | да | Алиас владельца |
| string | да | Алиас проекта |
| number | нет | Номер страницы (с 0) |
| number | нет | Элементов на странице |
get_webhook
Получить вебхук по ID.
Параметр | Тип | Обяз. | Описание |
| string | да | Алиас владельца |
| string | да | Алиас проекта |
| string | да | UUID вебхука |
create_webhook
Создать вебхук.
Параметр | Тип | Обяз. | Описание |
| string | да | Алиас владельца |
| string | да | Алиас проекта |
| string | да | URL обратного вызова |
| string | да | Секретный ключ |
| string[] | да | Список событий (см. ниже) |
update_webhook
Обновить вебхук.
Параметр | Тип | Обяз. | Описание |
| string | да | Алиас владельца |
| string | да | Алиас проекта |
| string | да | UUID вебхука |
| string | да | URL обратного вызова |
| string | да | Секретный ключ |
| string[] | да | Список событий (см. ниже) |
delete_webhook
Удалить вебхук.
Параметр | Тип | Обяз. | Описание |
| string | да | Алиас владельца |
| string | да | Алиас проекта |
| string | да | UUID вебхука |
События вебхуков
COLLABORATOR_ADD, COLLABORATOR_DELETE, COLLABORATOR_UPDATE, ISSUE_CREATE, ISSUE_UPDATE, NEW_ISSUE_NOTE, TAG_CREATE, TAG_DELETE, BRANCH_CREATE, BRANCH_UPDATE, BRANCH_DELETE, MERGE_REQUEST_CREATE, MERGE_REQUEST_UPDATE, MERGE_REQUEST_CLOSE, MERGE_REQUEST_CANCEL, MERGE_REQUEST_ACCEPT, MERGE, DISCUSSION_CREATE, DISCUSSION_COMMENT_CREATE, PIPELINE_NEW, PIPELINE_SUCCESS, PIPELINE_FAIL, WEBHOOK_SEND
CI/CD
list_pipelines
Список пайплайнов проекта.
Параметр | Тип | Обяз. | Описание |
| string | да | Алиас владельца |
| string | да | Алиас проекта |
| number | нет | Номер страницы (с 0) |
| number | нет | Элементов на странице |
start_pipeline
Запустить пайплайн.
Параметр | Тип | Обяз. | Описание |
| string | да | Алиас владельца |
| string | да | Алиас проекта |
| string | нет | Имя ветки или тега (по умолчанию — ветка по умолчанию) |
| boolean | нет |
|
| object[] | нет | Переменные: |
list_pipeline_jobs
Список задач пайплайна.
Параметр | Тип | Обяз. | Описание |
| string | да | Алиас владельца |
| string | да | Алиас проекта |
| integer | да | Локальный ID пайплайна |
| number | нет | Номер страницы (с 0) |
| number | нет | Элементов на странице |
restart_pipeline
Перезапустить пайплайн.
Параметр | Тип | Обяз. | Описание |
| string | да | Алиас владельца |
| string | да | Алиас проекта |
| integer | да | Локальный ID пайплайна |
cancel_pipeline
Отменить запущенный пайплайн.
Параметр | Тип | Обяз. | Описание |
| string | да | Алиас владельца |
| string | да | Алиас проекта |
| integer | да | Локальный ID пайплайна |
get_job
Получить информацию о задаче.
Параметр | Тип | Обяз. | Описание |
| string | да | Алиас владельца |
| string | да | Алиас проекта |
| integer | да | Локальный ID задачи |
list_job_artifacts
Список артефактов задачи.
Параметр | Тип | Обяз. | Описание |
| string | да | Алиас владельца |
| string | да | Алиас проекта |
| integer | да | Локальный ID задачи |
restart_job
Перезапустить задачу.
Параметр | Тип | Обяз. | Описание |
| string | да | Алиас владельца |
| string | да | Алиас проекта |
| integer | да | Локальный ID задачи |
cancel_job
Отменить запущенную задачу.
Параметр | Тип | Обяз. | Описание |
| string | да | Алиас владельца |
| string | да | Алиас проекта |
| integer | да | Локальный ID задачи |
list_cicd_variables
Список CI/CD переменных проекта.
Параметр | Тип | Обяз. | Описание |
| string | да | Алиас владельца |
| string | да | Алиас проекта |
Известные ограничения
delete_branchне работает. GitFlic API наapi.gitflic.ruне поддерживает метод DELETE для веток (405 Method Not Allowed). Используйтеgit push origin :refs/heads/имя-веткикак альтернативу.CI/CD требует настройки. Для работы инструментов
start_pipeline,restart_pipeline,cancel_pipelineи операций с задачами необходим файл.gitflic-ci.yamlв репозитории и подключённый runner.
Лицензия
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/revenant20/gitflic-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server