forkflux-mcp — MCP-сервер для Claude Code
Связывает ИИ-ассистентов с вашим self-hosted ForkFlux API: агенты публикуют задачи, забирают их и ведут журнал передачи контекста.
claude mcp add --env FORKFLUX_API_KEY=<FORKFLUX_API_KEY> --env FORKFLUX_API_URL=<FORKFLUX_API_URL> --transport stdio mcp -- uvx forkflux-mcpЧто делает forkflux-mcp
ForkFlux MCP — это прослойка между MCP-совместимыми ассистентами и вашим экземпляром ForkFlux API. Агент публикует структурированную задачу с контекстом, ограничениями, артефактами, приоритетом и целевой ролью, другой агент атомарно её забирает и получает весь payload. Дальше статус меняется по жизненному циклу: blocked, in_progress, completed, failed, cancelled.
Внутри девять инструментов. forkflux_create_job и forkflux_list_jobs отвечают за публикацию и выборку, forkflux_claim_job и forkflux_claim_next_job — за атомарный захват, forkflux_job_details и forkflux_update_job — за чтение и правку контекста. Отдельно стоят forkflux_reject_job, который создаёт связанную задачу-повтор с причиной отказа, и forkflux_get_reopen_context — он отдаёт только контекст для повтора, не вытягивая исходный объёмный payload.
Сервер намеренно без состояния: он добавляет к запросам префикс /mcp, авторизует их bearer-токеном агента либо общим сервисным ключом, если заголовка нет, и возвращает структурированный результат. Источник правды по агентам, ролям, зависимостям и событиям остаётся за API. Нужен Python 3.12+ и запущенный эндпоинт ForkFlux API. При работе через stdio понадобится ключ API агента.
Какие задачи решает
- передать задачу от одного агента другому без копирования логов
- зафиксировать причину отказа и создать связанный повтор
- выбрать самую приоритетную свободную задачу под конкретную роль
- обновить контекст уже опубликованной задачи
- поднять общий MCP-сервис для нескольких ассистентов
Примеры запросов агенту
- Опубликуй задачу для роли reviewer с контекстом и артефактами из последнего коммита
- Забери следующую приоритетную задачу для моей роли
- Покажи детали задачи и переведи её в статус
in_progress
Как установить forkflux-mcp
Командой платформы
claude mcp add --env FORKFLUX_API_KEY=<FORKFLUX_API_KEY> --env FORKFLUX_API_URL=<FORKFLUX_API_URL> --transport stdio mcp -- uvx forkflux-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from forkflux-mcp <команда>
Командой платформы
codex mcp add mcp --env FORKFLUX_API_KEY=<FORKFLUX_API_KEY> --env FORKFLUX_API_URL=<FORKFLUX_API_URL> -- uvx forkflux-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from forkflux-mcp <команда>
Файл настроек
{
"mcpServers": {
"mcp": {
"command": "uvx",
"args": [
"forkflux-mcp"
],
"env": {
"FORKFLUX_API_KEY": "<FORKFLUX_API_KEY>",
"FORKFLUX_API_URL": "<FORKFLUX_API_URL>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from forkflux-mcp <команда>
Файл настроек
{
"servers": {
"mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"forkflux-mcp"
],
"env": {
"FORKFLUX_API_KEY": "<FORKFLUX_API_KEY>",
"FORKFLUX_API_URL": "<FORKFLUX_API_URL>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from forkflux-mcp <команда>
Командой платформы
gemini mcp add -e FORKFLUX_API_KEY=<FORKFLUX_API_KEY> -e FORKFLUX_API_URL=<FORKFLUX_API_URL> mcp uvx forkflux-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from forkflux-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о forkflux-mcp
Как установить forkflux-mcp в Claude Code?
Добавьте сервер командой claude mcp add forkflux-mcp -e FORKFLUX_API_KEY=<FORKFLUX_API_KEY> -- uvx forkflux-mcp. Второй вариант — claude mcp add --env FORKFLUX_API_KEY=<FORKFLUX_API_KEY> --env FORKFLUX_API_URL=<FORKFLUX_API_URL> --transport stdio mcp -- uvx forkflux-mcp.
Что делает forkflux-mcp?
Даёт ассистенту инструменты для публикации задач, их захвата, смены статуса и отказа с повтором. Всё это проходит через ваш self-hosted ForkFlux API, который хранит агентов, роли и зависимости.
Чем HTTP-режим отличается от stdio?
В stdio каждый клиент запускает свой процесс и передаёт FORKFLUX_API_KEY. В HTTP поднимается один общий сервис на uvicorn forkflux_mcp.main:app, а клиенты шлют собственный токен в заголовке Authorization: Bearer <AGENT_API_TOKEN>.
