npx skillfoxx: как поставить MCP и скиллы одной командой

У каждого агента свой конфиг. Claude Code читает MCP-серверы проекта из .mcp.json, Cursor из .cursor/mcp.json, Codex из .codex/config.toml, и скиллы тоже лежат в разных папках. Раньше карточка давала команду под каждый агент, а JSON приходилось переносить руками. Установщик skillfoxx читает подписанный рецепт записи и правит конфиг сам, по одному ключу. Полный справочник команд и форматов собран на странице для разработчиков.

Как поставить запись

Адрес записи берется из адреса карточки. Для skillfoxx.ru/mcp/playwright-mcp это mcp/playwright-mcp, для скилла ru-text это skills/ru-text. Найти запись можно прямо из терминала.

npx skillfoxx search postgres

Команда выведет адреса и описания, первым в выдаче стоит Postgres MCP Pro. Дальше посмотрите план установки. С флагом --dry-run CLI ничего не пишет на диск.

npx skillfoxx add mcp/playwright-mcp --agent claude-code --dry-run

Если план устраивает, запустите ту же команду без --dry-run. CLI спросит подтверждение и допишет сервер в конфиг. Чтобы поставить запись сразу в несколько агентов, перечислите их через запятую, например --agent claude-code,cursor. После этого перезапустите агента или обновите список MCP-серверов в его настройках.

По умолчанию запись ставится в проект, если в папке или выше есть .git, package.json или skillfoxx-lock.json. Флаг --global ставит ее для пользователя. Без --agent CLI берет агента, внутри которого запущен, а в обычном терминале предлагает выбрать из найденных на машине. --agent all ставит во все найденные агенты. Флаг --json отдает результат для скриптов, --lang en переключает вывод на английский.

Что CLI показывает до установки

Для Playwright MCP команда из прошлого раздела выводит две строки. Мы запускали ее 30 сентября 2026 года на CLI версии 0.3.0.

Средний риск: Агент открывает произвольные сайты и может отправлять формы; Постоянный профиль хранит куки и сессии

План установки mcp/playwright-mcp (в проект): Claude Code: .mcp.json, ключ mcpServers > playwright-mcp

Причины риска те же, что на карточке Playwright MCP. В .mcp.json появится один ключ playwright-mcp, остальные серверы, отступы и комментарии в файле останутся на месте.

У Blender MCP риск высокий. Сервер выполняет произвольный Python-код в Blender, а по умолчанию он отправляет анонимную статистику: идентификатор установки, имя инструмента, версии и ОС. Отключает ее переменная DISABLE_TELEMETRY=true. Такую запись CLI поставит только после ответа «да» в терминале или с флагом --yes. Если в системе нет uvx, CLI заранее предупредит, что без него сервер не запустится.

Скиллы ставятся той же командой. npx skillfoxx add skills/ru-text положит скилл ru-text в .agents/skills/ru-text и подключит его к папке каждого выбранного агента символической ссылкой. Если рецепт собрала модель ИИ по README и человек его еще не проверял, CLI начнет вывод со строки «Рецепт собран автоматически и вручную еще не проверен».

Что проверяется при установке

• Подпись рецепта. SkillFoxx подписывает рецепты ключом Ed25519, открытые ключи вшиты в CLI и опубликованы на странице для разработчиков. Рецепт без подписи, с чужим ключом или выданный больше 24 часов назад CLI отвергает.
• Файлы скилла. CLI скачивает их с GitHub на коммите из рецепта и сверяет sha каждого файла. Новую версию из репозитория подтянет update, когда каталог проверит ее изменения.
• Статус записи. Снятые с публикации записи и записи с открытым инцидентом не ставятся.
• Секреты. Для Figma MCP в .mcp.json проекта попадет ссылка на переменную FIGMA_API_KEY, а сам токен останется в вашем окружении.
• Чужие настройки. Ключ, поставленный не через SkillFoxx или измененный руками, CLI заменит только с флагом --force, а старую версию сохранит в ~/.skillfoxx/backups.

Все установленное CLI записывает в skillfoxx-lock.json в корне проекта. Этот файл стоит закоммитить, чтобы у всей команды был одинаковый набор.

Как проверить, что все встало

npx skillfoxx list показывает, что стоит в проекте и у пользователя. npx skillfoxx doctor ищет проблемы: файл изменили руками или он пропал, вышло сверенное обновление, запись сняли с каталога или ее риск вырос до высокого. Команда update обновляет записи до версии, которую сверил SkillFoxx, а remove mcp/playwright-mcp удаляет только то, что поставил сам CLI.

Если установка не прошла, код выхода подскажет причину. Код 3 означает, что запись снята или заблокирована. С кодом 4 CLI завершается, когда автоматической установки для записи нет, с кодом 5 — когда нужно согласие на высокий риск. Ошибка или Ctrl+C посреди установки откатывают все изменения.

