Agent Swarm — MCP-сервер для Claude Code: оркестрация агентов
MCP-сервер, который подключает вашу кодовую среду к Agent Swarm — системе с ведущим агентом и рабочими в контейнерах. Пригодится, если задачи приходят из Slack, репозиториев или API.
claude mcp add agent-swarm -e AGENT_SWARM_API_KEY=<AGENT_SWARM_API_KEY> -- npx -y @desplega.ai/agent-swarmЧто делает Agent Swarm
Agent Swarm — это открытая self-hosted система для работы с ИИ-агентами. Ведущий агент принимает задачи из Slack, репозиториев, трекеров, почты или через API и раздаёт их рабочим. Рабочие запускаются в изолированных Docker-контейнерах, а память и идентичность сохраняются между сессиями.
MCP-сервер — это точка входа: через него ваша среда (Claude, Codex, Cursor, GitHub Copilot, Windsurf, Cline, Zed) общается с Agent Swarm. Внутри есть задачи с валидируемой схемой результата, отложенные задачи, которые просыпаются по завершении других или по дедлайну, вложения файлов в дашборде, расписания и скрипты для повторяющейся работы. Расширения на TypeScript ставятся как черновики и активируются доверенным ведущим или оператором.
Для работы нужен ключ AGENT_SWARM_API_KEY — без него сервер не подключится. Есть два транспорта: stdio через npx -y @desplega.ai/agent-swarm и HTTP по адресу https://{swarm_host}/mcp-user. Само развёртывание Agent Swarm — отдельная история: есть установщик, который проверяет Docker и Compose v2, ставит Bun при отсутствии и запускает agent-swarm onboard --yes. По умолчанию он берёт пресет solo с одним агентом; для всех официальных шаблонов нужен флаг --preset full.
Какие задачи решает
- подключить кодовую среду к оркестратору агентов по MCP
- раздавать задачи из Slack и репозиториев рабочим агентам
- сохранять память и идентичность агента между сессиями
- ставить отложенные задачи с пробуждением по дедлайну
- запускать повторяющуюся работу по расписанию
Примеры запросов агенту
- Подключи MCP-сервер Agent Swarm к Claude с ключом из переменной окружения
- Покажи список задач Agent Swarm и их статусы
- Создай отложенную задачу, которая проснётся, когда завершатся все наблюдаемые задачи
Как установить Agent Swarm
1Командой платформы
claude mcp add agent-swarm -e AGENT_SWARM_API_KEY=<AGENT_SWARM_API_KEY> -- npx -y @desplega.ai/agent-swarmВместо <…> подставьте свои значения
2Командой платформы: удалённый сервер
claude mcp add --transport http agent-swarm https://{swarm_host}/mcp-user1Командой платформы
codex mcp add agent-swarm --env AGENT_SWARM_API_KEY=<AGENT_SWARM_API_KEY> -- npx -y @desplega.ai/agent-swarmВместо <…> подставьте свои значения
2Командой платформы: удалённый сервер
codex mcp add agent-swarm --url https://{swarm_host}/mcp-user1Файл настроек
{
"mcpServers": {
"agent-swarm": {
"command": "npx",
"args": [
"-y",
"@desplega.ai/agent-swarm"
],
"env": {
"AGENT_SWARM_API_KEY": "<AGENT_SWARM_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
2Файл настроек
{
"mcpServers": {
"agent-swarm": {
"url": "https://{swarm_host}/mcp-user"
}
}
}1Файл настроек
{
"servers": {
"agent-swarm": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@desplega.ai/agent-swarm"
],
"env": {
"AGENT_SWARM_API_KEY": "<AGENT_SWARM_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
2Файл настроек
{
"servers": {
"agent-swarm": {
"type": "http",
"url": "https://{swarm_host}/mcp-user"
}
}
}1Командой платформы
gemini mcp add -e AGENT_SWARM_API_KEY=<AGENT_SWARM_API_KEY> agent-swarm npx -y @desplega.ai/agent-swarmВместо <…> подставьте свои значения
2Командой платформы: удалённый сервер
gemini mcp add -t http agent-swarm https://{swarm_host}/mcp-userПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Agent Swarm
Как установить Agent Swarm в Claude Code?
Добавьте маркетплейс командой /plugin marketplace add desplega-ai/agent-swarm, затем установите плагин: /plugin install agent-swarm@agent-swarm.
Что делает Agent Swarm?
Это self-hosted система для оркестрации ИИ-агентов: ведущий агент принимает задачи и распределяет их между рабочими в Docker-контейнерах, сохраняя память между сессиями.
Что нужно для работы MCP-сервера?
Ключ AGENT_SWARM_API_KEY и запущенный Agent Swarm. Подключение идёт либо через stdio с npx -y @desplega.ai/agent-swarm, либо по HTTP на https://{swarm_host}/mcp-user.
