Mobiscroll MCP
официальныйВерсионированные знания API для Mobiscroll UI — планировщик, календарь событий, таймлайн и пикеры — плюс API календаря Connect. 14 инструментов только для чтения.
Что можно делать с Mobiscroll MCP?
- Resolve project environment — Попросите ассистента определить ваш фреймворк и версию Mobiscroll из
package.jsonс помощьюresolveEnvironment. - List available components — Пусть ассистент перечислит все компоненты Mobiscroll для вашего фреймворка и версии, используя
listComponents. - Fetch component schemas — Получите точные параметры, события, методы и рендереры для любого компонента через
getComponentSchema. - Search and retrieve examples — Найдите подходящие примеры кода по ключевому слову с помощью
searchExamplesи получите полный исходный код черезgetExampleById. - Validate generated code — Проверьте фрагменты кода на неизвестные свойства, события или устаревшее использование с помощью
validateCode. - Map Connect REST to SDK — Найдите эквивалентный метод SDK для любой конечной точки Connect REST с помощью
mapConnectEndpointToSdk.
Размещённый MCP-сервер
npx add-mcp 'https://mcp.mobiscroll.com'Устанавливается в Claude Code, Codex, Cursor и другие
Документация
Mobiscroll поставляет MCP-сервер и навыки агента, чтобы помощники по кодированию генерировали корректный код планировщика, календаря событий, таймлайна и пикера — для Claude Code, Codex, Cursor и GitHub Copilot, а также машиночитаемую документацию и правила поведения ИИ.
Зачем нужна интеграция с ИИ?
Помощники по кодированию на основе ИИ работают лучше всего, когда у них есть доступ к структурированной, авторитетной документации. Без неё они часто:
- Галлюцинируют API — выдумывают названия опций, события или типы, которых не существует
- Смешивают фреймворки — используют импорты модулей Angular или синтаксис плагинов jQuery вместо хуков React и JSX
- Ссылаются на устаревшие версии — генерируют код v5, когда текущая версия — v6
- Игнорируют соглашения фреймворка — пропускают именованные импорты из
@mobiscroll/reactили опускают импорт CSS
Интеграция Mobiscroll с ИИ решает эти проблемы, предоставляя документацию, оптимизированную для потребления ИИ, в сочетании с правилами поведения, которые обеспечивают изоляцию фреймворков и корректное использование API.
Обзор архитектуры
Интеграция состоит из трёх уровней:
Уровень данных — файлы llms
Машиночитаемые файлы документации, содержащие полный справочник API Mobiscroll и руководства, по одному на каждый фреймворк. Это источник истины, который инструменты ИИ читают для ответов на вопросы.
| Файл | Описание |
|---|---|
llms-react-full.txt | Полная документация по React |
llms-react.txt | Оглавление React (ссылки на отдельные страницы) |
llms-icons.txt | Названия иконок (IcoMoon, Font Awesome, Ionicons) — все фреймворки |
[!-info] -info info
Вам не нужно скачивать или размещать эти файлы — файлы правил и плагины Claude Code и Codex ссылаются на них напрямую и автоматически получают их содержимое.
Уровень правил — файлы правил
Файлы правил предоставляют контекст Mobiscroll только для Cursor и GitHub Copilot. Claude Code и Codex используют плагин Mobiscroll — ручная настройка файлов не требуется.
Доступны два подхода:
- Вариант A — загрузка контекста на основе файлов. Файл правил (
.mdcдля Cursor,.instructions.mdдля Copilot) содержит документацию по API и правила поведения. MCP-сервер не требуется. - Вариант B — получение живой схемы через MCP-сервер. Расширенные файлы правил инструктируют ИИ вызывать MCP-сервер Mobiscroll для получения живой схемы компонентов при каждой генерации. Подходит для интерактивных агентов кодирования, которым нужна точность по каждому запросу.
Выбирайте в зависимости от ваших предпочтений и настройки.
Файлы
Вариант A — правила на основе файлов:
| Файл | Формат | Для |
|---|---|---|
mobiscroll-react.mdc | Файл правил Cursor | Cursor |
copilot-instructions/mobiscroll-react.instructions.md | Файл инструкций Copilot | GitHub Copilot |
Вариант B — расширенные правила с MCP:
| Файл | Формат | Для |
|---|---|---|
| mobiscroll-ui.mdc | Расширенное правило Cursor (оркестратор) | Cursor |
| mobiscroll-ui-react.mdc | Расширенное правило Cursor (React) | Cursor |
| mobiscroll-ui-theming.mdc | Расширенное правило Cursor (темизация) | Cursor |
| mobiscroll-ui.instructions.md | Расширенная инструкция Copilot (оркестратор) | GitHub Copilot |
| mobiscroll-ui-react.instructions.md | Расширенная инструкция Copilot (React) | GitHub Copilot |
| mobiscroll-ui-theming.instructions.md | Расширенная инструкция Copilot (темизация) | GitHub Copilot |
Какой инструмент какие файлы использует?
| Инструмент | Подход | Используемые файлы |
|---|---|---|
| Cursor | Вариант A | mobiscroll-react.mdc |
| Cursor | Вариант B | mobiscroll-ui.mdc, mobiscroll-ui-react.mdc, mobiscroll-ui-theming.mdc |
| GitHub Copilot | Вариант A | mobiscroll-react.instructions.md |
| GitHub Copilot | Вариант B | mobiscroll-ui.instructions.md, mobiscroll-ui-react.instructions.md, mobiscroll-ui-theming.instructions.md |
Уровень живой схемы — MCP-сервер
MCP-сервер Mobiscroll предоставляет структурированные знания об API с указанием версии через Model Context Protocol. Это единый унифицированный сервер: тот же mobiscroll сервер, который предоставляет эти инструменты UI-компонентов, также обслуживает инструменты Mobiscroll Connect с префиксом Connect, чтобы они никогда не конфликтовали. Вместо того чтобы полагаться на снимки документации, ассистент может вызывать эти инструменты для получения точной схемы компонента, допустимых свойств/событий или рабочего примера в момент генерации — так он никогда не галлюцинирует и не отклоняется от текущего API. См. Справочник инструментов MCP для полного списка того, что он предоставляет.
Это размещённый Streamable HTTP сервер по адресу https://mcp.mobiscroll.com/ — локальная установка не требуется. Он необязателен для Cursor и GitHub Copilot (используется только если вы выберете Вариант B) и встроен/всегда включён для Claude Code и Codex через плагин.
Настройка Cursor
Шаг 1: Зарегистрируйте источники документации
Откройте Cursor Settings → Indexing & Docs и добавьте источник документации для вашего фреймворка:
| Фреймворк | Название | URL |
|---|---|---|
| React | Mobiscroll React | https://mobiscroll.com/docs/llms-react-full.txt |
Регистрируйте только источник, соответствующий вашему сценарию использования. Не регистрируйте несколько источников — это предотвращает перекрёстное загрязнение доменов.
Шаг 2: Добавьте правила поведения
Выберите один подход — Вариант A работает сразу без дополнительной настройки; Вариант B добавляет живые поиски схемы MCP для более высокой точности, но требует настройки MCP-сервера.
Вариант A — файл правил .mdc
Скачайте файл mobiscroll-react.mdc и поместите его в .cursor/rules/:
your-project/
├── .cursor/
│ └── rules/
│ └── mobiscroll-react.mdc
├── src/
└── package.json
Файл .mdc предоставляет текстовые правила API — дополнительная настройка не требуется.
Вариант B — Расширенные файлы правил + MCP (3 файла)
Скачайте три расширенных файла правил и поместите их в .cursor/rules/:
- mobiscroll-ui.mdc (оркестратор)
- mobiscroll-ui-react.mdc (соглашения React)
- mobiscroll-ui-theming.mdc (темизация)
your-project/
├── .cursor/
│ └── rules/
│ ├── mobiscroll-ui.mdc
│ ├── mobiscroll-ui-react.mdc
│ └── mobiscroll-ui-theming.mdc
├── src/
└── package.json
В отличие от Варианта A, эти файлы правил инструктируют ИИ Cursor вызывать MCP-сервер Mobiscroll для получения живой схемы компонентов при каждой генерации — так он работает с текущим API, а не угадывает по памяти. Проверяйте сгенерированный код перед объединением, как и любой вывод ИИ.
Активация правил
Расширенные файлы .mdc используют alwaysApply: false с description в их frontmatter. Cursor читает описание и активирует правило только когда контекст релевантен — правило не включается в каждое сообщение. Вы также можете запустить его вручную с помощью @rule-name (например, @mobiscroll-ui). Формат .mdc работает во всех режимах Cursor, включая режим Agent.
Шаг 3: Подключите MCP-сервер
Настройте MCP-сервер Mobiscroll, чтобы расширенные правила могли вызывать его для получения живой схемы.
Создайте или отредактируйте .cursor/mcp.json в корне вашего проекта:
{
"mcpServers": {
"mobiscroll": {
"url": "https://mcp.mobiscroll.com/"
}
}
}
[!-warning] -warning Нет поля
typeCursor определяет тип транспорта по URL. Не добавляйте
"type": "http"в конфигурацию Cursor — это вызывает ошибку.
your-project/
├── .cursor/
│ ├── mcp.json
│ └── rules/
│ ├── mobiscroll-ui.mdc
│ ├── mobiscroll-ui-react.mdc
│ └── mobiscroll-ui-theming.mdc
├── src/
└── package.json
| Область | Файл конфигурации | Общий для команды |
|---|---|---|
| проект | .cursor/mcp.json в корне проекта | Да, если закоммичен |
| глобальная | ~/.cursor/mcp.json | Нет, все ваши проекты |
Проверьте подключение: Откройте панель Output в Cursor и выберите MCP Logs из выпадающего списка. Успешное подключение регистрирует сообщения об обнаружении инструментов для сервера mobiscroll.
Как это работает
Когда спрашиваете Cursor о Mobiscroll, включите @docs, чтобы он прочитал зарегистрированную документацию:
@docs How do I set up a weekly scheduler with Mobiscroll?
@docs What options does the Eventcalendar timeline view accept?
Настройка GitHub Copilot
Шаг 1: Добавьте правила поведения
Выберите один подход — Вариант A работает сразу без дополнительной настройки; Вариант B добавляет живые поиски схемы MCP для более высокой точности, но требует настройки MCP-сервера.
Вариант A — файл правил .instructions.md
Скачайте файл mobiscroll-react.instructions.md и поместите его в .github/instructions/:
your-project/
├── .github/
| └── instructions/
| └── mobiscroll-react.instructions.md
├── src/
└── package.json
Файл .instructions.md предоставляет текстовые правила API — дополнительная настройка не требуется.
Вариант B — Расширенные файлы инструкций + MCP (3 файла)
Скачайте три расширенных файла инструкций и поместите их в .github/instructions/:
- mobiscroll-ui.instructions.md (оркестратор)
- mobiscroll-ui-react.instructions.md (соглашения React)
- mobiscroll-ui-theming.instructions.md (темизация)
your-project/
├── .github/
| └── instructions/
| ├── mobiscroll-ui.instructions.md
| ├── mobiscroll-ui-react.instructions.md
| └── mobiscroll-ui-theming.instructions.md
├── src/
└── package.json
Шаг 2: Подключите MCP-сервер
Настройте MCP-сервер Mobiscroll, чтобы расширенные файлы инструкций могли вызывать его для получения живой схемы.
Создайте или отредактируйте .vscode/mcp.json в корне вашего проекта:
{
"servers": {
"mobiscroll": {
"type": "http",
"url": "https://mcp.mobiscroll.com/"
}
}
}
[!-warning] -warning
"servers"не"mcpServers"VS Code использует
"servers"как корневой ключ — не"mcpServers"как Claude Code и Cursor. Использование неправильного ключа молча ломает конфигурацию без сообщения об ошибке.
your-project/
├── .vscode/
│ └── mcp.json
├── .github/
│ └── instructions/
│ ├── mobiscroll-ui.instructions.md
│ ├── mobiscroll-ui-react.instructions.md
│ └── mobiscroll-ui-theming.instructions.md
├── src/
└── package.json
| Область | Файл конфигурации | Общий для команды |
|---|---|---|
| рабочая область | .vscode/mcp.json в корне проекта | Да, если закоммичен |
| профиль пользователя | Открывается через MCP: Open User Configuration | Нет, все ваши рабочие области |
Проверьте подключение: Откройте Command Palette и выполните MCP: List Servers. Сервер mobiscroll должен появиться со статусом подключения. При первом использовании появится диалог доверия — подтвердите его, чтобы разрешить запуск сервера.
В качестве альтернативы откройте Command Palette и выполните MCP: Add Server для пошаговой настройки.
Как это работает
Файлы инструкций с applyTo: "**" применяются автоматически ко всем запросам Copilot Chat — ручная ссылка не нужна. Оба варианта содержат:
- URL-адреса документации — указывают ИИ на правильную документацию фреймворка
- Сопоставление компонентов — сопоставляют намерения пользователя (например, "планировщик") с правильными API Mobiscroll
- Правила — обеспечивают корректные импорты пакетов, загрузку CSS и использование API
- Ограничения — предотвращают смешивание фреймворков и галлюцинации API
Задавайте вопросы о Mobiscroll напрямую:
How do I set up a weekly scheduler with Mobiscroll?
What options does the Eventcalendar timeline view accept?
Настройка Claude Code
Установите плагин Mobiscroll для Claude Code. Плагин объединяет навыки кодирования фреймворка и MCP-сервер в одной установке — файлы конфигурации для каждого проекта не нужны.
Шаг 1: Зарегистрируйте маркетплейс
Выполните эту команду один раз в Claude Code, чтобы зарегистрировать маркетплейс плагинов Mobiscroll:
/plugin marketplace add acidb/mobiscroll-marketplace
Шаг 2: Установите плагин
/plugin install mobiscroll@mobiscroll
[!-warning] -warning Навыки плагина не обновляются автоматически
Установка плагина создаёт снимок его навыков — Claude Code не будет загружать новые версии самостоятельно, если вы не включите автоматическое обновление для маркетплейса. Чтобы получить последнюю версию в любое время, выполните
/plugin marketplace update mobiscroll && /plugin update mobiscroll@mobiscroll, затем/reload-plugins.
Шаг 3: Подключите MCP-сервер
Плагин включает MCP-сервер — отдельная конфигурация для большинства настроек не нужна. Чтобы настроить его вручную или поделиться с командой:
claude mcp add --transport http mobiscroll https://mcp.mobiscroll.com/
[!-warning] -warning Расширение VS Code
Если вы используете расширение Claude для Visual Studio Code, сервер не появится, если он не добавлен с областью проекта. См. следующую команду ниже.
Чтобы автоматически поделиться сервером с командой, используйте область проекта:
claude mcp add --transport http --scope project mobiscroll https://mcp.mobiscroll.com/
Это создаёт или обновляет .mcp.json в корне вашего проекта. Вы также можете создать этот файл вручную:
{
"mcpServers": {
"mobiscroll": {
"type": "http",
"url": "https://mcp.mobiscroll.com/"
}
}
}
| Область | Флаг CLI | Расположение конфигурации | Общий для команды |
|---|---|---|---|
| локальная (по умолчанию) | --scope local | ~/.claude.json | Нет |
| проект | --scope project | .mcp.json в корне проекта | Да, через систему контроля версий |
| пользователь | --scope user | ~/.claude.json | Нет, все ваши проекты |
[!-info] -info info
Используйте
--scope projectдля командных репозиториев, чтобы все получали MCP-сервер автоматически при клонировании проекта. [!-warning] -warning Также подключено из каталога?Если ваша организация включила коннектор Mobiscroll из каталога Anthropic, сервер уже может быть доступен через ваш аккаунт Claude. Запись
.mcp.jsonв рамках проекта и коннектор из каталога — это два пути к одному и тому же серверу, и Claude Code может сообщать, что проектная запись не загружается, пока вы не авторизуете коннектор в своем аккаунте. Авторизуйте его один раз — и оба способа заработают, либо удалите запись.mcp.jsonи полагайтесь только на коннектор. См. Настройка приложения Claude ниже.
Проверка подключения: Выполните /mcp внутри Claude Code. Панель показывает каждый подключенный сервер и количество его инструментов. При корректном подключении отображается mobiscroll как минимум с одним инструментом.
Как это работает
После установки плагин предоставляет:
- Навыки —
mobiscroll-ui— это оркестрирующий навык, который определяет ваш фреймворк (React, Angular, Vue, JavaScript или jQuery) и загружает соответствующий под-навык фреймворка. Вопросы по темам обрабатываются навыкомmobiscroll-ui-theming. Все навыки устанавливаются вместе. - MCP-сервер — встроенный MCP-сервер Mobiscroll обеспечивает поиск актуальных схем компонентов, проверку кода и поиск примеров по запросу, поэтому Claude работает с текущим API, а не полагается на память. Проверяйте сгенерированный код перед объединением, как и любой вывод ИИ.
Когда вы просите Claude Code написать код Mobiscroll, он:
- Определяет ваш фреймворк и версию Mobiscroll через
resolveEnvironment - Загружает соответствующий навык фреймворка с идиоматическими соглашениями
- Ищет схему компонента перед написанием любых свойств или событий
- Проверяет сгенерированный код перед возвратом вам
Настройка Codex
Установите плагин Mobiscroll для OpenAI Codex. Плагин объединяет навыки написания кода для фреймворков и MCP-сервер в одной установке — файлы конфигурации для каждого проекта не требуются.
Шаг 1: Зарегистрируйте маркетплейс
Выполните эту команду один раз в Codex, чтобы зарегистрировать маркетплейс плагина Mobiscroll:
/plugins marketplace add acidb/mobiscroll-marketplace
Шаг 2: Установите плагин
/plugins install mobiscroll@mobiscroll
[!-warning] -warning Навыки плагина не обновляются автоматически
Установка плагина создает снимок его навыков — Codex не будет подтягивать новые версии самостоятельно. Чтобы получить последнюю версию в любой момент, обновите каталог маркетплейса и переустановите плагин:
/plugins marketplace update mobiscroll, затем/plugins install mobiscroll@mobiscroll.
Шаг 3: Подключите MCP-сервер
Плагин включает MCP-сервер — для большинства настроек отдельная конфигурация не требуется. Чтобы настроить его вручную или поделиться с командой, добавьте его в ~/.codex/config.toml (глобально) или .codex/config.toml (проект):
[mcp_servers.mobiscroll]
url = "https://mcp.mobiscroll.com/"
Вы также можете зарегистрировать его из командной строки:
codex mcp add mobiscroll --url https://mcp.mobiscroll.com/
| Область | Расположение конфигурации | Доступно команде |
|---|---|---|
| глобальная | ~/.codex/config.toml | Нет, для всех ваших проектов |
| проектная | .codex/config.toml в корне проекта (только для доверенных проектов) | Да, через систему контроля версий |
[!-info] -info info
Используйте проектный
.codex/config.tomlдля командных репозиториев, чтобы все участники автоматически получали MCP-сервер при клонировании проекта.
Проверка подключения: Выполните /mcp внутри Codex. Панель показывает каждый подключенный сервер и количество его инструментов. При корректном подключении отображается mobiscroll со списком его инструментов.
Как это работает
После установки плагин предоставляет:
- Навыки —
mobiscroll-ui— это оркестрирующий навык, который определяет ваш фреймворк (React, Angular, Vue, JavaScript или jQuery) и загружает соответствующий под-навык фреймворка. Вопросы по темам обрабатываются навыкомmobiscroll-ui-theming. Все навыки устанавливаются вместе. - MCP-сервер — встроенный MCP-сервер Mobiscroll обеспечивает поиск актуальных схем компонентов, проверку кода и поиск примеров по запросу, поэтому Codex работает с текущим API, а не полагается на память. Проверяйте сгенерированный код перед объединением, как и любой вывод ИИ.
Когда вы просите Codex написать код Mobiscroll, он:
- Определяет ваш фреймворк и версию Mobiscroll через
resolveEnvironment - Загружает соответствующий навык фреймворка с идиоматическими соглашениями
- Ищет схему компонента перед написанием любых свойств или событий
- Проверяет сгенерированный код перед возвратом вам
Настройка приложения Claude — claude.ai, Desktop и мобильные устройства
MCP-сервер опубликован в каталоге коннекторов Anthropic, поэтому Claude в вебе, Claude Desktop и мобильные приложения Claude могут использовать его без файлов проекта или команд CLI. Это тот же сервер, что и в редакторных настройках выше — разница только в способе доступа.
Шаг 1: Подключение из каталога
Откройте Настройки → Коннекторы → Обзор коннекторов, найдите Mobiscroll и нажмите Подключить.
Настраивать ничего не нужно. Сервер доступен только для чтения и не требует аккаунта, API-ключа или входа через OAuth.
Шаг 2: Включите его для вашей организации (Team и Enterprise)
В планах Team и Enterprise владелец сначала добавляет коннектор для организации. Затем каждый участник подключает его в своем аккаунте — коннектор отображается у всех, но не отвечает, пока конкретный участник не подключил его.
[!-warning] -warning Уже добавили как пользовательский коннектор?
Если вы добавили
mobiscrollвручную до появления в каталоге, удалите эту запись перед подключением из каталога. Две записи, указывающие наhttps://mcp.mobiscroll.com/, регистрируют одни и те же инструменты дважды, и Claude может вызвать не ту копию, которую вы ожидаете.Откройте Настройки → Коннекторы, найдите свою пользовательскую запись
mobiscrollи удалите ее. Затем подключитесь из каталога.
Как это работает
Claude вызывает те же 14 инструментов только для чтения, перечисленных в Справочнике инструментов MCP ниже. Спросите его о параметрах компонента, сигнатуре события, конечной точке Connect или SDK-эквиваленте REST-вызова — и он прочитает актуальную схему вместо ответа по памяти.
Коннектор из каталога не содержит навыков. Они входят в плагины Claude Code и Codex — чтобы писать код Mobiscroll внутри проекта, используйте Настройку Claude Code выше.
Справочник инструментов MCP
MCP-сервер предоставляет 14 инструментов. Все они доступны только для чтения и помечены соответствующим образом, поэтому ИИ-ассистент может вызывать их без запроса подтверждения каждый раз. Ни один из них не читает и не записывает данные в вашем аккаунте Mobiscroll, а инструменты Connect описывают API Connect, а не вызывают его.
Инструменты Mobiscroll UI
| Инструмент | Что возвращает | Требуется |
|---|---|---|
resolveEnvironment | Фреймворк и основную версию, которые использует проект, считанные из его package.json. Это значения, которые другие инструменты UI принимают в качестве аргументов. | содержимое package.json |
listComponents | Все компоненты, доступные для фреймворка и версии, с кратким описанием и количеством сущностей. | framework, major |
getComponentSchema | Параметры, события, методы и рендереры для одного компонента. Сначала возвращает компактный индекс; вызовите повторно с конкретными именами для полной информации. | component, framework, major |
searchExamples | Примеры, соответствующие ключевым словам, отфильтрованные по компоненту и версии, отсортированные по релевантности. | framework, major |
getExampleById | Полный пример с исходными файлами, описанием и примечаниями по реализации. | exampleId, framework, major |
validateCode | Неизвестные свойства, события и методы во фрагменте, а также устаревшее использование. Статический анализ — ничего не выполняется. | component, framework, major, snippet |
Инструменты Mobiscroll Connect
Тот же сервер также отвечает на вопросы о REST API Connect и его SDK. Они полностью описаны в Руководстве по интеграции ИИ Connect.
| Инструмент | Что возвращает | Требуется |
|---|---|---|
resolveConnectEnvironment | Какой SDK Connect и версию использует проект, считанные из его манифеста зависимостей. | содержимое манифеста |
listConnectEndpoints | Все конечные точки REST Connect с методом, путем, кратким описанием и аутентификацией. | — |
getConnectEndpointSchema | Одну конечную точку полностью: параметры с типами, аутентификацию, статусы ответов, примеры. | endpointId, или method + path |
listConnectSdkMethods | Ресурсы и методы, которые предоставляет SDK одного языка. | language |
getConnectSdkMethod | Один метод SDK полностью: сигнатуру, параметры, тип возвращаемого значения, комментарий документации, пример. | language, method |
searchConnect | Совпадения по ключевым словам среди конечных точек REST и методов SDK. | query |
mapConnectEndpointToSdk | Эквивалентный вызов SDK для конечной точки REST, на каждом языке или на одном. | endpointId, или method + path |
getConnectErrorTaxonomy | Каждую категорию ошибок с HTTP-статусом и идиоматическим типом исключения для каждого языка. | — |
[!-success] -success Начните с вызова resolve
Сервер работает удаленно и не может читать ваши файлы, поэтому
resolveEnvironmentиresolveConnectEnvironmentпринимают содержимое вашего манифеста в качестве аргумента. Каждый другой инструмент принимает фреймворк, версию или язык напрямую, если вы уже их знаете.
Изоляция фреймворков
[!-warning] -warning Критически важно
Каждый файл правил и источник документации предназначен ровно для одного фреймворка или домена. Никогда не смешивайте файлы разных фреймворков и не смешивайте файлы UI-фреймворков с файлами Connect.
Почему это важно:
- Большинство параметров API общие для всех фреймворков, но использование компонентов и шаблонизация различаются — их смешивание приводит к нерабочему коду
Mobiscroll Connect — отдельный домен:
- Connect — это серверный интеграционный слой — OAuth 2.0, REST API, вебхуки, синхронизация календаря
- В нем нет UI-компонентов, JSX или привязок к фронтенд-фреймворкам
- Connect использует
mobiscroll-connect.mdcиllms-connect-full.txt— никогда файлы UI-фреймворков - Смешивание документации Connect с документацией UI приводит к тому, что ИИ путает конечные точки REST с API компонентов
[!-info] -info info
Плагин
mobiscroll@mobiscrollтакже включает навыкmobiscroll-connectдля серверного Connect (OAuth, REST, синхронизация календаря). Он активируется только для серверной работы с Connect и никогда не смешивается с кодом UI-компонентов. См. Руководство по интеграции ИИ Connect.
Правила:
- Используйте только файлы правил, соответствующие одному фреймворку или домену — никогда не смешивайте файлы разных фреймворков
- Регистрируйте только один источник документации в Cursor
- Если ваш проект использует несколько фреймворков (например, микро-фронтенды), настройте отдельные каталоги с отдельными файлами
.mdc - Если ваш проект использует и UI-фреймворк, и Mobiscroll Connect, используйте отдельные каталоги контекста ИИ для каждого
- Если ИИ-ассистент генерирует код с неправильными импортами фреймворка, проверьте, что нужный файл правил на месте
Примеры запросов
Эти примеры показывают типы вопросов, для которых предназначена интеграция ИИ.
How do I create an Eventcalendar with a weekly scheduler view?
Add drag and drop support to my Mobiscroll timeline.
What is the type for calendar events in Mobiscroll React?
Устранение неполадок
ИИ генерирует код с неправильным фреймворком
Симптом: Вы используете React, но ИИ генерирует код для другого фреймворка (например, import { Eventcalendar } from '@mobiscroll/angular').
Решение: Убедитесь, что нужный файл правил на месте. Для React в Cursor используйте mobiscroll-react.mdc; для Copilot — mobiscroll-react.instructions.md. В Cursor проверьте, что зарегистрированный источник @docs указывает на llms-react-full.txt.
ИИ выдумывает несуществующие API
Симптом: ИИ предлагает параметры, события или типы, которых нет в документации Mobiscroll.
Решение: Правила .mdc предписывают ИИ использовать только API из документации. Если это все еще происходит, явно укажите @docs в запросах Cursor или убедитесь, что плагин Mobiscroll установлен в Claude Code (/plugin list) или Codex (codex plugin list). Вы также можете попросить ИИ проверить, существует ли параметр в документации Mobiscroll.
ИИ смешивает Mobiscroll Connect с UI-компонентами
Симптом: ИИ генерирует вызовы REST API, когда вы спрашивали о фронтенд-компоненте календаря, или генерирует код JSX/компонентов, когда вы спрашивали об API Connect.
Исправление: Mobiscroll Connect — это серверный интеграционный слой (OAuth, REST, вебхуки) и не содержит UI-компонентов. Eventcalendar — это фронтендный UI-компонент без REST API. Они используют полностью отдельные файлы .mdc и источники документации. Убедитесь, что для вашего проекта активен правильный файл .mdc. Если вы используете оба в одной кодовой базе, храните отдельные каталоги контекста ИИ для каждого из них.
MCP-сервер не появляется после настройки
Симптом: Панель MCP-сервера не показывает запись mobiscroll, или инструменты недоступны.
Исправление: Проверьте, что файл конфигурации находится в правильном месте и использует правильный корневой ключ — mcpServers для Claude Code, Codex и Cursor, servers для VS Code. Убедитесь, что файл является корректным JSON. Для Claude Code или Codex выполните /mcp, чтобы просмотреть подключенные серверы.
Справочник файлов
Все файлы интеграции ИИ доступны по следующим URL-адресам:
Файлы документации
| Файл | URL |
|---|---|
| React | https://mobiscroll.com/docs/llms-react-full.txt |
Файлы правил
| Файл | Cursor (.mdc) | Copilot (.instructions.md) |
|---|---|---|
| Правила React | mobiscroll-react.mdc | copilot-instructions/mobiscroll-react.instructions.md |
Расширенные файлы правил
| Файл | Cursor (.mdc) | Copilot (.instructions.md) |
|---|---|---|
| Оркестратор | mobiscroll-ui.mdc | copilot-instructions/mobiscroll-ui.instructions.md |
| Соглашения React | mobiscroll-ui-react.mdc | copilot-instructions/mobiscroll-ui-react.instructions.md |
| Темы | mobiscroll-ui-theming.mdc | copilot-instructions/mobiscroll-ui-theming.instructions.md |
Содержимое файлов
Полное содержимое каждого файла приведено ниже. Вы можете скопировать его напрямую из этих блоков или использовать ссылки для скачивания выше.