Права и безопасность

Уровень риска описывает, что получит агент после установки. Postgres MCP Pro из поиска выше помечен высоким риском, потому что сервер умеет менять данные и схему. Наш рецепт ставит его в режиме --access-mode=restricted, и сервер выполняет только читающие транзакции. Режим unrestricted включайте вручную и только для копии базы. Начинать лучше с одного сервера, копии базы и отдельного токена с правами на чтение.

Секреты для записи в проект CLI не сохраняет в файл. Если ставить для пользователя через --global, значение секрета попадет в конфиг агента с правами 600, как это делают сами агенты.

Какие агенты поддерживаются

CLI 0.3.0 ставит записи в 15 агентов. Это Claude Code, Cursor, VS Code, Codex, Gemini CLI, Devin, Cline, Zoo Code, OpenCode, Zed, Goose, Amp, Hermes Agent, SourceCraft и Coddy. Для каждого он знает путь к конфигу и формат ключа в нем. Если агент не принимает MCP-сервер в проекте, как Goose или Hermes Agent, CLI напечатает инструкцию вместо правки файла.

MCP-сервер каталога для установки из агента

Если не хочется выходить из агента, подключите MCP-сервер SkillFoxx. В Claude Code он подключается одной командой.

claude mcp add --transport http skillfoxx https://skillfoxx.ru/api/mcp

Готовый JSON для Cursor, VS Code и Codex лежит на странице для разработчиков. Сервер работает без ключа, принимает 120 запросов в минуту с одного IP-адреса и пишет в базу каталога только анонимное событие установки. У него шесть инструментов.

• search_entries ищет записи по запросу;
• get_entry отдает карточку с риском, способами установки и статусом рецепта;
• plan_install возвращает шаги установки под одного агента, вместо секретов в ответе плейсхолдеры (Goose, Amp и Hermes Agent пока есть только в CLI);
• recommend_for_project подбирает до 12 записей по выжимке о проекте;
• report_install засчитывает установку в счетчик на карточке;
• list_categories отдает рубрики с числом записей.

После подключения агенту можно написать «найди в SkillFoxx MCP для Postgres и подключи к этому проекту». Он найдет запись, получит шаги через plan_install и выполнит их с вашими подтверждениями. Для recommend_for_project отправляйте цель, фреймворки и названия зависимостей, без кода и секретов: сервер передает этот текст в OpenAI для подбора по смыслу и не сохраняет его.

REST API и выгрузка catalog.json

REST API на https://skillfoxx.ru/api/v1 работает без ключа. Лимиты считаются по IP-адресу за минуту: 60 запросов для списка записей и рецептов, 120 для поиска, 20 для подбора.

• GET /api/v1/entries?lang=ru&section=skills&page=1 отдает записи раздела по 50 на страницу.
• GET /api/v1/search?q=postgres&lang=ru ищет по каталогу.
• POST /api/v1/scan подбирает записи по описанию проекта, как подбор на сайте.
• POST /api/v1/validate проверяет SKILL.md, plugin.json и server.json, как проверка формата.
• GET /api/v1/recipe/mcp/playwright-mcp отдает подписанный рецепт записи.

Весь каталог одним файлом лежит в catalog.json, английская версия в /catalog.en.json. В каждой записи есть адрес карточки, первоисточник, риск с причинами, признак официального вендора и рецепт со статусом. Сервер пересобирает файл раз в час. Наши метаданные и тексты открыты по лицензии CC BY 4.0 со ссылкой на SkillFoxx, код записей принадлежит авторам и в выгрузку не входит.

Телеметрия

После add, update и remove CLI отправляет анонимное событие: запись, агент, тип события, версию CLI, признак CI и случайный идентификатор установки. Пути, переменные окружения и имя пользователя не уходят. Из событий add складывается счетчик на карточке: разные устройства за 30 дней, без запусков в CI, число появляется от 10. Отправку отключает любая из переменных DO_NOT_TRACK=1, DISABLE_TELEMETRY=1 или SKILLFOXX_TELEMETRY=0.

Чего пока нет

На 30 сентября 2026 года автоматическая установка работает для 1415 записей из 2467, это 57% каталога. У 358 из них рецепт собрала модель ИИ, и CLI ставит их с предупреждением. Для остальных 1052 записей CLI ответит «Автоматической установки нет», назовет причину и даст ссылку на карточку с ручной инструкцией. Так устроен, например, Telegram MCP Server, который нужно запускать самостоятельно.

Для первой установки подойдет запись с низким риском, например набор скиллов Мэтта Покока. Команда npx skillfoxx add skills/skills-for-real-engineers --dry-run покажет 18 скиллов, которые попадут в .agents/skills, и ничего не запишет. Если установка сломалась или поставила не то, нажмите «Сообщить о проблеме» на карточке записи, и мы исправим рецепт.