SVGator MCP

SVGator MCP Server — Документация

MCP-сервер напрямую подключает вашего AI-ассистента к SVGator — онлайн-инструменту для SVG-анимации. После подключения ассистент может работать внутри ваших проектов, чтобы просматривать, изучать, редактировать, создавать и экспортировать их, выполняя задачи от простого «измени цвета согласно этому бренд-киту» до полноценного «создай анимированное раскрытие логотипа и экспортируй его как файл только на CSS».

• Эндпоинт: https://mcp.svgator.com/mcp
• Протокол: Model Context Protocol через Streamable HTTP
• Аутентификация: OAuth 2.1 (вход с вашей учетной записью SVGator — см. Начало работы)

Возможности

Возможность	Инструменты	Пример запроса
Просмотр проектов	list_projects, get_project, get_profile	"Покажи список моих проектов SVGator"
Изучение структуры проекта	get_skeleton, read_part	"Какие элементы есть в проекте X и какие из них анимированы?"
Пошаговое редактирование проекта	edit_part	"Сделай круг красным и зацикли его подпрыгивание навсегда"
Создание или полная замена проектов	create_project, replace_project	"Создай мне новый анимированный спиннер загрузки"
Дублирование, перемещение и переименование проектов	duplicate_project, move_project	"Скопируй проект X в мою папку 'Черновики'"
Управление переиспользуемыми ресурсами	list_assets, get_asset, create_asset, update_asset	"Сохрани эту иконку как переиспользуемый ресурс"
Организация проектов по папкам	list_folders, get_folder, create_folder, update_folder	"Создай папку 'Маркетинг' и помести в нее этот проект"
Поиск справочной информации по созданию	describe_shape	(используется ассистентом для получения точных JSON-структур)
Экспорт в готовые форматы	export_project, get_render	"Экспортируй проект X как видео MP4"
Получение рекомендаций по моушн-дизайну	ресурсы навыков + промпт	"Срежиссируй раскрытие логотипа, а затем создай его"

Каждый проект, возвращаемый сервером, содержит editor_url — прямую ссылку, открывающую проект в редакторе SVGator, так что вы всегда можете продолжить работу вручную с того места, где остановился ассистент.

Инструменты

Сервер предоставляет 22 инструмента. Полные таблицы параметров и выходных данных см. в Справочнике инструментов.

Проекты

• list_projects — Список проектов SVGator аутентифицированного пользователя (сначала новые), с прямой ссылкой editor_url в каждой строке и общим количеством для пагинации.
• get_project — Получить сводку по одному проекту: название, превью, папка, временные метки, размер холста, цвет фона, временная шкала анимации и сохраненные настройки экспорта.
• create_project — Создать новый проект SVGator из полного JSON проекта, принадлежащий аутентифицированному пользователю.
• replace_project — Заменить весь JSON существующего проекта предоставленным полным проектом (валидация выполняется до внесения изменений).
• duplicate_project — Создать копию существующего проекта, опционально в другой папке или с новым названием.
• move_project — Переместить проект в другую папку и/или переименовать его.

Изучение и редактирование проекта

• get_skeleton — Получить легковесную, экономящую токены карту структуры проекта (дерево элементов только с именами и количеством ключевых кадров, без значений) — шаг 1 цикла редактирования.
• read_part — Прочитать точное значение или элемент по пути, привязанному к id — шаг 2 цикла редактирования.
• edit_part — Применить одно проверенное изменение (обновление, вставка, перемещение или удаление) по указанному пути и сохранить его — шаг 3 цикла редактирования.
• describe_shape — Получить точную JSON-структуру одного строительного блока (элемента или аниматора) перед созданием, чтобы имена полей никогда не угадывались.

Ресурсы

• list_assets — Список переиспользуемых ресурсов аутентифицированного пользователя (статических или анимированных SVG-элементов), сначала новые.
• get_asset — Получить один ресурс, включая его полную полезную нагрузку data ({document, definitions}).
• create_asset — Создать новый переиспользуемый ресурс из документа ресурса.
• update_asset — Заменить весь документ существующего ресурса.

Папки

• list_folders — Список папок аутентифицированного пользователя (метки, под которыми хранятся проекты).
• get_folder — Получить одну папку (id, название, временные метки) по ее id.
• create_folder — Создать новую папку для организации проектов.
• update_folder — Переименовать существующую папку.

