three.ws Assistant Widget — MCP-сервер для Claude Code: установка
Генерирует готовый код вставки 3D-аватара для сайта прямо в чате с моделью. Помогает настроить плавающий виджет чат-бота без ручной сборки параметров.
claude mcp add --env THREE_WS_BASE=<THREE_WS_BASE> --transport stdio assistant-mcp -- npx -y @three-ws/assistant-mcpЧто делает three.ws Assistant Widget
MCP-сервер предоставляет две функции: build_assistant_widget и list_assistant_options. Первая принимает настройки оформления, поведения и возвращает HTML-тег <script>, адрес для фрейма <iframe> и вызов ThreeAssistant.init(). Вторая отдаёт список готовых трёхмерных аватарок, цветовых фонов и поддерживаемых режимов диалога.
Генератор работает автономно без внешних сетевых вызовов и API-ключей. Значения валидируются локально: если передать неподдерживаемый цвет или слишком длинную строку приветствия, инструмент применит безопасное значение по умолчанию. Сервер использует стандартный домен сервиса, но через переменную THREE_WS_BASE можно переключить генерацию на собственный адрес развёртывания.
Какие задачи решает
- собрать тег
<script>с параметрами для виджета трёхмерного ассистента - получить готовую ссылку для встраивания чат-бота во фрейм
<iframe> - узнать список доступных аватаров и пресетов через
list_assistant_options - сгенерировать вызов
ThreeAssistant.initдля клиентского JavaScript-кода
Примеры запросов агенту
- Собери код виджета с аватаром
/avatars/selfie-girl.glb, синим акцентом и приветствием для посетителей - Покажи доступные встроенные аватары и варианты фона через MCP-сервер
- Сделай встраиваемый фрейм ассистента в режиме диалога и речи с положением слева
Как установить three.ws Assistant Widget
Командой платформы
claude mcp add --env THREE_WS_BASE=<THREE_WS_BASE> --transport stdio assistant-mcp -- npx -y @three-ws/assistant-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add assistant-mcp --env THREE_WS_BASE=<THREE_WS_BASE> -- npx -y @three-ws/assistant-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"assistant-mcp": {
"command": "npx",
"args": [
"-y",
"@three-ws/assistant-mcp"
],
"env": {
"THREE_WS_BASE": "<THREE_WS_BASE>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"assistant-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@three-ws/assistant-mcp"
],
"env": {
"THREE_WS_BASE": "<THREE_WS_BASE>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e THREE_WS_BASE=<THREE_WS_BASE> assistant-mcp npx -y @three-ws/assistant-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о three.ws Assistant Widget
Как установить three.ws Assistant Widget в Claude Code?
Выполните команду claude mcp add assistant-widget -- npx -y @three-ws/assistant-mcp. Если нужен собственный хост, используйте вариант claude mcp add --env THREE_WS_BASE=<THREE_WS_BASE> --transport stdio assistant-mcp -- npx -y @three-ws/assistant-mcp.
Что делает MCP-сервер three.ws Assistant Widget?
Сервер формирует код вставки плавающего 3D-ассистента на сайт. На выходе инструмент возвращает тег <script>, ссылку на отдельный фрейм и блок вызова JS API.
Нужен ли API-ключ для работы сервера?
Ключ не требуется, так как генерация разметки выполняется локально. При передаче некорректных параметров скрипт автоматически откатывается к стандартным значениям.
