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 — никаких тяжёлых фреймворков.
Related MCP server: GitCode MCP Server
Установка
Требования
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.
Лицензия
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- AlicenseAqualityAmaintenanceAn MCP server providing comprehensive Gitea API coverage with 186 tools for managing repositories, issues, pull requests, and CI/CD workflows. It enables autonomous AI agents to perform complex development and administrative tasks directly through a Gitea instance.7MIT
- Alicense-qualityDmaintenanceMCP server for the GitCode API, enabling AI assistants to interact with GitCode repositories, issues, pull requests, and more.1MIT
- AlicenseBqualityDmaintenanceMCP server that exposes 39 tools for GitBook API automation, enabling AI agents to manage documentation, change requests, reviews, and Git Sync.39524MIT
- Alicense-qualityBmaintenanceMCP server for OpenDev Gitea and Gerrit APIs, enabling repository browsing, code review, and change management for LLM agents.Apache 2.0
Related MCP Connectors
Go MCP server for GitLab: 2 dynamic tools reach 1000+ REST/GraphQL actions. Free/CE, no paid tier.
A MCP server built for developers enabling Git based project management with project and personal…
Free public MCP for AI agents — 193 tools, 44 workflows. No API key.
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