Mobiscroll MCP
官方帶版本標記的 Mobiscroll UI API 知識——包括排程器、事件日曆、時間軸和選擇器——以及 Connect 日曆 API。共 14 個唯讀工具。
你可以用 Mobiscroll MCP 做什麼?
- 解析專案環境 — 請助理從
package.json中透過resolveEnvironment偵測您的框架與 Mobiscroll 版本。 - 列出可用元件 — 請助理使用
listComponents列舉適用於您框架與版本的所有 Mobiscroll 元件。 - 取得元件結構描述 — 透過
getComponentSchema取得任何元件的精確選項、事件、方法與渲染器。 - 搜尋與擷取範例 — 使用
searchExamples依關鍵字尋找相關程式碼範例,並透過getExampleById取得完整原始碼。 - 驗證產生的程式碼 — 使用
validateCode檢查程式碼片段是否有未知屬性、事件或已棄用的用法。 - 將 Connect REST 對應至 SDK — 使用
mapConnectEndpointToSdk尋找任何 Connect REST 端點對應的 SDK 方法。
託管 MCP 伺服器
npx add-mcp 'https://mcp.mobiscroll.com'可安裝到 Claude Code、Codex、Cursor 等客戶端
文件
Mobiscroll 提供 MCP 伺服器與代理技能,讓程式碼輔助工具能正確產生排程器、事件日曆、時間軸與選擇器程式碼——適用於 Claude Code、Codex、Cursor 與 GitHub Copilot,並附帶機器可讀的文件與 AI 行為規則。
為什麼需要 AI 整合?
AI 程式碼輔助工具在取得結構化、具權威性的文件時表現最佳。若缺乏這些文件,它們經常會:
- 幻覺 API——發明不存在的選項名稱、事件或型別
- 混用框架——使用 Angular 模組匯入或 jQuery 外掛語法,而非 React hooks 與 JSX
- 引用過時版本——在目前版本為 v6 時產生 v5 程式碼
- 忽略框架慣例——跳過從
@mobiscroll/react的具名匯入,或遺漏 CSS 匯入
Mobiscroll AI 整合透過提供專為 AI 消費最佳化的文件,結合強制框架隔離與正確 API 使用的行為規則,來解決這些問題。
架構總覽
此整合由三層組成:
資料層——llms 檔案
機器可讀的文件檔案,包含完整的 Mobiscroll API 參考與指南,每個框架一份。這些是 AI 工具讀取以回答問題的真相來源。
| 檔案 | 說明 |
|---|---|
llms-react-full.txt | 完整的 React 文件 |
llms-react.txt | React 目錄(連結至個別頁面) |
llms-icons.txt | 圖示名稱(IcoMoon、Font Awesome、Ionicons)——所有框架 |
[!-info] -info info
您不需要下載或託管這些檔案——規則檔案與 Claude Code 和 Codex 外掛會直接引用它們並自動擷取其內容。
規則層——規則檔案
規則檔案僅為 Cursor 與 GitHub Copilot 提供 Mobiscroll 上下文。Claude Code 與 Codex 改用 Mobiscroll 外掛——無需手動設定檔案。
提供兩種方式:
- 選項 A——基於檔案的上下文載入。規則檔案(Cursor 用
.mdc,Copilot 用.instructions.md)包含 API 文件與行為規則。不需要 MCP 伺服器。 - 選項 B——透過 MCP 伺服器即時擷取 schema。擴充規則檔案指示 AI 在每次產生時呼叫 Mobiscroll MCP 伺服器以取得即時元件 schema。適合需要每次查詢精確度的互動式程式碼代理。
根據您的偏好與設定選擇。
檔案
選項 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 |
即時 schema 層——MCP 伺服器
Mobiscroll MCP 伺服器透過 Model Context Protocol 提供結構化、帶版本戳記的 API 知識。它是一個單一、統一的伺服器:同一個暴露這些 UI 元件工具的 mobiscroll 伺服器,也提供 Mobiscroll Connect 工具,並加上 Connect 前綴以免衝突。與其依賴文件快照,助理可以在產生時呼叫這些工具來取得確切的元件 schema、有效的 props/事件或可運作的範例——因此永遠不會幻覺或偏離目前的 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 schema 查詢以提高準確度,但需要設定 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 的 AI 在每次產生時呼叫 Mobiscroll MCP 伺服器以取得即時元件 schema——因此它從目前的 API 運作,而非憑記憶猜測。合併前請審查產生的程式碼,與任何 AI 輸出相同。
規則啟用
擴充的 .mdc 檔案使用 alwaysApply: false,並在其 frontmatter 中包含 description。Cursor 讀取描述,並僅在上下文相關時啟用規則——規則不會包含在每則訊息中。您也可以使用 @rule-name 手動觸發(例如 @mobiscroll-ui)。.mdc 格式適用於所有 Cursor 模式,包括 Agent 模式。
步驟 3:連接 MCP 伺服器
設定 Mobiscroll MCP 伺服器,以便擴充規則可以呼叫它進行即時 schema 查詢。
在您的專案根目錄建立或編輯 .cursor/mcp.json:
{
"mcpServers": {
"mobiscroll": {
"url": "https://mcp.mobiscroll.com/"
}
}
}
[!-warning] -warning 沒有
type欄位Cursor 從 URL 推斷傳輸類型。不要在 Cursor 的設定中新增
"type": "http"——它會導致錯誤。
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 | 否,所有您的專案 |
驗證連線: 開啟 Cursor 中的 Output 面板,並從下拉選單選擇 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 schema 查詢以提高準確度,但需要設定 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 伺服器
設定 Mobiscroll MCP 伺服器,以便擴充指令檔案可以呼叫它進行即時 schema 查詢。
在您的專案根目錄建立或編輯 .vscode/mcp.json:
{
"servers": {
"mobiscroll": {
"type": "http",
"url": "https://mcp.mobiscroll.com/"
}
}
}
[!-warning] -warning
"servers"而非"mcpServers"VS Code 使用
"servers"作為根金鑰——而非像 Claude Code 與 Cursor 那樣的"mcpServers"。使用錯誤的金鑰會靜默破壞設定,且不會出現錯誤訊息。
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——將 AI 指向正確的框架文件
- 元件對應——將使用者意圖(例如「scheduler」)對應至正確的 Mobiscroll API
- 規則——強制正確的套件匯入、CSS 載入與 API 使用
- 限制——防止跨框架混用與 API 幻覺
直接詢問 Mobiscroll 問題:
How do I set up a weekly scheduler with Mobiscroll?
What options does the Eventcalendar timeline view accept?
Claude Code 設定
為 Claude Code 安裝 Mobiscroll 外掛。此外掛將框架編碼技能與 MCP 伺服器綑綁在單一安裝中——無需每個專案的設定檔。
步驟 1:註冊 marketplace
在 Claude Code 中執行一次此指令以註冊 Mobiscroll 外掛 marketplace:
/plugin marketplace add acidb/mobiscroll-marketplace
步驟 2:安裝外掛
/plugin install mobiscroll@mobiscroll
[!-warning] -warning 外掛技能不會自動更新
安裝外掛會取得其技能的快照——Claude Code 不會自行拉取較新的技能,除非您為 marketplace 啟用自動更新。若要隨時取得最新版本,請執行
/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 也從目錄連接了嗎?如果您的組織已從 Anthropic 的目錄啟用 Mobiscroll 連接器,您可能已經透過 Claude 帳戶取得伺服器。專案範圍的
.mcp.json條目和目錄連接器是通往同一伺服器的兩條路徑,而 Claude Code 可能會回報專案條目無法載入,直到您在個人帳戶授權連接器為止。授權一次後兩者皆可運作,或移除.mcp.json條目並僅依賴連接器。請參閱下方的 Claude 應用程式設定。
驗證連線: 在 Claude Code 中執行 /mcp。面板會列出每個已連接的伺服器及其工具數量。健康的連線會顯示 mobiscroll 且至少有一個工具。
運作方式
安裝後,外掛程式提供:
- 技能 —
mobiscroll-ui是編排技能,會偵測您的框架(React、Angular、Vue、JavaScript 或 jQuery)並載入相符的框架子技能。主題相關問題由mobiscroll-ui-theming處理。所有技能會一起安裝。 - MCP 伺服器 — 隨附的 Mobiscroll MCP 伺服器提供即時元件結構描述查詢、程式碼驗證和範例搜尋,讓 Claude 依據目前 API 運作,而非憑記憶猜測。合併前請審查產生的程式碼,與任何 AI 輸出相同。
當您要求 Claude Code 撰寫 Mobiscroll 程式碼時,它會:
- 透過
resolveEnvironment偵測您的框架和 Mobiscroll 版本 - 載入符合慣用慣例的相符框架技能
- 在撰寫任何 props 或事件前查詢元件結構描述
- 在回傳給您之前驗證產生的程式碼
Codex 設定
為 OpenAI Codex 安裝 Mobiscroll 外掛程式。此外掛程式將框架編碼技能和 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 伺服器。
驗證連線: 在 Codex 中執行 /mcp。面板會列出每個已連接的伺服器及其工具數量。健康的連線會顯示 mobiscroll 及其列出的工具。
運作方式
安裝後,外掛程式提供:
- 技能 —
mobiscroll-ui是編排技能,會偵測您的框架(React、Angular、Vue、JavaScript 或 jQuery)並載入相符的框架子技能。主題相關問題由mobiscroll-ui-theming處理。所有技能會一起安裝。 - MCP 伺服器 — 隨附的 Mobiscroll MCP 伺服器提供即時元件結構描述查詢、程式碼驗證和範例搜尋,讓 Codex 依據目前 API 運作,而非憑記憶猜測。合併前請審查產生的程式碼,與任何 AI 輸出相同。
當您要求 Codex 撰寫 Mobiscroll 程式碼時,它會:
- 透過
resolveEnvironment偵測您的框架和 Mobiscroll 版本 - 載入符合慣用慣例的相符框架技能
- 在撰寫任何 props 或事件前查詢元件結構描述
- 在回傳給您之前驗證產生的程式碼
Claude 應用程式設定 — claude.ai、桌面版和行動版
MCP 伺服器已發布在 Anthropic 的連接器目錄中,因此網頁版 Claude、Claude Desktop 和 Claude 行動應用程式無需任何專案檔案或 CLI 命令即可使用。它與上述編輯器設定使用的是同一伺服器 — 差異僅在於存取方式。
步驟 1:從目錄連接
開啟 設定 → 連接器 → 瀏覽連接器,搜尋 Mobiscroll,然後按一下 連接。
無需設定任何項目。此伺服器為唯讀,不需要帳戶、API 金鑰或 OAuth 登入。
步驟 2:為您的組織啟用(Team 和 Enterprise)
在 Team 和 Enterprise 方案中,Owner 會先為組織新增連接器。然後每個成員在個人帳戶連接它 — 連接器會列給所有人,但在個別成員連接之前不會回應。
[!-warning] -warning 已將其新增為自訂連接器?
如果您在目錄中出現之前手動新增了
mobiscroll,請在從目錄連接之前移除該條目。指向https://mcp.mobiscroll.com/的兩個條目會重複註冊相同的工具兩次,而 Claude 可能會呼叫您未預期的副本。開啟 設定 → 連接器,找到您的自訂
mobiscroll條目並移除。然後從目錄連接。
運作方式
Claude 會呼叫下方 MCP 工具參考 中列出的相同 14 個唯讀工具。詢問元件選項、事件簽名、Connect 端點或 REST 呼叫的 SDK 對應項目時,它會讀取目前結構描述而非憑記憶回答。
目錄連接器不攜帶技能。這些技能屬於 Claude Code 和 Codex 外掛程式 — 若要在專案內撰寫 Mobiscroll 程式碼,請使用上方的 Claude Code 設定。
MCP 工具參考
MCP 伺服器公開 14 個工具。所有工具皆為唯讀並如此標註,因此 AI 助理可以呼叫它們而無需每次要求確認。它們都不會讀取或寫入您 Mobiscroll 帳戶中的任何內容,Connect 工具描述 Connect API 而非呼叫它。
Mobiscroll UI 工具
| 工具 | 回傳內容 | 必要參數 |
|---|---|---|
resolveEnvironment | 專案使用的框架和主要版本,從其 package.json 讀取。這些是其他 UI 工具接受的參數值。 | package.json 內容 |
listComponents | 特定框架和版本可用的每個元件,附簡短描述和實體數量。 | framework、major |
getComponentSchema | 單一元件的選項、事件、方法和 renderers。先回傳精簡索引;再次呼叫並指定名稱以取得完整詳細資料。 | component、framework、major |
searchExamples | 符合關鍵字的範例,依元件和版本篩選,按相關性排序。 | framework、major |
getExampleById | 完整範例及其原始檔、描述和實作說明。 | exampleId、framework、major |
validateCode | 程式碼片段中未知的 props、事件和方法,以及已棄用的用法。靜態分析 — 不會執行任何內容。 | component、framework、major、snippet |
Mobiscroll Connect 工具
同一伺服器也回答關於 Connect REST API 及其 SDK 的問題。這些在 Connect AI 整合指南 中有完整文件。
| 工具 | 回傳內容 | 必要參數 |
|---|---|---|
resolveConnectEnvironment | 專案依賴的 Connect SDK 和版本,從其依賴清單讀取。 | 清單內容 |
listConnectEndpoints | 每個 Connect REST 端點及其方法、路徑、摘要和驗證。 | — |
getConnectEndpointSchema | 單一端點的完整詳細資料:含型別的參數、驗證、回應狀態、範例。 | endpointId,或 method + path |
listConnectSdkMethods | 特定語言 SDK 公開的資源和方法。 | language |
getConnectSdkMethod | 單一 SDK 方法的完整詳細資料:簽名、參數、回傳型別、文件註解、範例。 | language、method |
searchConnect | REST 端點和 SDK 方法中的關鍵字比對。 | query |
mapConnectEndpointToSdk | REST 端點的對應 SDK 呼叫,以每種語言或單一語言呈現。 | endpointId,或 method + path |
getConnectErrorTaxonomy | 每個錯誤類別及其 HTTP 狀態和每種語言的慣用例外型別。 | — |
[!-success] -success 從 resolve 呼叫開始
伺服器遠端執行且無法讀取您的檔案,因此
resolveEnvironment和resolveConnectEnvironment接受您的清單內容作為參數。如果您已知框架、版本或語言,其他每個工具都可直接接受這些值。
框架隔離
[!-warning] -warning 重要
每個規則檔案和文件來源僅針對一個框架或領域。絕不混合不同框架的檔案,或將 UI 框架檔案與 Connect 檔案混合。
為何重要:
- 大多數 API 選項在框架間共用,但每個框架的元件使用方式和範本不同 — 混合會產生損壞的程式碼
Mobiscroll Connect 是獨立領域:
- Connect 是後端整合層 — OAuth 2.0、REST API、webhooks、日曆同步
- 它沒有 UI 元件、沒有 JSX、沒有前端框架綁定
- Connect 使用
mobiscroll-connect.mdc和llms-connect-full.txt— 絕不使用 UI 框架檔案 - 混合 Connect 文件與 UI 文件會導致 AI 將 REST 端點與元件 API 混淆
[!-info] -info info
mobiscroll@mobiscroll外掛程式也捆綁了mobiscroll-connect技能,用於伺服器端 Connect(OAuth、REST、日曆同步)。它僅在後端 Connect 工作時啟動,絕不與 UI 元件程式碼混合。請參閱 Connect AI 整合指南。
規則:
- 僅使用符合一個框架或領域的規則檔案 — 絕不混合不同框架的檔案
- 在 Cursor 中僅註冊一個文件來源
- 如果您的專案使用多個框架(例如微前端),請設定具有個別
.mdc檔案的獨立目錄 - 如果您的專案同時使用 UI 框架和 Mobiscroll Connect,請為每個使用獨立的 AI 內容目錄
- 如果 AI 助理產生具有錯誤框架匯入的程式碼,請檢查正確的規則檔案是否就位
範例查詢
這些範例顯示 AI 整合設計用於正確處理的問題類型。
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?
疑難排解
AI 產生錯誤框架的程式碼
症狀: 您使用 React,但 AI 為不同框架產生程式碼(例如 import { Eventcalendar } from '@mobiscroll/angular')。
修正: 確認正確的規則檔案已就位。在 Cursor 中使用 React 時,請使用 mobiscroll-react.mdc;在 Copilot 中,請使用 mobiscroll-react.instructions.md。在 Cursor 中,檢查已註冊的 @docs 來源指向 llms-react-full.txt。
AI 發明不存在的 API
症狀: AI 建議 Mobiscroll 文件中不存在的選項、事件或型別。
修正: .mdc 規則指示 AI 僅使用文件中找到的 API。如果仍發生此情況,請在 Cursor 查詢中明確引用 @docs,或確認 Mobiscroll 外掛程式已安裝在 Claude Code(/plugin list)或 Codex(codex plugin list)中。您也可以要求 AI 驗證選項是否存在於 Mobiscroll 文件中。
AI 混合 Mobiscroll Connect 與 UI 元件
症狀: 當您詢問前端日曆元件時,AI 產生 REST API 呼叫,或當您詢問 Connect API 時,AI 產生 JSX/元件程式碼。
修正: Mobiscroll Connect 是後端整合層(OAuth、REST、Webhook),沒有 UI 元件。Eventcalendar 是前端 UI 元件,沒有 REST API。兩者使用完全不同的 .mdc 檔案與文件來源。請確認專案啟用的是正確的 .mdc 檔案。若在同一程式碼庫中同時使用兩者,請為各自保留獨立的 AI 上下文目錄。
設定後 MCP 伺服器未出現
症狀: MCP 伺服器面板未顯示 mobiscroll 條目,或工具無法使用。
修正: 檢查設定檔是否位於正確位置,並使用正確的根鍵——Claude Code、Codex 與 Cursor 使用 mcpServers,VS Code 使用 servers。驗證檔案是否為格式正確的 JSON。若使用 Claude Code 或 Codex,請執行 /mcp 以檢查已連線的伺服器。
檔案參考
所有 AI 整合檔案均可於下列網址取得:
文件檔案
| 檔案 | 網址 |
|---|---|
| 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) |
|---|---|---|
| Orchestrator | 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 |
檔案內容
以下顯示每個檔案的完整內容。您可以直接從這些區塊複製,或使用上方下載連結。