Экспорт и аккаунт

• export_project — Экспортировать проект в готовый формат (SVG, Lottie, React Native, Flutter, видео или GIF) с опциональными переопределениями для каждого экспорта.
• get_render — Проверить статус растрового рендеринга (видео/GIF), запущенного export_project, и получить подписанный URL для скачивания по завершении.
• get_profile — Получить профиль аутентифицированного клиента: имя, email, тарифный план и команды.

Карта документации

Документ	Для кого	Содержание
Начало работы	Для всех	Подключение из claude.ai, Claude Desktop, Claude Code и других MCP-клиентов; аутентификация; конфиденциальность
Справочник инструментов	Интеграторы / интересующиеся	Каждый инструмент с полными таблицами параметров и выходных данных
Редактирование проектов	Интеграторы / опытные пользователи	Цикл навигация → чтение → редактирование → проверка, адресация по пути, правила создания
Экспорт проектов	Для всех	Форматы, режимы доставки, опции экспорта, опрос рендеринга
Навыки и ресурсы	Интеграторы	Навык моушн-дизайна, ресурсы MCP и промпт
Устранение неполадок	Для всех	Проблемы с подключением, распространенные ошибки и их значение

Требования

• Учетная запись SVGator (зарегистрироваться). Экспорты учитываются в лимитах вашего тарифного плана точно так же, как в редакторе.
• Для подключения из claude.ai / Claude Desktop пользовательские коннекторы требуют тарифный план Claude Pro, Max, Team или Enterprise. Claude Code и другие MCP-клиенты подключаются напрямую к эндпоинту.

Как это работает (в одном абзаце)

Сервер является удаленным MCP-сервером: ваш MCP-клиент (Claude или любой клиент, поддерживающий Streamable HTTP) подключается к https://mcp.svgator.com/mcp и выполняет ваш вход через стандартный OAuth-логин SVGator. Ваши учетные данные SVGator остаются только на стороне сервера — AI-модель никогда не видит ваш токен доступа или секретный ключ; она получает только результаты инструментов (списки проектов, карты структуры, экспортированные файлы). Входные данные инструментов проверяются по опубликованным схемам, и недействительные запросы возвращают описательные ошибки, которые ассистент может прочитать и исправить.

⚙️ Возможности

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

Он создан для дизайнеров, которые хотят, чтобы ассистент выполнял рутинные задачи по анимации, для маркетинговых команд, которым нужна готовая к вебу анимация без ожидания дизайнера для каждого небольшого изменения, и для разработчиков, которым нужны готовые к продакшену экспорты (Lottie, React Native, Flutter или SVG), которые сразу встраиваются в продукт. Каждый проект возвращается с прямой ссылкой на редактор, так что вы всегда можете открыть его и доработать вручную, экономя токены.

Вот что ваш ассистент может делать после подключения:

🗂️ Проекты и ресурсы

• Список проектов: сначала новые, каждый с прямой ссылкой на редактор
• Поиск и постраничная навигация по большим библиотекам
• Чтение настроек проекта: размер холста, фон, временная шкала и настройки экспорта
• Создание проекта из полного определения
• Перезапись существующего проекта
• Дублирование проекта: в ту же или другую папку
• Перемещение или переименование проекта
• Организация проектов по папкам
• Управление переиспользуемыми ресурсами: список, чтение, создание и обновление

🔍 Структура и инспекция

• Карта структуры проекта: дерево элементов с количеством ключевых кадров, без тяжелых данных
• Просмотр анимированных элементов: какие каналы содержат ключевые кадры на каждом элементе
• Чтение точных значений: любое свойство, ключевой кадр или элемент
• Поиск справочных структур: точный JSON для любого элемента или концепции

🔷 Фигуры и элементы

• Прямоугольники
• Круги и эллипсы
• Линии, ломаные и многоугольники
• Произвольные пути
• Текст и многострочный текст
• Изображения
• Переиспользуемые символы и экземпляры
• Группы
• Маски и обтравочные контуры

🎨 Заливки, обводки и цвет

• Сплошные цветовые заливки: статические или анимированные
• Градиентные заливки
• Обводки: сплошные или градиентные, статические или анимированные
• Композитинг: режимы наложения и непрозрачность
• Эффекты фильтров, такие как размытие

🎞️ Анимация и ключевые кадры

