Как работать с MCP

MCP-сервер @salutejs/sdds-mcp даёт ИИ-агенту (Claude Code, Cursor, VS Code и другим) доступ к актуальной документации sdds-cs. Без него агент пишет код по памяти и может перепутать названия компонентов и свойств.

После подключения ничего делать не нужно: агент сам обращается к документации, когда ему нужна информация о библиотеке. Вы задаёте вопросы обычным текстом.

info

Сервер поддерживает @salutejs/sdds-cs начиная с версии 0.348.0. Для более старых версий - сервис недоступен.

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

Сервер запускается локально одной командой. Нужен Node.js 18 или новее.

npx -y @salutejs/sdds-mcp@latest --lib sdds-cs

Как подключить сервер, зависит от агента:

claude mcp add sdds-cs -- npx -y @salutejs/sdds-mcp@latest --lib sdds-cs

Добавьте флаг --scope project, если сервер нужен всем участникам проекта: настройка сохранится в файле .mcp.json в корне репозитория.

Что можно спрашивать у агента​

Результат лучше, если назвать библиотеку и описать задачу.

  • Разобраться в библиотеке: Какие компоненты есть в sdds-cs?, Какие props есть у Button? Какие значения принимает view?, Приведи примеры использования TextField.
  • Сверстать экран: Сверстай форму входа на компонентах sdds-cs с валидацией через React Hook Form, Подбери иконку для кнопки удаления.
  • Начать проект: Как установить sdds-cs и подключить тему?, Покажи, как подключить sdds-cs в Next.js.
  • Стилизовать своё: Покажи токены, которые можно использовать в кастомном компоненте, Каким токеном задать цвет второстепенного текста?.

Инструменты​

Инструменты — это запросы к документации, которые агент выполняет сам. Знать их названия не обязательно, но по таблице видно, что агенту доступно.

ИнструментНазначениеПараметры
list_componentsСписок всех компонентов с кратким описанием.—
search_iconsПоиск иконок @salutejs/sdds-icons.query, limit
get_installation_guideУстановка библиотеки, подключение темы, шрифтов и токенов.—
get_nextjs_guideПодключение библиотеки в Next.js.—
get_form_guideРабота с формами: нативные формы и React Hook Form.—
get_tokensДизайн-токены для стилизации своих компонентов.—
get_componentОписание, свойства и примеры кода компонента.name

list_components​

Возвращает названия всех компонентов библиотеки и одно предложение о каждом. С него агент обычно начинает: выбирает подходящие компоненты, а затем запрашивает их подробности через get_component.

Параметры: нет.

search_icons​

Ищет иконки по названию и ключевым словам на русском и английском, например корзина или arrow. Возвращает имя компонента иконки, ключевые слова и доступные размеры (16, 24, 36). Иконка импортируется из @salutejs/sdds-icons/<размер>.

Параметры:

ПараметрТипОбязательныйОписание
querystringдаНазвание иконки или описание её смысла.
limitintegerнетСколько результатов вернуть: от 1 до 50, по умолчанию 20.

get_installation_guide​

Возвращает стартовое руководство: как установить пакет, какие есть варианты поставки, как подключить тему и шрифты, переключать светлую и тёмную тему, использовать компоненты и токены.

Параметры: нет.

get_nextjs_guide​

Возвращает руководство по Next.js: поддержка серверных компонентов через 'use client', подключение темы через emotion и пример работы с компонентами.

Параметры: нет.

get_form_guide​

Возвращает все руководства по формам: обычная HTML-форма и валидация, интеграция с React Hook Form, особенности отдельных компонентов в формах, например Slider и DatePicker.

Параметры: нет.

get_tokens​

Возвращает список токенов темы с пояснением, за что каждый отвечает: цвета, градиенты, типографика, скругления. С ними агент стилизует кастомные элементы в стиле дизайн-системы вместо значений, заданных вручную. Токены импортируются из @salutejs/sdds-themes/tokens.

Параметры: нет.

get_component​

Возвращает всё со страницы компонента в документации: описание, список свойств с типами и примеры кода. Регистр в имени не важен: button и Button дадут один результат. Если компонента с таким именем нет, агент получит список доступных имён и сможет выбрать подходящее.

Параметры:

ПараметрТипОбязательныйОписание
namestringдаНазвание компонента, например Button или TextField.

Если что-то не работает​

  • Сервер не запускается. Проверьте версию Node.js и доступ к plasma.sberdevices.ru: документация загружается оттуда.

  • Агент описывает не те компоненты. Проверьте, что в команде есть --lib sdds-cs: без этого флага сервер отдаёт документацию plasma-web.

  • Свойства не совпадают с вашей версией библиотеки. По умолчанию сервер отдаёт документацию последней версии. Добавьте в команду --version с версией @salutejs/sdds-cs из вашего package.json:

    npx -y @salutejs/sdds-mcp@latest --lib sdds-cs --version 0.380.0

    Если указанной версии нет, сервер использует последнюю.