sub-agents-mcp — MCP-сервер для Claude Code: субагенты
Запускает ваших субагентов с описанием в Markdown через выбранный кодинг-CLI и возвращает ответ в ту же беседу. Пригодится, когда ревью, тесты и разбор багов хочется поручить отдельным агентам.
claude mcp add --env AGENTS_DIR=<AGENTS_DIR> --env AGENT_TYPE=<AGENT_TYPE> --env AGENT_PERMISSION=<AGENT_PERMISSION> --env AGENT_MODEL=<AGENT_MODEL> --env AGENT_EFFORT=<AGENT_EFFORT> --transport stdio sub-agents-mcp -- npx -y sub-agents-mcpЧто делает sub-agents-mcp
Агент — это файл Markdown в папке, путь к которой вы задаёте в AGENTS_DIR. Имя файла становится именем агента: code-reviewer.md превращается в code-reviewer. Внутри описываете задачу и критерии готовности. Дальше просите ассистента вызвать агента, сервер запускает его через бэкенд из AGENT_TYPE и отдаёт результат обратно в разговор.
Бэкенд выбирается переменной AGENT_TYPE: codex, claude, cursor, command-code, glm, kimi, grok, antigravity, gemini, opencode, mcode, pi. Этим же полем задаётся CLI, который должен быть установлен и авторизован до старта сервера. Для GLM и Kimi понадобится CLI_API_KEY в окружении; у остальных берётся их собственная авторизация. Ещё есть AGENT_PERMISSION: read-only, safe-edit (по умолчанию) или yolo. Насколько строго уровень соблюдается, зависит от бэкенда, так что как граница безопасности он не годится.
Нужен Node.js 22 или новее и MCP-клиент. Если агент жалуется, что действие заблокировано, ослабьте режим. AGENT_MODEL задаёт одну модель сразу для всех агентов. Флаг SESSION_ENABLED включает память между вызовами, и тогда ассистент должен передавать полученный session_id в следующий запрос. Агенты общие для всех клиентов, а настройки бэкенда и модели лежат в одном месте.
Какие задачи решает
- вынести ревью изменений в отдельного агента с чёткими критериями
- дописать тесты на модуль силами выделенного субагента
- найти причину падающих запросов в оплате
- описать изменения публичного API в документации
- переиспользовать одни и те же агенты в нескольких редакторах
Примеры запросов агенту
- Вызови агента
code-reviewerи проверь изменения в аутентификации - Попроси агента
test-writerдобавить тесты на модуль авторизации - Запусти агента
bug-investigatorи разберись, почему падают запросы на оформление заказа
Как установить sub-agents-mcp
Командой платформы
claude mcp add --env AGENTS_DIR=<AGENTS_DIR> --env AGENT_TYPE=<AGENT_TYPE> --env AGENT_PERMISSION=<AGENT_PERMISSION> --env AGENT_MODEL=<AGENT_MODEL> --env AGENT_EFFORT=<AGENT_EFFORT> --transport stdio sub-agents-mcp -- npx -y sub-agents-mcpВместо <…> подставьте свои значения. Ещё 7 переменных окружения — в README сервера
Командой платформы
codex mcp add sub-agents-mcp --env AGENTS_DIR=<AGENTS_DIR> --env AGENT_TYPE=<AGENT_TYPE> --env AGENT_PERMISSION=<AGENT_PERMISSION> --env AGENT_MODEL=<AGENT_MODEL> --env AGENT_EFFORT=<AGENT_EFFORT> -- npx -y sub-agents-mcpВместо <…> подставьте свои значения. Ещё 7 переменных окружения — в README сервера
Файл настроек
{
"mcpServers": {
"sub-agents-mcp": {
"command": "npx",
"args": [
"-y",
"sub-agents-mcp"
],
"env": {
"AGENTS_DIR": "<AGENTS_DIR>",
"AGENT_TYPE": "<AGENT_TYPE>",
"AGENT_PERMISSION": "<AGENT_PERMISSION>",
"AGENT_MODEL": "<AGENT_MODEL>",
"AGENT_EFFORT": "<AGENT_EFFORT>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 7 переменных окружения — в README сервера
Файл настроек
{
"servers": {
"sub-agents-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"sub-agents-mcp"
],
"env": {
"AGENTS_DIR": "<AGENTS_DIR>",
"AGENT_TYPE": "<AGENT_TYPE>",
"AGENT_PERMISSION": "<AGENT_PERMISSION>",
"AGENT_MODEL": "<AGENT_MODEL>",
"AGENT_EFFORT": "<AGENT_EFFORT>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 7 переменных окружения — в README сервера
Командой платформы
gemini mcp add -e AGENTS_DIR=<AGENTS_DIR> -e AGENT_TYPE=<AGENT_TYPE> -e AGENT_PERMISSION=<AGENT_PERMISSION> -e AGENT_MODEL=<AGENT_MODEL> -e AGENT_EFFORT=<AGENT_EFFORT> sub-agents-mcp npx -y sub-agents-mcpВместо <…> подставьте свои значения. Ещё 7 переменных окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о sub-agents-mcp
Как установить sub-agents-mcp в Claude Code?
Выполните `claude mcp add sub-agents-mcp -e AGENTS_DIR=<AGENTS_DIR> -e AGENT_TYPE=<AGENT_TYPE> -e CURSOR_API_KEY=<CURSOR_API_KEY> -e CLI_API_KEY=<CLI_API_KEY> -- npx -y sub-agents-mcp, подставив свои значения. Либо второй вариант с полным набором настроек: claude mcp add --env AGENTS_DIR=<AGENTS_DIR> --env AGENT_TYPE=<AGENT_TYPE> --env AGENT_PERMISSION=<AGENT_PERMISSION> --env AGENT_MODEL=<AGENT_MODEL> --env AGENT_EFFORT=<AGENT_EFFORT> --transport stdio sub-agents-mcp -- npx -y sub-agents-mcp`. После сохранения перезапустите или переподключите клиент.
Что делает sub-agents-mcp?
Позволяет вызывать субагентов, описанных в файлах Markdown, из любого MCP-совместимого клиента. Сервер прогоняет агента через выбранный кодинг-CLI и возвращает ответ в текущий диалог.
Что нужно, чтобы сервер запустился?
Node.js 22 или новее, сам MCP-клиент и установленный с авторизацией бэкенд-CLI. В AGENTS_DIR должен лежать абсолютный путь к папке хотя бы с одним файлом .md или .txt.
