Мастеринг как инструмент вашего ИИ-агента
Magic Master говорит на Model Context Protocol. Подключите сервер один раз — и агент в Claude, ChatGPT, Cursor или собственный на SDK сам измерит трек, снимет ИИ-след Suno/Udio и сведёт мастер под нужную площадку.
Подключение
Удалённый сервер, ставить нечего. Адрес один:
https://magicmaster.pro/mcpВ один клик:
Добавить в Cursor Установить в VS Code Рецепты на GitHub
В claude.ai / Claude Desktop: Настройки → Коннекторы → «Добавить пользовательский коннектор» → адрес https://magicmaster.pro/mcp/oauth (вход через OAuth — так работают и платные инструменты). В ChatGPT: режим разработчика → Коннекторы → создать с тем же адресом.
В Claude Code — одной строкой:
claude mcp add --transport http magicmaster https://magicmaster.pro/mcp/oauthКлиент умеет только stdio? Мост npx -y mcp-remote https://magicmaster.pro/mcp/oauth (или пакет npx -y magicmaster-mcp).
Ключ аккаунта передаётся заголовком X-API-Key. Authorization: Bearer здесь принимается ТОЛЬКО от OAuth (токен выписан на /mcp) — JWT кабинета в этом заголовке даёт 401 и ломает даже бесплатные вызовы. Без ключа бесплатные инструменты работают.
Примеры запросов
Подключили — напишите агенту обычными словами. Инструменты он выберет сам.
- «Проверь эту запись: она уже пережата? — https://example.com/track.wav» analyze_track
- «Сними след Suno с этого трека и сведи под Spotify» clean_ai_trace → master_track → get_job
- «Сколько стоит мастеринг и сколько бесплатных прогонов у меня осталось?» get_pricing, check_limits
- «Сведи под подкаст на −16 LUFS и покажи паспорт мастеринга» master_track → get_job (виджет)
Инструменты
| Инструмент | Что делает | Стоимость |
|---|---|---|
analyze_track | LUFS, пиковый уровень, длительность, корреляция, подсказка жанра | бесплатно |
clean_ai_trace | Снимает цифровой след Suno/Udio, не трогая громкость | бесплатно |
preview_styles | 24 секунды трека в нескольких пресетах сразу: громкость каждого и ссылка послушать (6 раз в сутки) | бесплатно |
master_track | Мастеринг: 24 пресета, цель по LUFS, экспорт в 6 форматов | 1 токен |
batch_master | Альбом целиком: общие настройки, относительная громкость треков сохраняется | токен за трек |
get_job | Статус и метрики результата — с паспортом мастеринга прямо в чате | бесплатно |
check_limits | Баланс, остаток бесплатной квоты и время сброса | бесплатно |
list_presets, get_pricing | Пресеты с целевой громкостью и живой прайс | бесплатно |
create_topup_link | Готовит счёт для человека — платёж агент завершить не может | бесплатно |
С чего начать агенту
3 пробных мастеринга
Зарегистрируйте агента один раз — получите ключ и три полных PRO-мастеринга. Без карты. JWT для этого запроса — токен вашего аккаунта: зарегистрируйтесь на сайте и возьмите его в профиле. Через коннектор (OAuth) пробные не выдаются: их даёт только этот вызов.
Правила в одном файле
agents.md описывает, что бесплатно, что стоит токен, как выбирать пресет и что делать с ошибками.
Машинный манифест
agent.json собирается из живых цен, лимитов и пресетов — цифры в нём не устаревают.
curl -X POST https://magicmaster.pro/api/agents/register \
-H "Authorization: Bearer <JWT>" -H "Content-Type: application/json" \
-d '{"name":"my-agent","purpose":"mastering for my users"}'Если клиент не умеет свои заголовки
Claude Desktop не отправляет произвольные заголовки, поэтому для него есть вторая точка с OAuth 2.1: клиент сам увидит отказ, найдёт метаданные и проведёт вход. Инструменты, лимиты и списания там те же.
https://magicmaster.pro/mcp/oauthРегистрация приложения — /oauth/register, метаданные — /.well-known/oauth-authorization-server, PKCE обязателен (S256), область одна: mastering. Токен выдаётся только для ресурса /mcp и в других наших ручках не принимается.
Протокол
Ревизия 2026-07-28 (stateless), плюс совместимость с 2025-11-25 и 2025-06-18. Поддержаны server/discover, кэшируемые списки, prompts, resources и расширение MCP Apps — паспорт мастеринга рисуется виджетом прямо в переписке.
Машинные описания: /agent.json, /openapi-public.json, правила для агентов: /agents.md.