Model Context Protocol

Ваш 3D-каталог – прямо в диалоге.

Коннектор Vizbl позволяет Claude конвертировать 3D- и CAD-файлы, импортировать модели в ваш аккаунт, следить за конвейером конвертации и собирать AR-ссылки, QR-коды и кнопки для карточки товара – не выходя из чата. Приложите файл модели, опишите задачу, остальное сделает Claude.

Подключить сервер Посмотреть инструменты

Ваш ИИ-клиент
Вы прикладываете модель и просите её импортировать

OAuth 2.0 · ваше согласие, ваши разрешения

mcp.vizbl.com
Коннектор без состояния – здесь ничего не хранится

Необязательный API-ключ · ваш аккаунт

Vizbl Developer API
Конвейер конвертации и ваш 3D-каталог

Быстрый старт

Три действия, примерно минута.

Добавьте адрес ниже в свой клиент как пользовательский коннектор.
Подтвердите экран согласия. Поле API-ключа необязательное – оставьте его пустым, чтобы начать.
Приложите 3D- или CAD-файл и скажите «конвертируй это в USDZ». Ключ можно добавить позже, чтобы импортировать в свою библиотеку.

https://mcp.vizbl.com/mcp

Всё. Дальше по странице – справочник, вернётесь к нему, когда понадобится.

Подключение за четыре шага

Vizbl – удалённый MCP-сервер: ничего не нужно устанавливать и запускать локально. Подключается любой MCP-клиент с поддержкой удалённых серверов и OAuth.

Добавьте сервер в клиент

В Claude добавьте пользовательский коннектор с этим адресом:
```
https://mcp.vizbl.com/mcp
```
В Claude Code добавьте его из терминала:
```
claude mcp add --transport http vizbl https://mcp.vizbl.com/mcp
```
Транспорт: Streamable HTTP. Регистрация клиента динамическая – заранее заводить приложение в Vizbl не нужно.
Подтвердите подключение

Клиент откроет экран согласия Vizbl. Проверьте запрашиваемый доступ и подтвердите. Поле API-ключа необязательное: оставьте его пустым, чтобы подключиться без аккаунта Vizbl.
Добавьте секретный ключ для своей библиотеки

Девяти инструментам из двенадцати аккаунт Vizbl не нужен. Чтобы также импортировать, загружать и удалять модели, создайте в аккаунте Vizbl ключ Developer API типа secret – он начинается с sk_live_ и показывается один раз, при создании – и вставьте его на экране согласия. Ключ запечатывается в зашифрованные токены, выданные этому клиенту, и никогда не сохраняется на наших серверах. Подключиться заново, чтобы добавить или сменить ключ, можно в любой момент.
Начинайте работу

Приложите 3D- или CAD-файл и попросите Claude его конвертировать или – с ключом – импортировать в вашу библиотеку. Access-токен живёт 60 минут и молча обновляется до 90 дней, после чего достаточно один раз подтвердить доступ заново.

Инструменты

Чтение и запись разведены по разным инструментам. Инструменты только для чтения выполняются без подтверждения каждый раз; удаляющий всегда спрашивает вас.

Инструмент	Доступ	Что делает
`get_guide` Справка Vizbl	Только чтение	Возвращает официальный гайд Vizbl по теме: начало работы, установка, домены, токены, типы примерки, размеры печати, генерация 3D, конвертер, сцены и диагностика. Claude читает его перед тем, как объяснять устройство Vizbl.
`estimate_costs` Оценка расхода токенов	Только чтение	Переводит трафик и размер каталога в ожидаемый месячный расход токенов — всегда диапазоном и с явными допущениями. Только токены: цены Vizbl показываются на странице оплаты.
`convert_3d_model` Конвертация 3D-модели	Запись	Конвертирует и оптимизирует 3D- или CAD-файл, приложенный к переписке, в GLB, USDZ или FBX. Принимает 14 исходных форматов и возвращает идентификатор задачи конвертации.
`get_job_status` Статус задачи	Только чтение	Возвращает текущий статус длительной операции — конвертации или импорта — с этапом, предупреждениями, ошибкой и, по завершении, результатом. Может подождать ограниченное время вместо опроса.
`create_public_upload_url` Опубликовать файл	Запись	Размещает локальную модель или картинку в хранилище загрузок Vizbl и возвращает публичный https-адрес. Нужен везде, где инструмент просит URL — конвертация или изображение для кнопки Wall Art, — и работает без аккаунта Vizbl.
`create_upload_url` Ссылка для загрузки	Запись	Создаёт подписанную сессию загрузки, чтобы вы загрузили файл модели со своего устройства. Возвращает адрес загрузки и идентификатор, который использует инструмент импорта.
`upload_model` Загрузка 3D-модели	Запись	Публикует 3D-модель в Vizbl из файла, приложенного к переписке, или по идентификатору загрузки. Поддерживает несколько вариантов модели и опциональные имя, описание, теги, категорию и механику размещения. Возвращает идентификатор задачи импорта.
`get_ar_link` AR-ссылка	Только чтение	Строит по Object ID публичную ссылку, которая открывает опубликованный объект в AR на телефоне.
`get_qr` QR-код	Только чтение	Рисует QR-код AR-ссылки в SVG и PNG — для полиграфии, упаковки и карточек товара. Генерируется на наших серверах, ссылка не уходит в сторонние QR-сервисы.
`get_widget_snippet` Код кнопки-виджета	Только чтение	Собирает HTML AR-кнопки для карточки товара: скрипт подключения с вызовом инициализации и кнопку с идентификаторами объекта. Поддерживает виды App Clip, системный AR и 3D-просмотрщик.
`generate_wallart_buttons` Кнопки Wall Art	Только чтение	Генерирует пакет кнопок примерки постеров по списку товаров и проверяет физические размеры печати, помечая значения, похожие на разрешение изображения.
`delete_model` Удаление модели Vizbl	Удаление	Удаляет существующий объект Vizbl по публичному Object ID. Claude всегда спрашивает подтверждение перед вызовом.

