mcloud-logs — скилл для Claude Code: логи Cloud в терминале
Скилл учит агента читать логи бэкенда и сторфронта через mcloud logs: искать ошибки, фильтровать по времени и деплою.
npx skills add medusajs/medusa-agent-skills --skill mcloud-logs -a claude-codeЧто делает mcloud-logs
Скилл описывает работу с командой mcloud logs — она тянет рантайм-логи окружения Cloud. Агент сам подставит организацию, проект и окружение из активного контекста, если их не указать явно.
Внутри — один файл SKILL.md с разбором опций: --search ищет подстроку, --metadata status=500 отбирает записи по полям, --deployment сужает до конкретной сборки, --type storefront переключает поток. Для разбора агентом есть --json, и результат удобно прогнать через jq. Разрешения ограничены: Bash(mcloud logs*) и Bash(jq*).
Вот на чём легко споткнуться: --follow и --json несовместимы. Потоковый режим висит до Ctrl+C, поэтому в скриптах и пайплайнах он не годится — берите окно по времени через --from и --to. По умолчанию команда отдаёт последние 500 строк за 15 минут, а --limit работает только без --follow. Если --to старше 15 минут назад, --from обязателен.
Какие задачи решает
- найти ошибки в логах бэкенда за нужный интервал
- отфильтровать записи по HTTP-статусу через метаданные
- посмотреть логи конкретного деплоя или сборки
- выгрузить логи сторфронта отдельно от бэкенда
- отдать структурированный JSON агенту на разбор
Примеры запросов агенту
- покажи ошибки в логах бэкенда за последний час
- выгрузи логи деплоя
bld_01ABC123в JSON - посмотри логи сторфронта и найди там 500-е
Как установить mcloud-logs
1Через Skills CLI (Vercel)
npx skills add medusajs/medusa-agent-skills --skill mcloud-logs -a claude-code2Вручную: положить файлы
~/.claude/skills/mcloud-logs/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/mcloud-logs/
1Через Skills CLI (Vercel)
npx skills add medusajs/medusa-agent-skills --skill mcloud-logs -a codex2Вручную: положить файлы
.agents/skills/mcloud-logs/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add medusajs/medusa-agent-skills --skill mcloud-logs -a cursor2Вручную: положить файлы
.cursor/skills/mcloud-logs/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install medusajs/medusa-agent-skills mcloud-logs2Вручную: положить файлы
.github/skills/mcloud-logs/SKILL.md1Через Skills CLI (Vercel)
npx skills add medusajs/medusa-agent-skills --skill mcloud-logs -a gemini-cli2Командой платформы
gemini skills install https://github.com/medusajs/medusa-agent-skills --path plugins/medusa-cloud/skills/mcloud-logsВручную: положить файлы
.devin/skills/mcloud-logs/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add medusajs/medusa-agent-skills --skill mcloud-logs -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о mcloud-logs
Как установить mcloud-logs в Claude?
Выполните npx skills add medusajs/medusa-agent-skills --skill mcloud-logs -a claude-code. Скилл появится в ~/.claude/skills/mcloud-logs/SKILL.md.
Что делает mcloud-logs?
Даёт агенту инструкцию по команде mcloud logs: как запрашивать логи окружения Cloud, фильтровать их по времени, источнику, метаданным и деплою, а также выводить в JSON.
Почему не работает --follow вместе с --json?
Эти два флага несовместимы. Для программного разбора используйте ограниченное окно времени с --from и --to плюс --json.
