workflows-mcp-server — MCP-сервер для Claude Code: обзор и установка
Хранит, ищет и создаёт сценарии работы для LLM-агентов в формате YAML. Пригодится, когда нужно зафиксировать повторяющиеся цепочки вызовов инструментов.
claude mcp add --env WORKFLOWS_DIR=<WORKFLOWS_DIR> --env GLOBAL_INSTRUCTIONS_PATH=<GLOBAL_INSTRUCTIONS_PATH> --env WATCHER_DEBOUNCE_MS=<WATCHER_DEBOUNCE_MS> --env MCP_LOG_LEVEL=<MCP_LOG_LEVEL> --env MCP_TRANSPORT_TYPE=<MCP_TRANSPORT_TYPE> --transport stdio workflows-mcp-server -- npx -y @cyanheads/workflows-mcp-serverЧто делает workflows-mcp-server
Сервер превращает набор локальных YAML-файлов в структурированную библиотеку действий для ИИ-ассистента. В распоряжении агента пять инструментов: workflow_list, workflow_get, workflow_create, workflow_create_temp и workflow_delete. Постоянные сценарии раскладываются по категориям, а черновые попадают в отдельную папку temp/ и не показываются в общих списках.
Файлы отслеживает фоновый наблюдатель, поэтому поисковый индекс в памяти обновляется сразу после правок на диске. Идентификаторы строятся по правилу имя@версия с обязательной нормализацией по semver. Шаблоны параметров вроде {{input.foo}} сервер оставляет как есть, возлагая их подстановку на самого агента.
Без поддержки интерактивного подтверждения со стороны клиента удалить сценарий не выйдет. Инструмент workflow_delete требует обязательного ответа пользователя перед стиранием данных, защищая библиотеку от случайных потерь.
Какие задачи решает
- сохранять повторяющиеся цепочки вызова инструментов в структурированные YAML-файлы
- находить готовые сценарии по тегам, категориям и ключевым словам
- создавать временные черновики сценариев без добавления в общий каталог
- получать шаги playbook вместе с общими инструкциями из
global_instructions.md
Примеры запросов агенту
- Найди в библиотеке сценарии с тегом devops через
workflow_list. - Загрузи последнюю версию регламента деплоя с помощью
workflow_get. - Сохрани текущую цепочку шагов как черновик через
workflow_create_temp.
Как установить workflows-mcp-server
Командой платформы
claude mcp add --env WORKFLOWS_DIR=<WORKFLOWS_DIR> --env GLOBAL_INSTRUCTIONS_PATH=<GLOBAL_INSTRUCTIONS_PATH> --env WATCHER_DEBOUNCE_MS=<WATCHER_DEBOUNCE_MS> --env MCP_LOG_LEVEL=<MCP_LOG_LEVEL> --env MCP_TRANSPORT_TYPE=<MCP_TRANSPORT_TYPE> --transport stdio workflows-mcp-server -- npx -y @cyanheads/workflows-mcp-serverВместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера
Командой платформы
codex mcp add workflows-mcp-server --env WORKFLOWS_DIR=<WORKFLOWS_DIR> --env GLOBAL_INSTRUCTIONS_PATH=<GLOBAL_INSTRUCTIONS_PATH> --env WATCHER_DEBOUNCE_MS=<WATCHER_DEBOUNCE_MS> --env MCP_LOG_LEVEL=<MCP_LOG_LEVEL> --env MCP_TRANSPORT_TYPE=<MCP_TRANSPORT_TYPE> -- npx -y @cyanheads/workflows-mcp-serverВместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера
Файл настроек
{
"mcpServers": {
"workflows-mcp-server": {
"command": "npx",
"args": [
"-y",
"@cyanheads/workflows-mcp-server"
],
"env": {
"WORKFLOWS_DIR": "<WORKFLOWS_DIR>",
"GLOBAL_INSTRUCTIONS_PATH": "<GLOBAL_INSTRUCTIONS_PATH>",
"WATCHER_DEBOUNCE_MS": "<WATCHER_DEBOUNCE_MS>",
"MCP_LOG_LEVEL": "<MCP_LOG_LEVEL>",
"MCP_TRANSPORT_TYPE": "<MCP_TRANSPORT_TYPE>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера
Файл настроек
{
"servers": {
"workflows-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@cyanheads/workflows-mcp-server"
],
"env": {
"WORKFLOWS_DIR": "<WORKFLOWS_DIR>",
"GLOBAL_INSTRUCTIONS_PATH": "<GLOBAL_INSTRUCTIONS_PATH>",
"WATCHER_DEBOUNCE_MS": "<WATCHER_DEBOUNCE_MS>",
"MCP_LOG_LEVEL": "<MCP_LOG_LEVEL>",
"MCP_TRANSPORT_TYPE": "<MCP_TRANSPORT_TYPE>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера
Командой платформы
gemini mcp add -e WORKFLOWS_DIR=<WORKFLOWS_DIR> -e GLOBAL_INSTRUCTIONS_PATH=<GLOBAL_INSTRUCTIONS_PATH> -e WATCHER_DEBOUNCE_MS=<WATCHER_DEBOUNCE_MS> -e MCP_LOG_LEVEL=<MCP_LOG_LEVEL> -e MCP_TRANSPORT_TYPE=<MCP_TRANSPORT_TYPE> workflows-mcp-server npx -y @cyanheads/workflows-mcp-serverВместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о workflows-mcp-server
Как установить workflows-mcp-server в Claude Code?
Выполните команду claude mcp add workflows-mcp-server -- npx -y @cyanheads/workflows-mcp-server в терминале.
Что делает workflows-mcp-server?
Предоставляет агенту доступ к базе YAML-сценариев, позволяя искать, читать, сохранять и удалять регламенты многоэтапных операций.
Подставляет ли сервер значения в переменные шаблона?
Нет, шаблоны вида {{input.foo}} возвращаются в исходном виде, поэтому обработку параметров агент выполняет на своей стороне.