• Добавление ключевых кадров в определенное время со значениями
• Установка статических значений там, где движение не требуется
• Чтение, проверка и удаление ключевых кадров
• Установка сглаживания для каждого ключевого кадра: кубический Безье
• Анимация трансформаций: положение, поворот, масштаб и наклон
• Анимация каналов заливки, обводки, композитинга и фильтров
• Морфинг одной фигуры в другую

📤 Экспорт и доставка

• Экспорт анимированного SVG: на JavaScript или CSS
• Установка триггера запуска: загрузка, наведение, клик, прокрутка или программный
• Установка поведения при клике и наведении: заморозка, перезапуск, реверс или сброс
• Экспорт в Lottie
• Экспорт в исходный код React Native или Flutter
• Рендеринг видео: MP4, MOV, AVI, MKV или WebM
• Рендеринг GIF, WebP, последовательности PNG или ZIP
• Управление зацикливанием: итерации, направление, пинг-понг и скорость
• Установка частоты кадров, разрешения и качества
• Обработка прозрачности и цвета фона

✅ Лучшие практики

Установите навык моушн-дизайна SVGator, затем вызывайте его по имени: Это руководство по мастерству, которое помогает вашему ассистенту делать осознанный выбор в отношении тайминга, сглаживания и характера движения вместо плоской, шаблонной анимации. Скачайте его из репозитория навыков SVGator, затем активируйте прямо в вашем промпте, начав с чего-то вроде "используй навыки моушн SVGator для анимации этого логотипа". Вы вызываете его вручную намеренно: так навык не расходует ваши токены, когда вы только экспортируете или вносите небольшие правки, и загружается только тогда, когда вам действительно нужно дополнительное художественное руководство.

Начинайте с собственного изображения, затем анимируйте: Генерация оригинальных фигур с нуля — самая сложная задача для любого AI-ассистента. Для достижения наилучших результатов сначала создайте или импортируйте ваш SVG в редакторе SVGator, а затем попросите ассистента анимировать его. Это сохранит ваш визуальный стиль единообразным и позволит AI сосредоточиться на том, что у него получается лучше всего: движении, тайминге и последовательности.

Называйте элементы перед тем, как давать промпт: Ваш ассистент читает имена элементов, чтобы понять структуру проекта. Четкие имена, такие как «left_arm», «bg_circle» или «headline», помогают ему нацелиться на нужный элемент, избежать ошибок и оставаться организованным в сложных сценах. Общие имена усложняют его работу и могут в конечном итоге стоить вам больше токенов (в зависимости от модели).

Разбивайте сложные анимации на шаги: Вместо «создай мне полную анимацию онбординга» действуйте поэтапно: создайте элементы, добавьте ключевые кадры, затем уточните тайминг. Сервер применяет одно проверенное изменение за раз, поэтому меньшие шаги дают вам больше контроля и позволяют легко обнаружить и исправить любую ошибку.

Будьте конкретны в отношении тайминга и ощущения: «Плавное появление» — это довольно расплывчато. «Появление за 400 мс с замедлением в конце» дает вашему ассистенту конкретную задачу для работы. Чем больше вы описываете ощущение — будь то резкое, упругое, медленное или едва заметное, — тем ближе первый результат будет к тому, что вы задумали.

Подбирайте формат экспорта под место его использования: SVG — правильный выбор для веба, с возможностью выбора JavaScript или только CSS (для еще большей производительности). Lottie, React Native и Flutter легко передаются в проекты приложений и мобильной разработки. Видео и GIF готовы для соцсетей и email, где анимированный SVG не будет воспроизводиться. Выбор формата заранее экономит цикл повторного экспорта.

Дублируйте проект перед крупными экспериментами: Если вы хотите, чтобы AI перестроил что-то с нуля, попросите его сначала дублировать проект, а затем внести изменения в копию. Оригинал останется точно таким же, каким был, так что смелый эксперимент никогда не будет стоить вам рабочей версии. Завершите в редакторе: Каждый проект возвращается с прямой ссылкой на редактор. Когда ассистент выполнит основную часть работы, откройте проект и доведите его до совершенства вручную. ИИ берет на себя тяжелую работу, а вы сохраняете контроль над деталями. Это также экономит токены, поскольку небольшие правки вручную выполняются быстрее и дешевле, чем если бы ассистент вносил каждую из них.