Как работать с MCP
MCP-сервер @salutejs/sdds-mcp даёт ИИ-агенту (Claude Code, Cursor, VS Code и другим) доступ к актуальной документации plasma-b2c. Без него агент пишет код по памяти и может перепутать названия компонентов и свойств.
После подключения ничего делать не нужно: агент сам обращается к документации, когда ему нужна информация о библиотеке. Вы задаёте вопросы обычным текстом.
Сервер поддерживает @salutejs/plasma-b2c начиная с версии 1.611.0. Для более старых версий - сервис недоступен.
Быстрый старт
Сервер запускается локально одной командой. Нужен Node.js 18 или новее.
npx -y @salutejs/sdds-mcp@latest --lib plasma-b2c
Как подключить сервер, зависит от агента:
- Claude Code
- Cursor
- VS Code
- Другой агент
claude mcp add plasma-b2c -- npx -y @salutejs/sdds-mcp@latest --lib plasma-b2c
Добавьте флаг --scope project, если сервер нужен всем участникам проекта: настройка сохранится в файле .mcp.json в корне репозитория.
Добавьте в файл .cursor/mcp.json проекта или в глобальный ~/.cursor/mcp.json:
{
"mcpServers": {
"plasma-b2c": {
"command": "npx",
"args": ["-y", "@salutejs/sdds-mcp@latest", "--lib", "plasma-b2c"]
}
}
}
Добавьте в файл .vscode/mcp.json:
{
"servers": {
"plasma-b2c": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@salutejs/sdds-mcp@latest", "--lib", "plasma-b2c"]
}
}
}
Если агент просит указать command и args отдельно, используйте такой шаблон:
{
"mcpServers": {
"plasma-b2c": {
"command": "npx",
"args": ["-y", "@salutejs/sdds-mcp@latest", "--lib", "plasma-b2c"]
}
}
}
Что можно спрашивать у агента
Результат лучше, если назвать библиотеку и описать задачу.
- Разобраться в библиотеке:
Какие компоненты есть в plasma-b2c?,Какие props есть у Button? Какие значения принимает view?,Приведи примеры использования TextField,Какие хуки и утилиты есть в plasma-b2c?. - Сверстать экран:
Сверстай форму входа на компонентах plasma-b2c с валидацией через React Hook Form,Подбери иконку для кнопки удаления. - Начать проект:
Как установить plasma-b2c и подключить тему?. - Стилизовать своё:
Покажи токены, которые можно использовать в кастомном компоненте,Каким токеном задать цвет второстепенного текста?,Как задать отступы через applySpacing?.
Инструменты
Инструменты — это запросы к документации, которые агент выполняет сам. Знать их названия не обязательно, но по таблице видно, что агенту доступно.
| Инструмент | Назначение | Параметры |
|---|---|---|
list_components | Список всех компонентов с кратким описанием. | — |
search_icons | Поиск иконок @salutejs/sdds-icons. | query, limit |
get_installation_guide | Установка библиотеки и подключение темы. | — |
get_functions | Хоки, хуки, миксины и утилиты библиотеки. | — |
get_design_system_configuration | Цвета, типографика и отступы дизайн-системы. | — |
get_form_guide | Работа с формами: нативные формы и React Hook Form. | — |
get_tokens | Дизайн-токены для стилизации своих компонентов. | — |
get_component | Описание, свойства и примеры кода компонента. | name |
list_components
Возвращает названия всех компонентов библиотеки и одно предложение о каждом. С него агент обычно начинает: выбирает подходящие компоненты, а затем запрашивает их подробности через get_component.
Параметры: нет.
search_icons
Ищет иконки по названию и ключевым словам на русском и английском, например корзина или arrow. Возвращает имя компонента иконки, ключевые слова и доступные размеры (16, 24, 36). Иконка импортируется из @salutejs/sdds-icons/<размер>.
Параметры:
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
query | string | да | Название иконки или описание её смысла. |
limit | integer | нет | Сколько результатов вернуть: от 1 до 50, по умолчанию 20. |
get_installation_guide
Возвращает стартовое руководство: как установить пакет и подключить тему, как переключать темы, а также устаревший способ подключения для старых проектов.
Параметры: нет.
get_functions
Возвращает описание вспомогательных функций библиотеки: HOC-функции withAutoFocus и withSkeleton, хук useFocusTrap, миксины для стилизации через styled-components и утилиты: плавная прокрутка, определение устройства, медиазапросы.
Параметры: нет.
get_design_system_configuration
Возвращает разделы о настройке дизайн-системы: цветовая палитра и цветовые токены, типографика с токенами, компонентами и подключением шрифтов, стандартные отступы через миксин applySpacing, а также устаревшая типографика для обратной совместимости.
Параметры: нет.
get_form_guide
Возвращает все руководства по формам: обычная HTML-форма и валидация, интеграция с React Hook Form, особенности отдельных компонентов в формах, например Slider и DatePicker.
Параметры: нет.
get_tokens
Возвращает список токенов темы с пояснением, за что каждый отвечает: цвета, градиенты, типографика, скругления. С ними агент стилизует кастомные элементы в стиле дизайн-системы вместо значений, заданных вручную. Токены импортируются из @salutejs/plasma-themes/tokens.
Параметры: нет.
get_component
Возвращает всё со страницы компонента в документации: описание, список свойств с типами и примеры кода. Регистр в имени не важен: button и Button дадут один результат. Если компонента с таким именем нет, агент получит список доступных имён и сможет выбрать подходящее.
Параметры:
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
name | string | да | Название компонента, например Button или TextField. |
Если что-то не работает
-
Сервер не запускается. Проверьте версию Node.js и доступ к
plasma.sberdevices.ru: документация загружается оттуда. -
Агент описывает не те компоненты. Проверьте, что в команде есть
--lib plasma-b2c: без этого флага сервер отдаёт документациюplasma-web. -
Свойства не совпадают с вашей версией библиотеки. По умолчанию сервер отдаёт документацию последней версии. Добавьте в команду
--versionс версией@salutejs/plasma-b2cиз вашегоpackage.json:npx -y @salutejs/sdds-mcp@latest --lib plasma-b2c --version 1.644.0Если указанной версии нет, сервер использует последнюю.