MCP для GitFlic поверх gitflic-cli
gitflic-cli MCP-сервер
MCP-сервер с 76 типизированными инструментами поверх CLI для GitFlic: слияния, задачи, релизы, реестр пакетов, с фильтрами групп и read-only режимом
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Может создавать, редактировать и сливать запросы на слияние, задачи и релизы
- GITFLIC_MCP_NO_DESTRUCTIVE снимает только удаление, остальные мутации остаются доступны
- Токен дает доступ ко всем проектам, к которым имеет права владелец токена
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/gitflic-cli-mcp-serverОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
Выполните в терминале
claude mcp add --transport stdio --env 'GITFLIC_TOKEN=<ваш GITFLIC_TOKEN>' gitflic -- npx -y gitflic-cli-mcpИли добавьте в файл .mcp.json, в проекте
{
"mcpServers": {
"gitflic": {
"command": "npx",
"args": [
"-y",
"gitflic-cli-mcp"
],
"env": {
"GITFLIC_TOKEN": "<ваш GITFLIC_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
GITFLIC_TOKENсекрет, обязательнаяGITFLIC_MCP_GROUPSнеобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.
Добавьте в файл ~/.cursor/mcp.json, для всех проектов
{
"mcpServers": {
"gitflic": {
"command": "npx",
"args": [
"-y",
"gitflic-cli-mcp"
],
"env": {
"GITFLIC_TOKEN": "<ваш GITFLIC_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.
Ключи и настройки
GITFLIC_TOKENсекрет, обязательнаяGITFLIC_MCP_GROUPSнеобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.
Выполните в терминале
code --add-mcp '{"name":"gitflic","type":"stdio","command":"npx","args":["-y","gitflic-cli-mcp"],"env":{"GITFLIC_TOKEN":"<ваш GITFLIC_TOKEN>"}}'Или добавьте в файл .vscode/mcp.json, в проекте
{
"servers": {
"gitflic": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"gitflic-cli-mcp"
],
"env": {
"GITFLIC_TOKEN": "<ваш GITFLIC_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа servers.
Ключи и настройки
GITFLIC_TOKENсекрет, обязательнаяGITFLIC_MCP_GROUPSнеобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
codex mcp add gitflic --env 'GITFLIC_TOKEN=<ваш GITFLIC_TOKEN>' -- npx -y gitflic-cli-mcpИли добавьте в файл ~/.codex/config.toml, для всех проектов
[mcp_servers.gitflic]
command = "npx"
args = ["-y", "gitflic-cli-mcp"]
env = { GITFLIC_TOKEN = "<ваш GITFLIC_TOKEN>" }Если файл уже есть, допишите блок в конец.
Ключи и настройки
GITFLIC_TOKENсекрет, обязательнаяGITFLIC_MCP_GROUPSнеобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.gemini/settings.json, для всех проектов
{
"mcpServers": {
"gitflic": {
"command": "npx",
"args": [
"-y",
"gitflic-cli-mcp"
],
"env": {
"GITFLIC_TOKEN": "<ваш GITFLIC_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
GITFLIC_TOKENсекрет, обязательнаяGITFLIC_MCP_GROUPSнеобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов
{
"mcpServers": {
"gitflic": {
"command": "npx",
"args": [
"-y",
"gitflic-cli-mcp"
],
"env": {
"GITFLIC_TOKEN": "<ваш GITFLIC_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.
Ключи и настройки
GITFLIC_TOKENсекрет, обязательнаяGITFLIC_MCP_GROUPSнеобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Бывший Windsurf.
Добавьте в файл cline_mcp_settings.json, для всех проектов
{
"mcpServers": {
"gitflic": {
"command": "npx",
"args": [
"-y",
"gitflic-cli-mcp"
],
"env": {
"GITFLIC_TOKEN": "<ваш GITFLIC_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.
Ключи и настройки
GITFLIC_TOKENсекрет, обязательнаяGITFLIC_MCP_GROUPSнеобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл .roo/mcp.json, в проекте
{
"mcpServers": {
"gitflic": {
"command": "npx",
"args": [
"-y",
"gitflic-cli-mcp"
],
"env": {
"GITFLIC_TOKEN": "<ваш GITFLIC_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
GITFLIC_TOKENсекрет, обязательнаяGITFLIC_MCP_GROUPSнеобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Форк Roo Code, папки .roo те же.
Добавьте в файл opencode.json, в проекте
{
"mcp": {
"gitflic": {
"type": "local",
"command": [
"npx",
"-y",
"gitflic-cli-mcp"
],
"environment": {
"GITFLIC_TOKEN": "<ваш GITFLIC_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcp.
Ключи и настройки
GITFLIC_TOKENсекрет, обязательнаяGITFLIC_MCP_GROUPSнеобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/zed/settings.json, для всех проектов
{
"context_servers": {
"gitflic": {
"command": "npx",
"args": [
"-y",
"gitflic-cli-mcp"
],
"env": {
"GITFLIC_TOKEN": "<ваш GITFLIC_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа context_servers.
Ключи и настройки
GITFLIC_TOKENсекрет, обязательнаяGITFLIC_MCP_GROUPSнеобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл .codeassistant/mcp.json, в проекте
{
"mcpServers": {
"gitflic": {
"command": "npx",
"args": [
"-y",
"gitflic-cli-mcp"
],
"env": {
"GITFLIC_TOKEN": "<ваш GITFLIC_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
GITFLIC_TOKENсекрет, обязательнаяGITFLIC_MCP_GROUPSнеобязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Получи персональный токен GitFlic в настройках аккаунта и зарегистрируй сервер командой claude mcp add gitflic --env GITFLIC_TOKEN=<токен> -- npx -y gitflic-cli-mcp, при необходимости сузь набор переменной GITFLIC_MCP_GROUPS, например mr,issue.
Другие способы из описания автора
claude mcp add gitflic --env GITFLIC_TOKEN=xxxx -- npx -y gitflic-cli-mcpКоманда из README, токен нужно заменить на свой персональный токен GitFlic.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Пакет gitflic-cli-mcp оборачивает CLI gitflic-cli и один в один превращает его подкоманды в 76 типизированных инструментов MCP по стандарту stdio для GitFlic, российской платформы хостинга кода. Инструменты сгруппированы по сущностям: слияния, задачи, ветки, коммиты, блобы, проекты, релизы, теги, пользователи и вебхуки, часть операций пишущая, часть только читает. Набор можно сузить переменными окружения: GITFLIC_MCP_GROUPS оставляет только нужные группы, GITFLIC_MCP_READONLY убирает все мутирующие инструменты, GITFLIC_MCP_NO_DESTRUCTIVE снимает только семь удаляющих операций, не трогая создание и редактирование, а GITFLIC_MCP_TOOLS и GITFLIC_MCP_EXCLUDE дают точечный allowlist и denylist. Сервер также сжимает сырые ответы REST API GitFlic, убирая служебный шум вроде HAL-оберток и полей аватаров, чтобы не тратить токены модели впустую.
Для кого. Для разработчиков, которые ведут код на GitFlic и хотят управлять слияниями, задачами и релизами прямо из агента.
Подходит, если
- Репозиторий размещен на GitFlic, а не на GitHub или GitLab
- Нужен узкий набор инструментов под задачу, например только слияния и задачи
- Важно, чтобы модель не видела удаляющие операции без явного разрешения
Не подходит, если
- Код хранится на GitHub или GitLab: этот сервер только для GitFlic
- Нужен официальный административный инструмент GitFlic для самостоятельного хостинга: это отдельная утилита вендора
Пример запроса к агенту
Покажи открытые запросы на слияние в моем проекте на GitFlic и создай задачу по первому замечанию из ревьюОграничения
Проект небольшой и малоизвестный: один автор, минимум внешней обратной связи. Все 76 инструментов по умолчанию уходят хосту в tools/list, это заметная нагрузка на контекст модели, если не сузить набор переменными окружения. Для self-hosted GitFlic нужно отдельно указывать GITFLIC_API_BASE. Заявленное «100% покрытие REST API» и число инструментов не проверялись независимо.
Как отключить. Удалите сервер командой claude mcp remove gitflic или уберите блок gitflic из конфигурации клиента.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| GITFLIC_TOKEN обязательная, секрет | Персональный токен доступа GitFlic |
| GITFLIC_API_BASE | Адрес API для self-hosted GitFlic, если не используется gitflic.ru |
| GITFLIC_MCP_GROUPS | Список групп инструментов через запятую, например mr,issue |
| GITFLIC_MCP_READONLY | Значение 1 оставляет только инструменты без мутаций |
Проверка безопасности
- Может создавать, редактировать и сливать запросы на слияние, задачи и релизы
- GITFLIC_MCP_NO_DESTRUCTIVE снимает только удаление, остальные мутации остаются доступны
- Токен дает доступ ко всем проектам, к которым имеет права владелец токена
Коротко о README
README на русском объясняет, что MCP-сервер это тонкая прослойка над CLI: каждый тулз маппится на подкоманду gitflic. Дает запуск через npx с токеном в переменной GITFLIC_TOKEN, конфиги для Claude Code и Cursor, таблицу групп инструментов с числом read и write операций в каждой, порядок применения фильтров GROUPS, READONLY, NO_DESTRUCTIVE и TOOLS/EXCLUDE, список из семи удаляющих тулзов и раздел о сжатии сырых ответов REST API GitFlic для экономии токенов.
Частые вопросы
Нужно ли ставить сам gitflic-cli отдельно?
Нет, npx подтянет и gitflic-cli-mcp, и зависимость gitflic-cli автоматически.
Как запретить модели удалять что-либо?
Задать GITFLIC_MCP_NO_DESTRUCTIVE=1: семь инструментов с удалением пропадут из списка еще на этапе регистрации, а не через подтверждение в хосте.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything