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Файл правил CursorCursor
copilot-instructions/mobiscroll-react.instructions.mdФайл инструкций CopilotGitHub 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Вариант Amobiscroll-react.mdc
CursorВариант Bmobiscroll-ui.mdc, mobiscroll-ui-react.mdc, mobiscroll-ui-theming.mdc
GitHub CopilotВариант Amobiscroll-react.instructions.md
GitHub CopilotВариант Bmobiscroll-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
ReactMobiscroll Reacthttps://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/:

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 Нет поля type

Cursor определяет тип транспорта по 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/:

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, он:

  1. Определяет ваш фреймворк и версию Mobiscroll через resolveEnvironment
  2. Загружает соответствующий навык фреймворка с идиоматическими соглашениями
  3. Ищет схему компонента перед написанием любых свойств или событий
  4. Проверяет сгенерированный код перед возвратом вам

Настройка 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, он:

  1. Определяет ваш фреймворк и версию Mobiscroll через resolveEnvironment
  2. Загружает соответствующий навык фреймворка с идиоматическими соглашениями
  3. Ищет схему компонента перед написанием любых свойств или событий
  4. Проверяет сгенерированный код перед возвратом вам

Настройка приложения 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.

Правила:

  1. Используйте только файлы правил, соответствующие одному фреймворку или домену — никогда не смешивайте файлы разных фреймворков
  2. Регистрируйте только один источник документации в Cursor
  3. Если ваш проект использует несколько фреймворков (например, микро-фронтенды), настройте отдельные каталоги с отдельными файлами .mdc
  4. Если ваш проект использует и UI-фреймворк, и Mobiscroll Connect, используйте отдельные каталоги контекста ИИ для каждого
  5. Если ИИ-ассистент генерирует код с неправильными импортами фреймворка, проверьте, что нужный файл правил на месте

Примеры запросов

Эти примеры показывают типы вопросов, для которых предназначена интеграция ИИ.

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
Reacthttps://mobiscroll.com/docs/llms-react-full.txt

Файлы правил

ФайлCursor (.mdc)Copilot (.instructions.md)
Правила Reactmobiscroll-react.mdccopilot-instructions/mobiscroll-react.instructions.md

Расширенные файлы правил

ФайлCursor (.mdc)Copilot (.instructions.md)
Оркестраторmobiscroll-ui.mdccopilot-instructions/mobiscroll-ui.instructions.md
Соглашения Reactmobiscroll-ui-react.mdccopilot-instructions/mobiscroll-ui-react.instructions.md
Темыmobiscroll-ui-theming.mdccopilot-instructions/mobiscroll-ui-theming.instructions.md

Содержимое файлов

Полное содержимое каждого файла приведено ниже. Вы можете скопировать его напрямую из этих блоков или использовать ссылки для скачивания выше.