MCP Server
Сервер ещё не развёрнут
Код сервера готов (apps/mcp в монорепо), публичный адрес появится после деплоя рядом с сайтом документации. URL ниже — целевой.
MCP (Model Context Protocol) — протокол, по которому агент обращается к внешнему инструменту во время работы. В отличие от AI Skills и LLMs.txt, которые поставляются вместе с версией библиотеки и читаются как статичный справочник, MCP-сервер отвечает на запросы вживую: всегда актуальный API компонентов, токены текущей темы, поиск по документации.
Подключение
Claude Code:
claude mcp add --transport http cds https://cds-preview-docs.vercel.app/mcpCursor / VS Code — конфиг MCP-серверов:
{
"mcpServers": {
"cds": { "type": "http", "url": "https://cds-preview-docs.vercel.app/mcp" }
}
}Авторизация не требуется: сервер доступен из внутренней сети.
Инструменты
| Tool | Аргументы | Что делает |
|---|---|---|
list_components | query? | Каталог компонентов по категориям: имя, назначение, ссылка на доку |
get_component_api | name, section? | Контракт из meta.json: props / events / slots / exposed, включая сабкомпоненты |
get_component_examples | name, demo? | Живые примеры (те же demo-SFC, что на сайте и в Storybook): список или код |
search_docs | query, limit? | Полнотекстовый поиск по страницам компонентов и гайдам |
get_tokens | group? | Дизайн-токены: палитра цветов и темы |
check_migration | name | Что изменилось в CDS 4 для компонента или темы (выборка из MIGRATION.md) |
Версия данных совпадает с версией @central-design-system/components на момент последнего релиза и сообщается в MCP-хендшейке.
Примеры запросов
Агенту достаточно обычной формулировки — он сам выберет инструмент:
- «Какие пропсы у CdsSelect?» →
get_component_api - «Покажи пример формы с валидацией на CDS» →
search_docs+get_component_examples - «Что поменялось у CdsList при переходе на CDS 4?» →
check_migration - «Какие есть цвета в палитре?» →
get_tokens
Когда MCP, а когда Skills или llms.txt
- Skills — процедура: как собрать UI, мигрировать, отревьюить. Скилл ведёт агента по шагам и подгружает справочники по мере надобности.
- MCP — свежие данные по запросу: API, примеры, токены, поиск, миграция. Работает в любом клиенте с поддержкой MCP, без установки пакетов.
- llms.txt — плоский каталог для агентов без скиллов и MCP.
Комбинация «скилл + MCP» — норма: скилл несёт правила, MCP отвечает на точечные вопросы по актуальной версии.