1MCP Agent (MCP server) — Сценарии использования, Установка & Живое демо

Зачем использовать

Ключевые функции

Агрегация любого количества stdio / SSE / HTTP MCP-серверов в один
Префиксы имён инструментов предотвращают коллизии между серверами
Горячая перезагрузка конфигурации — без перезапуска клиента при добавлении/удалении
Жизненный цикл на сервер: запуск/остановка/перезапуск отдельных серверов
Health check + авто-рестарт для нестабильных серверов

Живое демо

Как выглядит на практике

onemcp-agent.replay ▶ готово

0/0

Установка

Выберите клиент

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "onemcp-agent": {
      "command": "npx",
      "args": [
        "-y",
        "@1mcp/agent"
      ]
    }
  }
}

Откройте Claude Desktop → Settings → Developer → Edit Config. Перезапустите после сохранения.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "onemcp-agent": {
      "command": "npx",
      "args": [
        "-y",
        "@1mcp/agent"
      ]
    }
  }
}

Cursor использует ту же схему mcpServers, что и Claude Desktop. Конфиг проекта приоритетнее глобального.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "onemcp-agent": {
      "command": "npx",
      "args": [
        "-y",
        "@1mcp/agent"
      ]
    }
  }
}

Щёлкните значок MCP Servers на боковой панели Cline, затем "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "onemcp-agent": {
      "command": "npx",
      "args": [
        "-y",
        "@1mcp/agent"
      ]
    }
  }
}

Тот же формат, что и Claude Desktop. Перезапустите Windsurf для применения.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "onemcp-agent",
      "command": "npx",
      "args": [
        "-y",
        "@1mcp/agent"
      ]
    }
  ]
}

Continue использует массив объектов серверов, а не map.

~/.config/zed/settings.json

{
  "context_servers": {
    "onemcp-agent": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@1mcp/agent"
        ]
      }
    }
  }
}

Добавьте в context_servers. Zed перезагружается автоматически.

claude mcp add onemcp-agent -- npx -y @1mcp/agent

Однострочная команда. Проверить: claude mcp list. Удалить: claude mcp remove.

Сценарии использования

Реальные сценарии: 1MCP Agent

Объединение 20+ MCP-серверов за одним эндпоинтом

👤 Опытные пользователи с большим количеством MCP ⏱ ~25 min intermediate

Когда использовать: Ваш claude_desktop_config.json содержит 20+ записей, и добавление/удаление серверов болезненно.

Предварительные требования

Установленный 1mcp — npx -y @1mcp/agent (или постоянная установка по документации)

Поток

Перенести существующие серверы в конфигурацию 1mcp

Use onemcp-agent. Convert my current MCP client config into a 1mcp config file with each server prefixed by its name.✓ Скопировано

→ 1mcp.config.json со всеми серверами и префиксами
Направить клиент на 1mcp

Replace my client's MCP config with a single entry pointing at 1mcp; keep a backup.✓ Скопировано

→ Клиент видит один сервер; инструменты перечислены с префиксами
Горячее добавление нового сервера

Add the new arxiv MCP to 1mcp config and reload — without restarting Claude Desktop.✓ Скопировано

→ Новые инструменты появляются в следующем обновлении list_tools

Итог: Единый источник истины для всех MCP-серверов; быстрее итерировать.

Подводные камни

Имена инструментов становятся длинными с префиксом — Используйте короткие псевдонимы для каждого сервера (gh, fs, pg) вместо полных имён

Запуск общего MCP-стека команды на dev-сервере

👤 Небольшие dev-команды с общей инфраструктурой ⏱ ~45 min advanced

Когда использовать: Вы хотите, чтобы все в команде использовали одни и те же проверенные MCP-серверы и секреты, не дублируя конфигурации.

Предварительные требования

Доступный хост — Запустите 1mcp на dev-сервере с SSE/HTTP транспортом и авторизацией

Поток

Централизовать конфигурацию

Configure 1mcp on the dev box with our team's MCP set + shared auth tokens. Expose via authenticated SSE.✓ Скопировано

→ Стек запущен; SSE-эндпоинт требует bearer-токен
Распространить единую клиентскую конфигурацию

