floom — MCP-сервер для Claude Code: запуск AI-воркеров
MCP-сервер floom даёт агенту доступ к рантайму фоновых AI-воркеров: деплой, запуск, расписания и история прогонов.
claude mcp add floom -e FLOOM_BASE_URL=<FLOOM_BASE_URL> -e FLOOM_API_KEY=<FLOOM_API_KEY> -- npx -y @floomhq/mcp-serverЧто делает floom
Floom — рантайм для фоновых AI-воркеров. Воркер это папка с worker.yml и одним из двух: run.py со скриптом или SKILL.md с описанием задачи обычным текстом. В worker.yml объявляются входы, выходы, триггер, секреты и список инструментов, которые агенту разрешено вызывать. Скриптовые воркеры выполняются в песочнице E2B с изолированной файловой системой, переменными окружения и процессами; секреты платформы в песочницу не попадают.
Запускать воркер можно вручную, по cron-расписанию, из вебхука или по событию Composio. Каждый прогон оставляет логи, выходные файлы, вызовы инструментов и состояние согласований, а открыть, воспроизвести или откатить прогон можно из UI. MCP-сервер подключает всё это к агенту: он видит воркеры и умеет их запускать. Сам Floom разворачивается у себя, а платите вы за секунды песочницы E2B и за обращения к своему провайдеру модели — отдельной платы за задачу нет.
Для подключения нужны FLOOM_BASE_URL и FLOOM_API_KEY. Без них сервер запустится, но ни один вызов не пройдёт: сначала поднимите сам Floom и получите ключ. Агентский режим на SKILL.md выполняется в процессе API и изоляцией микроВМ не защищён — это повод держать такие воркеры только на доверенных сборках.
Какие задачи решает
- запускать Python-скрипт по расписанию без ручного старта
- отдавать результат воркера в UI, REST и агенту одновременно
- ограничить агенту список доступных инструментов
- хранить логи и выходные файлы каждого прогона
- откатить неудачный прогон и перезапустить его
Примеры запросов агенту
- Покажи список воркеров floom и запусти
github-digest - Задеплой воркер из папки
workers/my-worker - Открой последний прогон
github-digestи покажи логи
Как установить floom
Командой платформы
claude mcp add floom -e FLOOM_BASE_URL=<FLOOM_BASE_URL> -e FLOOM_API_KEY=<FLOOM_API_KEY> -- npx -y @floomhq/mcp-serverВместо <…> подставьте свои значения
Командой платформы
codex mcp add floom --env FLOOM_BASE_URL=<FLOOM_BASE_URL> --env FLOOM_API_KEY=<FLOOM_API_KEY> -- npx -y @floomhq/mcp-serverВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"floom": {
"command": "npx",
"args": [
"-y",
"@floomhq/mcp-server"
],
"env": {
"FLOOM_BASE_URL": "<FLOOM_BASE_URL>",
"FLOOM_API_KEY": "<FLOOM_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"floom": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@floomhq/mcp-server"
],
"env": {
"FLOOM_BASE_URL": "<FLOOM_BASE_URL>",
"FLOOM_API_KEY": "<FLOOM_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e FLOOM_BASE_URL=<FLOOM_BASE_URL> -e FLOOM_API_KEY=<FLOOM_API_KEY> floom npx -y @floomhq/mcp-serverВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о floom
Как установить floom в Claude Code?
Выполните claude mcp add floom -e FLOOM_BASE_URL=<FLOOM_BASE_URL> -e FLOOM_API_KEY=<FLOOM_API_KEY> -- npx -y @floomhq/mcp-server. Подставьте адрес своего инстанса Floom и ключ API.
Что делает floom?
Это MCP-сервер к рантайму фоновых AI-воркеров. Через него агент деплоит воркеры из папки, запускает их вручную или по расписанию и читает историю прогонов.
Чем скриптовый воркер отличается от агентского?
Скрипт (run.py, .sh, .js, .ts) идёт в микроВМ E2B с изолированной файловой системой и процессами. Агент на SKILL.md работает в процессе API и такой изоляции не получает.
