Mobiscroll MCP
公式バージョン管理されたMobiscroll UIのAPI知識 — スケジューラー、イベントカレンダー、タイムライン、ピッカー — に加え、ConnectカレンダーAPI。読み取り専用ツール14個。
Mobiscroll MCPで何ができますか？
- プロジェクト環境の解決 — アシスタントに
package.jsonからフレームワークとMobiscrollバージョンをresolveEnvironmentで検出させます。 - 利用可能なコンポーネントの一覧表示 — アシスタントに、フレームワークとバージョンに対応するすべてのMobiscrollコンポーネントを
listComponentsで列挙させます。 - コンポーネントスキーマの取得 —
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の幻覚 — 存在しないオプション名、イベント、型をでっち上げる
- フレームワークの混在 — ReactフックやJSXの代わりにAngularモジュールのインポートやjQueryプラグイン構文を使用する
- 古いバージョンの参照 — 現在のバージョンがv6であるのにv5のコードを生成する
- フレームワークの規約を無視 —
@mobiscroll/reactからの名前付きインポートを省略したり、CSSインポートを省略する
MobiscrollのAI統合は、AI消費向けに最適化されたドキュメントと、フレームワークの分離と正しいAPI使用を強制する動作ルールを組み合わせることで、これらの問題に対処します。
アーキテクチャ概要
この統合は3つのレイヤーで構成されています：
データレイヤー — llmsファイル
完全なMobiscroll APIリファレンスとガイドを含む機械可読なドキュメントファイルで、フレームワークごとに1つずつあります。これらは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プラグインを使用するため、手動でのファイル設定は不要です。
2つのアプローチが利用可能です：
- オプションA — ファイルベースのコンテキスト読み込み。ルールファイル（Cursor用は
.mdc、Copilot用は.instructions.md）にAPIドキュメントと動作ルールが含まれています。MCPサーバーは不要です。 - オプションB — MCPサーバーによるライブスキーマ取得。拡張ルールファイルは、AIに各生成時にMobiscroll MCPサーバーを呼び出してライブのコンポーネントスキーマを参照するよう指示します。クエリごとの精度が必要な対話型コーディングエージェントに適しています。
好みとセットアップに応じて選択してください。
ファイル
オプション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サーバー
Mobiscroll MCPサーバーは、Model Context Protocolを介して構造化されたバージョン付きのAPI知識を提供します。これは単一の統合サーバーです：これらのUIコンポーネントツールを公開する同じmobiscrollサーバーが、Connectプレフィックスが付いたMobiscroll Connectツールも提供するため、衝突することはありません。ドキュメントのスナップショットに依存する代わりに、アシスタントはこれらのツールを呼び出して、生成時に正確なコンポーネントスキーマ、有効なprops/イベント、または動作例を取得できます — これにより、幻覚や現在のAPIからの逸脱が発生しません。公開される全ツールのリストについては、MCPツールリファレンスを参照してください。
これはhttps://mcp.mobiscroll.com/にあるホスト型Streamable HTTPサーバーで、ローカルインストールは不要です。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ファイル）
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サーバーを呼び出してライブのコンポーネントスキーマを参照するよう指示します — メモリからの推測ではなく現在のAPIから動作します。他のAI出力と同様に、マージ前に生成されたコードをレビューしてください。
ルールのアクティベーション
拡張.mdcファイルは、フロントマターにdescriptionを含むalwaysApply: falseを使用します。Cursorは説明を読み取り、コンテキストが関連する場合にのみルールをアクティベートします — ルールはすべてのメッセージに含まれるわけではありません。@rule-nameで手動でトリガーすることもできます（例：@mobiscroll-ui）。.mdc形式は、Agentモードを含むすべてのCursorモードで機能します。
ステップ3: MCPサーバーの接続
拡張ルールがライブスキーマ参照のために呼び出せるよう、Mobiscroll MCPサーバーを設定します。
プロジェクトルートに.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スキーマ参照を追加しますが、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ファイル）
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サーバーを設定します。
プロジェクトルートに.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を正しいフレームワークのドキュメントに誘導
- コンポーネントマッピング — ユーザーの意図（例：「スケジューラー」）を正しい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: マーケットプレイスの登録
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] 警告 ディレクトリからも接続していますか？組織がAnthropicのディレクトリからMobiscrollコネクタを有効にしている場合、Claudeアカウントを通じてサーバーをすでに利用できる可能性があります。プロジェクトスコープの
.mcp.jsonエントリとディレクトリコネクタは、同じサーバーへの2つの経路です。Claude Codeは、自分のアカウントでコネクタを承認するまで、プロジェクトエントリが読み込みに失敗したと報告することがあります。一度承認すれば両方が機能します。または、.mcp.jsonエントリを削除して、コネクタのみに依存することもできます。下記のClaudeアプリのセットアップを参照してください。
接続を確認する: Claude Code内で/mcpを実行します。パネルには接続された各サーバーとそのツール数が表示されます。正常な接続では、mobiscrollが少なくとも1つのツールとともに表示されます。
仕組み
インストールすると、プラグインは以下を提供します:
- スキル —
mobiscroll-uiはオーケストレータースキルで、フレームワーク（React、Angular、Vue、JavaScript、jQuery）を検出し、対応するフレームワークサブスキルを読み込みます。テーマに関する質問はmobiscroll-ui-themingが処理します。すべてのスキルは一緒にインストールされます。 - MCPサーバー — バンドルされたMobiscroll MCPサーバーは、ライブのコンポーネントスキーマ検索、コード検証、オンデマンドの例検索を提供するため、Claudeは記憶から推測するのではなく、現在のAPIに基づいて動作します。生成されたコードは、他のAI出力と同様に、マージする前にレビューしてください。
Claude CodeにMobiscrollコードの作成を依頼すると、以下の手順が実行されます:
resolveEnvironmentを介してフレームワークとMobiscrollバージョンを検出します- 慣用的な規約に沿った、対応するフレームワークスキルを読み込みます
- プロパティやイベントを記述する前にコンポーネントスキーマを検索します
- 生成されたコードを返す前に検証します
Codexのセットアップ
OpenAI Codex用のMobiscrollプラグインをインストールします。プラグインには、フレームワークコーディングスキルとMCPサーバーが単一のインストールにバンドルされています。プロジェクトごとの設定ファイルは不要です。
ステップ1: マーケットプレイスを登録する
Codexでこれを一度実行して、Mobiscrollプラグインマーケットプレイスを登録します:
/plugins marketplace add acidb/mobiscroll-marketplace
ステップ2: プラグインをインストールする
/plugins install mobiscroll@mobiscroll
[!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] 情報
チームリポジトリにはプロジェクトレベルの
.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バージョンを検出します- 慣用的な規約に沿った、対応するフレームワークスキルを読み込みます
- プロパティやイベントを記述する前にコンポーネントスキーマを検索します
- 生成されたコードを返す前に検証します
Claudeアプリのセットアップ — claude.ai、デスクトップ、モバイル
MCPサーバーはAnthropicのコネクタディレクトリに公開されているため、Web上のClaude、Claude Desktop、Claudeモバイルアプリは、プロジェクトファイルやCLIコマンドなしで使用できます。これは上記のエディタセットアップと同じサーバーです。違いはアクセス方法だけです。
ステップ1: ディレクトリから接続する
設定 → コネクタ → コネクタを参照を開き、Mobiscrollを検索して接続をクリックします。
設定するものはありません。サーバーは読み取り専用で、アカウント、APIキー、OAuthサインインは不要です。
ステップ2: 組織で有効にする（TeamおよびEnterprise）
TeamおよびEnterpriseプランでは、所有者が最初に組織のコネクタを追加します。その後、各メンバーが自分のアカウントで接続します。コネクタは全員に表示されますが、個々のメンバーが接続するまで応答しません。
[!warning] 警告 すでにカスタムコネクタとして追加していませんか？
ディレクトリに登録される前に
mobiscrollを手動で追加した場合は、ディレクトリから接続する前にそのエントリを削除してください。https://mcp.mobiscroll.com/を指す2つのエントリがあると、同じツールが2回登録され、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 | 1つのコンポーネントのオプション、イベント、メソッド、レンダラー。最初にコンパクトなインデックスを返します。詳細は特定の名前を指定して再度呼び出します。 | component、framework、major |
searchExamples | キーワードに一致する例。コンポーネントとバージョンでフィルタリングされ、関連性順にソートされます。 | framework、major |
getExampleById | ソースファイル、説明、実装ノートを含む完全な例。 | exampleId、framework、major |
validateCode | スニペット内の不明なプロパティ、イベント、メソッド、および非推奨の使用法。静的解析のみで、何も実行されません。 | component、framework、major、snippet |
Mobiscroll Connectツール
同じサーバーがConnect REST APIとそのSDKに関する質問にも回答します。これらはConnect AI統合ガイドで完全に文書化されています。
| ツール | 戻り値 | 必要なもの |
|---|---|---|
resolveConnectEnvironment | プロジェクトが依存するConnect SDKとバージョン。依存関係マニフェストから読み取ります。 | マニフェストの内容 |
listConnectEndpoints | すべてのConnect RESTエンドポイント。メソッド、パス、概要、認証付き。 | — |
getConnectEndpointSchema | 1つのエンドポイントの完全な詳細: 型付きパラメータ、認証、レスポンスステータス、例。 | endpointId、またはmethod + path |
listConnectSdkMethods | 1つの言語のSDKが公開するリソースとメソッド。 | language |
getConnectSdkMethod | 1つのSDKメソッドの完全な詳細: シグネチャ、パラメータ、戻り値の型、ドキュメントコメント、例。 | language、method |
searchConnect | RESTエンドポイントとSDKメソッド全体でのキーワード一致。 | query |
mapConnectEndpointToSdk | RESTエンドポイントに対応するSDK呼び出し。各言語または1つの言語で。 | endpointId、またはmethod + path |
getConnectErrorTaxonomy | 各エラーカテゴリとそのHTTPステータス、および言語ごとの慣用的な例外タイプ。 | — |
[!success] 成功 resolve呼び出しから始める
サーバーはリモートで実行され、ファイルを読み取ることができないため、
resolveEnvironmentとresolveConnectEnvironmentはマニフェストの内容を引数として受け取ります。他のすべてのツールは、すでにフレームワーク、バージョン、または言語がわかっている場合は直接受け取ります。
フレームワークの分離
[!warning] 警告 重要
各ルールファイルとドキュメントソースは、正確に1つのフレームワークまたはドメインを対象としています。異なるフレームワークのファイルを組み合わせたり、UIフレームワークファイルとConnectファイルを混在させたりしないでください。
これが重要な理由:
- ほとんどのAPIオプションはフレームワーク間で共有されていますが、コンポーネントの使用法とテンプレーティングはそれぞれ異なります。混在させると壊れたコードが生成されます
Mobiscroll Connectは別のドメインです:
- Connectはバックエンド統合レイヤーです — OAuth 2.0、REST API、ウェブフック、カレンダー同期
- UIコンポーネント、JSX、フロントエンドフレームワークバインディングはありません
- Connectは
mobiscroll-connect.mdcとllms-connect-full.txtを使用します — UIフレームワークファイルは絶対に使用しません - ConnectドキュメントとUIドキュメントを混在させると、AIがRESTエンドポイントとコンポーネントAPIを混同します
[!info] 情報
mobiscroll@mobiscrollプラグインには、サーバーサイドConnect（OAuth、REST、カレンダー同期）用のmobiscroll-connectスキルもバンドルされています。これはバックエンドのConnect作業でのみ有効になり、UIコンポーネントコードと混在することはありません。Connect AI統合ガイドを参照してください。
ルール:
- 1つのフレームワークまたはドメインに一致するルールファイルのみを使用します — 異なるフレームワークのファイルを混在させないでください
- Cursorに登録するドキュメントソースは1つだけにします
- プロジェクトが複数のフレームワークを使用している場合（例: マイクロフロントエンド）、個別の
.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を明示的に参照するか、Claude Code（/plugin list）またはCodex（codex plugin list）にMobiscrollプラグインがインストールされていることを確認します。AIにMobiscrollドキュメントでオプションが存在するか確認させることもできます。
AIがMobiscroll ConnectとUIコンポーネントを混在させる
症状: フロントエンドのカレンダーコンポーネントについて質問したのにAIがREST API呼び出しを生成する、またはConnect APIについて質問したのにJSX/コンポーネントコードを生成します。
修正: Mobiscroll Connectはバックエンド統合レイヤー（OAuth、REST、webhooks）であり、UIコンポーネントはありません。EventcalendarはREST APIを持たないフロントエンドUIコンポーネントです。これらは完全に別々の.mdcファイルとドキュメントソースを使用しています。プロジェクトに正しい.mdcファイルがアクティブであることを確認してください。同じコードベースで両方を使用する場合は、それぞれに別々のAIコンテキストディレクトリを保持してください。
セットアップ後にMCPサーバーが表示されない
症状: MCPサーバーパネルにmobiscrollエントリが表示されない、またはツールが利用できない。
修正: 設定ファイルが正しい場所にあり、正しいルートキーを使用していることを確認してください — Claude Code、Codex、Cursorの場合はmcpServers、VS Codeの場合はservers。ファイルが整形式のJSONであることを検証してください。Claude CodeまたはCodexの場合は、/mcpを実行して接続されているサーバーを確認してください。
ファイルリファレンス
すべてのAI統合ファイルは以下の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 |
ファイル内容
各ファイルの完全な内容を以下に示します。これらのブロックから直接コピーするか、上記のダウンロードリンクを使用できます。