Набор доступных инструментов зависит от разрешений, выданных при авторизации: в подключении только для чтения инструменты импорта и удаления не появятся. Справочные инструменты – гайды, оценка расхода, конвертация, ссылки и сниппеты – не обращаются к данным аккаунта и доступны всегда.

Примеры запросов

Обычные запросы – инструменты Claude выбирает сам. Работают как есть.

Импортируй этот chair.glb в Vizbl, назови «Дубовый стул», поставь тег «мебель» и дай ссылку, когда будет готово.

Claude вызывает upload_model с приложенным файлом, затем get_job_status – до окончания конвертации, и отвечает публичной ссылкой на объект.

Что случилось с импортом в Vizbl, который я запустил раньше?

Claude вызывает get_job_status с идентификатором задачи и сообщает текущий этап или ошибку, если импорт не удался.

Вот три файла моделей для летней коллекции – импортируй их все в Vizbl как настенные объекты и подведи итог.

Claude вызывает upload_model для каждого файла с общей схемой именования и возвращает таблицу идентификаторов и статусов.

Это STEP от наших конструкторов – преврати его в лёгкий GLB для карточки товара.

Claude вызывает convert_3d_model, затем get_job_status и предлагает импортировать результат в Vizbl.

У нас 400 ковров и около 60 000 посетителей в месяц – сколько токенов Vizbl закладывать в бюджет?

Claude вызывает estimate_costs и отвечает диапазоном, названными допущениями и рекомендованным пакетом – в токенах, без валюты.

Дай AR-кнопку и QR-код для объекта a1b2c3d4 – для карточки товара и упаковки.

Claude вызывает get_widget_snippet и get_qr и напоминает добавить домен магазина в список разрешённых в Vizbl.

Удали объект Vizbl с tinuuid a1b2c3d4 – мы загрузили его дважды.

Claude сначала спросит подтверждение, затем вызовет delete_model для этого tinuuid.

Чего ожидать

Практические ограничения размещённого коннектора.

Файлы и форматы

Форматы импорта: glb, gltf, obj, usdz, fbx
Конвертер принимает: dae, fbx, glb, gltf, iges, igs, obj, ply, step, stp, stl, usd, usdc, usdz
Максимальный размер файла: 200 МБ на вариант
Источник: Файлы из переписки или загруженные с вашего устройства
Мультивариантность: Поддерживается, первый вариант – основной

Время и сессии

Ожидание за вызов: до 90 секунд
Access-токен: 60 минут
Refresh-токен: 90 дней
Состояние сервера: Без состояния – сессии не хранятся

Что нужно заранее

Чтобы начать, не нужно ничего: справочным инструментам – гайдам, оценке расхода, конвертации, ссылкам и сниппетам – аккаунт Vizbl не нужен вовсе. Аккаунт Vizbl с доступом к Developer API и секретный ключ добавляют инструменты импорта, загрузки и удаления; импорт расходует обычную квоту конвертации вашего аккаунта. Коннектор не создаёт учётные записи, не меняет тарификацию и не генерирует изображения, видео или аудио с помощью ИИ-моделей.

Что происходит с вашими данными

Кратко; полный текст – в политике конфиденциальности.

Ваш API-ключ

Шифруется внутри OAuth-токенов, которые хранит ваш клиент. Сервер не держит ни копии ключа, ни базы подключений.

Ваши файлы моделей

Загружаются в память, передаются в Vizbl Developer API от имени вашей учётной записи и затем удаляются. Хранятся они в вашем аккаунте Vizbl – так же, как при загрузке через приложение.

Ваша переписка

На сервер попадают только аргументы вызова инструмента. Мы никогда не запрашиваем историю переписки, память и файлы, не относящиеся к импорту.

Поддержка

Вопросы, сообщения об ошибках и уязвимостях.

Связаться с нами

Пишите на [email protected]. Если сообщаете о неудачном импорте, укажите идентификатор задачи – так мы быстрее всего поймём, что произошло.

Состояние этого сервиса: https://mcp.vizbl.com/health

Ещё от Vizbl

Та же Developer API доступна напрямую и через SDK @vizbl/node, в состав которого входит локальный MCP-сервер для десктопных клиентов. Подробнее – на vizbl.com.