Generate per-developer client snippets pointing to the shared SSE URL with their personal bearer.✓ Скопировано

→ По одному фрагменту на разработчика

Итог: Команда получает проверенный MCP-флот без необходимости каждому управлять 20 конфигурациями.

Подводные камни

Один хост = единая точка отказа — Задокументируйте fallback на локальную конфигурацию; или запускайте реплики за балансировщиком нагрузки

Изоляция недоверенного MCP через 1mcp

👤 Пользователи с осознанной безопасностью, тестирующие community MCP ⏱ ~30 min advanced

Когда использовать: Хотите попробовать сторонний MCP, не давая ему доступ к вашему окружению или файловой системе.

Поток

Запустить 1mcp в контейнере

Set up 1mcp in a Docker container with minimal env; mount only ./scratch/. Add the untrusted MCP under a 'sandbox' prefix.✓ Скопировано

→ Контейнер запущен; видны только инструменты sandbox/
Использовать для одной задачи

Run the experimental task only with sandbox__ tools.✓ Скопировано

→ Задача выполнена; ничего не вышло за пределы контейнера

Итог: Тестирование недоверенных серверов без доступа к важным ресурсам.

Подводные камни

Забыли, что MCP всё равно может обращаться в сеть изнутри контейнера — Используйте --network none или ограниченное сетевое пространство имён, если важен исходящий трафик

Комбинации

Сочетайте с другими MCP — эффект x10

onemcp-agent + filesystem + github

Агрегатор для вашего ежедневного набора серверов

Configure 1mcp with filesystem (prefix fs) + github (prefix gh) + postgres (prefix pg). Use fs__read_file and gh__create_issue from one client.✓ Скопировано

Инструменты

Что предоставляет этот MCP

Инструмент	Входные данные	Когда вызывать	Стоимость
list_servers	—	Health check / отладка	0
reload_config	config_path?	После редактирования 1mcp.config.json	0
restart_server	server_name	Когда дочерний сервер ведёт себя некорректно	0
<prefix>__<tool>	as per child tool	Все инструменты дочерних серверов доступны с их префиксом	зависит от дочернего сервера

Стоимость и лимиты

Во что обходится

Квота API: Добавляет незначительный overhead на каждый вызов
Токенов на вызов: 0 — прокси прозрачен; стоимость списка инструментов равна сумме дочерних
Деньги: Бесплатно
Совет: Отключайте редко используемые дочерние серверы флагом в конфигурации вместо удаления — сохраняет prompt компактным

Безопасность

Права, секреты, радиус поражения

Минимальные скоупы: Всё, что нужно дочерним серверам

Хранение учётных данных: Переменные окружения дочерних серверов централизованы в 1mcp.config.json — защищайте этот файл

Исходящий трафик: То, что делают дочерние серверы — 1mcp сам по себе не выходит в сеть, если не настроен на remote SSE

Никогда не давайте: Публично читаемый файл конфигурации с секретами

При размещении 1mcp удалённо включите bearer-авторизацию — любой, достигший SSE-порта, может использовать все дочерние инструменты

Устранение неполадок

Частые ошибки и исправления

Дочерний сервер не запускается

Проверьте логи 1mcp для stderr этого сервера; обычно отсутствует переменная окружения или неверный путь к команде

Проверить: Запустите команду дочернего сервера отдельно в терминале

Коллизия имён инструментов

Добавьте или сократите префиксы на сервер в конфигурации

Проверить: list_servers показывает текущие префиксы

Горячая перезагрузка не применяет изменения

Некоторые изменения требуют перезапуска (режим транспорта, порт). Запустите restart_server для затронутого дочернего сервера или полный рестарт 1mcp

Медленный первый ответ

Дочерние серверы по умолчанию запускаются лениво — установите 'eager: true' для горячих серверов

Альтернативы

1MCP Agent в сравнении

Альтернатива	Когда использовать	Компромисс
metamcp	Нужен агрегатор с UI-управлением и командными рабочими процессами	Тяжелее; более самоуверенный
mcp-router (TheLunarCompany/lunar)	Нужно управление и аудит-логи (enterprise)	Большая поверхность; больше настройки

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills