Mobiscroll MCP

resmi

Pengetahuan API berstempel versi untuk Mobiscroll UI — scheduler, kalender acara, linimasa, dan picker — plus API kalender Connect. 14 alat hanya-baca.

Apa yang bisa Anda lakukan dengan Mobiscroll MCP?

  • Resolve project environment — Minta asisten untuk mendeteksi framework dan versi Mobiscroll Anda dari package.json melalui resolveEnvironment.
  • List available components — Minta asisten untuk membuat daftar semua komponen Mobiscroll untuk framework dan versi Anda menggunakan listComponents.
  • Fetch component schemas — Dapatkan opsi, event, metode, dan renderer yang tepat untuk komponen apa pun melalui getComponentSchema.
  • Search and retrieve examples — Temukan contoh kode yang relevan berdasarkan kata kunci dengan searchExamples dan ambil sumber lengkap melalui getExampleById.
  • Validate generated code — Periksa cuplikan kode untuk properti, event, atau penggunaan yang tidak dikenal atau tidak digunakan lagi menggunakan validateCode.
  • Map Connect REST to SDK — Temukan metode SDK yang setara untuk setiap endpoint REST Connect dengan mapConnectEndpointToSdk.

Server MCP Terhosting

npx add-mcp 'https://mcp.mobiscroll.com'

Terpasang ke Claude Code, Codex, Cursor, dan lainnya

Dokumentasi

Mobiscroll menyediakan server MCP dan keterampilan agen (agent skills) sehingga asisten pengkodean dapat menghasilkan kode scheduler, kalender acara, timeline, dan picker dengan benar — untuk Claude Code, Codex, Cursor, dan GitHub Copilot, bersama dengan dokumentasi yang dapat dibaca mesin dan aturan perilaku AI.

Mengapa integrasi AI?

Asisten pengkodean AI bekerja paling baik ketika mereka memiliki akses ke dokumentasi terstruktur dan otoritatif. Tanpa itu, mereka sering:

  • Berhalusinasi API — menciptakan nama opsi, event, atau tipe yang tidak ada
  • Mencampur framework — menggunakan impor modul Angular atau sintaks plugin jQuery alih-alih React hooks dan JSX
  • Mereferensikan versi usang — menghasilkan kode v5 padahal versi saat ini adalah v6
  • Mengabaikan konvensi framework — melewatkan impor bernama dari @mobiscroll/react atau menghilangkan impor CSS

Integrasi AI Mobiscroll mengatasi masalah ini dengan menyediakan dokumentasi yang dioptimalkan untuk konsumsi AI, dikombinasikan dengan aturan perilaku yang menegakkan isolasi framework dan penggunaan API yang benar.

Ringkasan arsitektur

Integrasi ini terdiri dari tiga lapisan:

Lapisan data — file llms

File dokumentasi yang dapat dibaca mesin berisi referensi API Mobiscroll lengkap dan panduan, satu per framework. Ini adalah sumber kebenaran yang dibaca oleh alat AI untuk menjawab pertanyaan.

FileDeskripsi
llms-react-full.txtDokumentasi React lengkap
llms-react.txtDaftar isi React (tautan ke halaman individual)
llms-icons.txtNama ikon (IcoMoon, Font Awesome, Ionicons) — semua framework

[!-info] -info info

Anda tidak perlu mengunduh atau menghosting file-file ini — file aturan dan plugin Claude Code serta Codex mereferensikannya secara langsung dan mengambil kontennya secara otomatis.

Lapisan aturan — file aturan

File aturan menyediakan konteks Mobiscroll untuk Cursor dan GitHub Copilot saja. Claude Code dan Codex menggunakan plugin Mobiscroll sebagai gantinya — tidak perlu pengaturan file manual.

Dua pendekatan tersedia:

  • Opsi A — pemuatan konteks berbasis file. File aturan (.mdc untuk Cursor, .instructions.md untuk Copilot) berisi dokumentasi API dan aturan perilaku. Tidak diperlukan server MCP.
  • Opsi B — pengambilan skema langsung melalui server MCP. File aturan yang diperluas menginstruksikan AI untuk memanggil server MCP Mobiscroll untuk pencarian skema komponen langsung pada setiap generasi. Cocok untuk agen pengkodean interaktif yang membutuhkan presisi per-kueri.

Pilih berdasarkan preferensi dan pengaturan Anda.

File

Opsi A — aturan berbasis file:

FileFormatUntuk
mobiscroll-react.mdcFile aturan CursorCursor
copilot-instructions/mobiscroll-react.instructions.mdFile instruksi CopilotGitHub Copilot

Opsi B — aturan diperluas dengan MCP:

FileFormatUntuk
mobiscroll-ui.mdcAturan diperluas Cursor (orchestrator)Cursor
mobiscroll-ui-react.mdcAturan diperluas Cursor (React)Cursor
mobiscroll-ui-theming.mdcAturan diperluas Cursor (theming)Cursor
mobiscroll-ui.instructions.mdInstruksi diperluas Copilot (orchestrator)GitHub Copilot
mobiscroll-ui-react.instructions.mdInstruksi diperluas Copilot (React)GitHub Copilot
mobiscroll-ui-theming.instructions.mdInstruksi diperluas Copilot (theming)GitHub Copilot

Alat mana yang menggunakan file mana?

AlatPendekatanFile yang digunakan
CursorOpsi Amobiscroll-react.mdc
CursorOpsi Bmobiscroll-ui.mdc, mobiscroll-ui-react.mdc, mobiscroll-ui-theming.mdc
GitHub CopilotOpsi Amobiscroll-react.instructions.md
GitHub CopilotOpsi Bmobiscroll-ui.instructions.md, mobiscroll-ui-react.instructions.md, mobiscroll-ui-theming.instructions.md

Lapisan skema langsung — server MCP

Server MCP Mobiscroll menyajikan pengetahuan API terstruktur dengan cap versi melalui Model Context Protocol. Ini adalah server tunggal yang terpadu: server mobiscroll yang sama yang mengekspos alat komponen UI ini juga melayani alat Mobiscroll Connect, dengan awalan Connect sehingga tidak pernah bertabrakan. Alih-alih mengandalkan snapshot dokumentasi, asisten dapat memanggil alat-alat ini untuk mengambil skema komponen yang tepat, props/event yang valid, atau contoh yang berfungsi pada saat generasi — sehingga tidak pernah berhalusinasi atau menyimpang dari API saat ini. Lihat referensi alat MCP untuk daftar lengkap apa yang dieksposnya.

Ini adalah server Streamable HTTP yang dihosting di https://mcp.mobiscroll.com/ — tidak perlu instalasi lokal. Ini opsional untuk Cursor dan GitHub Copilot (hanya digunakan jika Anda memilih Opsi B), dan disertakan/selalu aktif untuk Claude Code dan Codex melalui plugin.

Pengaturan Cursor

Langkah 1: Daftarkan sumber dokumentasi

Buka Cursor Settings → Indexing & Docs dan tambahkan sumber dokumentasi untuk framework Anda:

FrameworkNamaURL
ReactMobiscroll Reacthttps://mobiscroll.com/docs/llms-react-full.txt

Hanya daftarkan sumber yang sesuai dengan kasus penggunaan Anda. Jangan mendaftarkan beberapa sumber — ini mencegah kontaminasi lintas-domain.

Langkah 2: Tambahkan aturan perilaku

Pilih satu pendekatan — Opsi A langsung berfungsi tanpa pengaturan tambahan; Opsi B menambahkan pencarian skema MCP langsung untuk akurasi lebih tinggi tetapi memerlukan server MCP untuk dikonfigurasi.

Opsi A — file aturan .mdc

Unduh file mobiscroll-react.mdc dan letakkan di .cursor/rules/:

your-project/
├── .cursor/
│   └── rules/
│       └── mobiscroll-react.mdc
├── src/
└── package.json

File .mdc menyediakan aturan API berbasis teks — tidak diperlukan pengaturan tambahan.

Opsi B — File aturan diperluas + MCP (3 file)

Unduh tiga file aturan diperluas dan letakkan di .cursor/rules/:

your-project/
├── .cursor/
│   └── rules/
│       ├── mobiscroll-ui.mdc
│       ├── mobiscroll-ui-react.mdc
│       └── mobiscroll-ui-theming.mdc
├── src/
└── package.json

Tidak seperti Opsi A, file aturan ini menginstruksikan AI Cursor untuk memanggil server MCP Mobiscroll untuk pencarian skema komponen langsung pada setiap generasi — sehingga bekerja dari API saat ini alih-alih menebak dari memori. Tinjau kode yang dihasilkan sebelum menggabungkannya, sama seperti keluaran AI lainnya.

Aktivasi aturan

File .mdc yang diperluas menggunakan alwaysApply: false dengan description di frontmatter mereka. Cursor membaca deskripsi dan mengaktifkan aturan hanya ketika konteksnya relevan — aturan tidak disertakan dalam setiap pesan. Anda juga dapat memicunya secara manual dengan @rule-name (mis. @mobiscroll-ui). Format .mdc berfungsi di semua mode Cursor termasuk mode Agen.

Langkah 3: Hubungkan server MCP

Konfigurasikan server MCP Mobiscroll sehingga aturan yang diperluas dapat memanggilnya untuk pencarian skema langsung.

Buat atau edit .cursor/mcp.json di root proyek Anda:

{
  "mcpServers": {
    "mobiscroll": {
      "url": "https://mcp.mobiscroll.com/"
    }
  }
}

[!-warning] -warning Tidak ada bidang type

Cursor menyimpulkan jenis transport dari URL. Jangan tambahkan "type": "http" ke konfigurasi Cursor — ini menyebabkan kesalahan.

your-project/
├── .cursor/
│   ├── mcp.json
│   └── rules/
│       ├── mobiscroll-ui.mdc
│       ├── mobiscroll-ui-react.mdc
│       └── mobiscroll-ui-theming.mdc
├── src/
└── package.json
LingkupFile konfigurasiDibagikan dengan tim
proyek.cursor/mcp.json di root proyekYa, jika di-commit
global~/.cursor/mcp.jsonTidak, semua proyek Anda

Verifikasi koneksi: Buka panel Output di Cursor dan pilih MCP Logs dari dropdown. Koneksi yang berhasil mencatat pesan penemuan alat untuk server mobiscroll.

Cara kerjanya

Saat bertanya kepada Cursor tentang Mobiscroll, sertakan @docs untuk memastikannya membaca dokumentasi yang terdaftar:

@docs How do I set up a weekly scheduler with Mobiscroll?
@docs What options does the Eventcalendar timeline view accept?

Pengaturan GitHub Copilot

Langkah 1: Tambahkan aturan perilaku

Pilih satu pendekatan — Opsi A langsung berfungsi tanpa pengaturan tambahan; Opsi B menambahkan pencarian skema MCP langsung untuk akurasi lebih tinggi tetapi memerlukan server MCP untuk dikonfigurasi.

Opsi A — file aturan .instructions.md

Unduh file mobiscroll-react.instructions.md dan letakkan di .github/instructions/:

your-project/
├── .github/
|   └── instructions/
|       └── mobiscroll-react.instructions.md
├── src/
└── package.json

File .instructions.md menyediakan aturan API berbasis teks — tidak diperlukan pengaturan tambahan.

Opsi B — File instruksi diperluas + MCP (3 file)

Unduh tiga file instruksi diperluas dan letakkan di .github/instructions/:

your-project/
├── .github/
|   └── instructions/
|       ├── mobiscroll-ui.instructions.md
|       ├── mobiscroll-ui-react.instructions.md
|       └── mobiscroll-ui-theming.instructions.md
├── src/
└── package.json

Langkah 2: Hubungkan server MCP

Konfigurasikan server MCP Mobiscroll sehingga file instruksi yang diperluas dapat memanggilnya untuk pencarian skema langsung.

Buat atau edit .vscode/mcp.json di root proyek Anda:

{
  "servers": {
    "mobiscroll": {
      "type": "http",
      "url": "https://mcp.mobiscroll.com/"
    }
  }
}

[!-warning] -warning "servers" bukan "mcpServers"

VS Code menggunakan "servers" sebagai kunci root — bukan "mcpServers" seperti Claude Code dan Cursor. Menggunakan kunci yang salah secara diam-diam merusak konfigurasi tanpa pesan kesalahan.

your-project/
├── .vscode/
│   └── mcp.json
├── .github/
│   └── instructions/
│       ├── mobiscroll-ui.instructions.md
│       ├── mobiscroll-ui-react.instructions.md
│       └── mobiscroll-ui-theming.instructions.md
├── src/
└── package.json
LingkupFile konfigurasiDibagikan dengan tim
workspace.vscode/mcp.json di root proyekYa, jika di-commit
profil penggunaDibuka melalui MCP: Open User ConfigurationTidak, semua workspace Anda

Verifikasi koneksi: Buka Command Palette dan jalankan MCP: List Servers. Server mobiscroll akan muncul dengan status terhubung. Dialog kepercayaan muncul pada penggunaan pertama — setujui untuk mengizinkan server dimulai.

Atau, buka Command Palette dan jalankan MCP: Add Server untuk pengaturan terpandu.

Cara kerjanya

File instruksi dengan applyTo: "**" diterapkan secara otomatis ke semua kueri Copilot Chat — tidak perlu referensi manual. Kedua opsi berisi:

  • URL dokumentasi — mengarahkan AI ke dokumen framework yang benar
  • Pemetaan komponen — memetakan niat pengguna (mis., "scheduler") ke API Mobiscroll yang benar
  • Aturan — menegakkan impor paket yang benar, pemuatan CSS, dan penggunaan API
  • Batasan — mencegah pencampuran lintas-framework dan halusinasi API

Ajukan pertanyaan Mobiscroll secara langsung:

How do I set up a weekly scheduler with Mobiscroll?
What options does the Eventcalendar timeline view accept?

Pengaturan Claude Code

Instal plugin Mobiscroll untuk Claude Code. Plugin ini menggabungkan keterampilan pengkodean framework dan server MCP dalam satu instalasi — tidak perlu file konfigurasi per-proyek.

Langkah 1: Daftarkan marketplace

Jalankan ini sekali di Claude Code untuk mendaftarkan marketplace plugin Mobiscroll:

/plugin marketplace add acidb/mobiscroll-marketplace

Langkah 2: Instal plugin

/plugin install mobiscroll@mobiscroll

[!-warning] -warning Keterampilan plugin tidak diperbarui otomatis

Menginstal plugin mengambil snapshot dari keterampilannya — Claude Code tidak akan menarik yang lebih baru dengan sendirinya kecuali Anda mengaktifkan pembaruan otomatis untuk marketplace. Untuk mendapatkan yang terbaru kapan saja, jalankan /plugin marketplace update mobiscroll && /plugin update mobiscroll@mobiscroll, lalu /reload-plugins.

Langkah 3: Hubungkan server MCP

Plugin menggabungkan server MCP — tidak diperlukan konfigurasi terpisah untuk sebagian besar pengaturan. Untuk mengonfigurasinya secara manual atau membaginya dengan tim Anda:

claude mcp add --transport http mobiscroll https://mcp.mobiscroll.com/

[!-warning] -warning Ekstensi VS Code

Jika Anda menggunakan ekstensi Claude Visual Studio Code, server tidak akan muncul kecuali ditambahkan dengan lingkup proyek. Lihat perintah berikutnya di bawah.

Untuk membagikan server dengan tim Anda secara otomatis, gunakan lingkup proyek:

claude mcp add --transport http --scope project mobiscroll https://mcp.mobiscroll.com/

Ini membuat atau memperbarui .mcp.json di root proyek Anda. Anda juga dapat membuat file itu secara manual:

{
  "mcpServers": {
    "mobiscroll": {
      "type": "http",
      "url": "https://mcp.mobiscroll.com/"
    }
  }
}
LingkupBendera CLILokasi konfigurasiDibagikan dengan tim
lokal (default)--scope local~/.claude.jsonTidak
proyek--scope project.mcp.json di root proyekYa, melalui kontrol versi
pengguna--scope user~/.claude.jsonTidak, semua proyek Anda

[!-info] -info info

Gunakan --scope project untuk repositori tim sehingga semua orang mendapatkan server MCP secara otomatis saat mereka mengkloning proyek. [!-warning] -warning Juga terhubung dari direktori?

Jika organisasi Anda telah mengaktifkan konektor Mobiscroll dari direktori Anthropic, Anda mungkin sudah memiliki server melalui akun Claude Anda. Entri .mcp.json yang terlingkup proyek dan konektor direktori adalah dua rute menuju server yang sama, dan Claude Code dapat melaporkan entri proyek gagal dimuat hingga Anda mengotorisasi konektor pada akun Anda sendiri. Otorisasi sekali dan keduanya berfungsi, atau hapus entri .mcp.json dan andalkan konektor saja. Lihat Pengaturan aplikasi Claude di bawah.

Verifikasi koneksi: Jalankan /mcp di dalam Claude Code. Panel mencantumkan setiap server yang terhubung dan jumlah alatnya. Koneksi yang sehat menunjukkan mobiscroll dengan setidaknya satu alat.

Cara kerjanya

Setelah terinstal, plugin menyediakan:

  • Skills — mobiscroll-ui adalah skill orkestrator yang mendeteksi framework Anda (React, Angular, Vue, JavaScript, atau jQuery) dan memuat sub-skill framework yang sesuai. Pertanyaan tentang tema ditangani oleh mobiscroll-ui-theming. Semua skill terinstal bersamaan.
  • Server MCP — Server Mobiscroll MCP yang disertakan menyediakan pencarian skema komponen langsung, validasi kode, dan pencarian contoh sesuai permintaan, sehingga Claude bekerja dari API saat ini alih-alih menebak dari memori. Tinjau kode yang dihasilkan sebelum menggabungkannya, sama seperti keluaran AI lainnya.

Saat Anda meminta Claude Code untuk menulis kode Mobiscroll, ia akan:

  1. Mendeteksi framework dan versi Mobiscroll Anda melalui resolveEnvironment
  2. Memuat skill framework yang sesuai dengan konvensi idiomatis
  3. Mencari skema komponen sebelum menulis props atau events apa pun
  4. Memvalidasi kode yang dihasilkan sebelum mengembalikannya kepada Anda

Pengaturan Codex

Instal plugin Mobiscroll untuk OpenAI Codex. Plugin ini menggabungkan skill pengkodean framework dan server MCP dalam satu instalasi — tidak perlu file konfigurasi per proyek.

Langkah 1: Daftarkan marketplace

Jalankan ini sekali di Codex untuk mendaftarkan marketplace plugin Mobiscroll:

/plugins marketplace add acidb/mobiscroll-marketplace

Langkah 2: Instal plugin

/plugins install mobiscroll@mobiscroll

[!-warning] -warning Skill plugin tidak diperbarui otomatis

Menginstal plugin mengambil snapshot dari skill-nya — Codex tidak akan menarik yang lebih baru dengan sendirinya. Untuk mendapatkan yang terbaru kapan saja, perbarui katalog marketplace dan instal ulang plugin: /plugins marketplace update mobiscroll, lalu /plugins install mobiscroll@mobiscroll.

Langkah 3: Hubungkan server MCP

Plugin menggabungkan server MCP — tidak diperlukan konfigurasi terpisah untuk sebagian besar pengaturan. Untuk mengonfigurasinya secara manual atau membaginya dengan tim Anda, tambahkan ke ~/.codex/config.toml (global) atau .codex/config.toml (proyek):

[mcp_servers.mobiscroll]
url = "https://mcp.mobiscroll.com/"

Anda juga dapat mendaftarkannya dari baris perintah:

codex mcp add mobiscroll --url https://mcp.mobiscroll.com/
LingkupLokasi konfigurasiDibagikan dengan tim
global~/.codex/config.tomlTidak, semua proyek Anda
proyek.codex/config.toml di root proyek (hanya proyek tepercaya)Ya, melalui kontrol versi

[!-info] -info info

Gunakan .codex/config.toml tingkat proyek untuk repos tim sehingga semua orang mendapatkan server MCP secara otomatis saat mengklon proyek.

Verifikasi koneksi: Jalankan /mcp di dalam Codex. Panel mencantumkan setiap server yang terhubung dan jumlah alatnya. Koneksi yang sehat menunjukkan mobiscroll dengan alat-alatnya tercantum.

Cara kerjanya

Setelah terinstal, plugin menyediakan:

  • Skills — mobiscroll-ui adalah skill orkestrator yang mendeteksi framework Anda (React, Angular, Vue, JavaScript, atau jQuery) dan memuat sub-skill framework yang sesuai. Pertanyaan tentang tema ditangani oleh mobiscroll-ui-theming. Semua skill terinstal bersamaan.
  • Server MCP — Server Mobiscroll MCP yang disertakan menyediakan pencarian skema komponen langsung, validasi kode, dan pencarian contoh sesuai permintaan, sehingga Codex bekerja dari API saat ini alih-alih menebak dari memori. Tinjau kode yang dihasilkan sebelum menggabungkannya, sama seperti keluaran AI lainnya.

Saat Anda meminta Codex untuk menulis kode Mobiscroll, ia akan:

  1. Mendeteksi framework dan versi Mobiscroll Anda melalui resolveEnvironment
  2. Memuat skill framework yang sesuai dengan konvensi idiomatis
  3. Mencari skema komponen sebelum menulis props atau events apa pun
  4. Memvalidasi kode yang dihasilkan sebelum mengembalikannya kepada Anda

Pengaturan aplikasi Claude — claude.ai, Desktop dan seluler

Server MCP diterbitkan di direktori konektor Anthropic, sehingga Claude di web, Claude Desktop, dan aplikasi seluler Claude dapat menggunakannya tanpa file proyek atau perintah CLI. Ini adalah server yang sama dengan pengaturan editor di atas — perbedaannya hanya pada cara Anda menjangkaunya.

Langkah 1: Hubungkan dari direktori

Buka Settings → Connectors → Browse connectors, cari Mobiscroll, dan klik Connect.

Tidak ada yang perlu dikonfigurasi. Server bersifat read-only dan tidak memerlukan akun, kunci API, atau masuk OAuth.

Langkah 2: Aktifkan untuk organisasi Anda (Team dan Enterprise)

Pada paket Team dan Enterprise, seorang Owner menambahkan konektor untuk organisasi terlebih dahulu. Setiap anggota kemudian menghubungkannya di akun mereka sendiri — konektor tercantum untuk semua orang, tetapi tidak merespons hingga anggota individu menghubungkannya.

[!-warning] -warning Sudah menambahkannya sebagai konektor kustom?

Jika Anda menambahkan mobiscroll secara manual sebelum ada di direktori, hapus entri tersebut sebelum menghubungkan dari direktori. Dua entri yang menunjuk ke https://mcp.mobiscroll.com/ mendaftarkan alat yang sama dua kali, dan Claude dapat memanggil salinan yang tidak Anda harapkan.

Buka Settings → Connectors, temukan entri mobiscroll kustom Anda, dan hapus. Lalu hubungkan dari direktori.

Cara kerjanya

Claude memanggil 14 alat read-only yang sama yang tercantum dalam referensi alat MCP di bawah. Tanyakan tentang opsi komponen, tanda tangan event, endpoint Connect, atau padanan SDK dari panggilan REST, dan ia membaca skema saat ini alih-alih menjawab dari memori.

Konektor direktori tidak membawa skill. Itu adalah bagian dari plugin Claude Code dan Codex — untuk menulis kode Mobiscroll di dalam proyek, gunakan Pengaturan Claude Code di atas.

Referensi alat MCP

Server MCP mengekspos 14 alat. Semuanya bersifat read-only dan dianotasi demikian, sehingga asisten AI dapat memanggilnya tanpa meminta konfirmasi setiap kali. Tidak ada yang membaca atau menulis apa pun di akun Mobiscroll Anda, dan alat Connect mendeskripsikan API Connect alih-alih memanggilnya.

Alat UI Mobiscroll

AlatYang dikembalikanMemerlukan
resolveEnvironmentFramework dan versi utama yang digunakan proyek, dibaca dari package.json-nya. Ini adalah nilai yang diterima alat UI lainnya sebagai argumen.Isi package.json
listComponentsSetiap komponen yang tersedia untuk framework dan versi, dengan deskripsi singkat dan jumlah entitas.framework, major
getComponentSchemaOpsi, events, methods, dan renderers untuk satu komponen. Mengembalikan indeks ringkas terlebih dahulu; panggil lagi dengan nama spesifik untuk detail lengkap.component, framework, major
searchExamplesContoh yang cocok dengan kata kunci, difilter berdasarkan komponen dan versi, diurutkan berdasarkan relevansi.framework, major
getExampleByIdContoh lengkap dengan file sumber, deskripsi, dan catatan implementasinya.exampleId, framework, major
validateCodeProps, events, dan methods yang tidak dikenal dalam cuplikan, plus penggunaan yang tidak digunakan lagi. Analisis statis — tidak ada yang dieksekusi.component, framework, major, snippet

Alat Mobiscroll Connect

Server yang sama juga menjawab pertanyaan tentang API REST Connect dan SDK-nya. Ini didokumentasikan secara lengkap dalam Panduan Integrasi AI Connect.

AlatYang dikembalikanMemerlukan
resolveConnectEnvironmentSDK Connect dan versi mana yang menjadi dependensi proyek, dibaca dari manifes dependensinya.Isi manifes
listConnectEndpointsSetiap endpoint REST Connect dengan metode, jalur, ringkasan, dan autentikasinya.—
getConnectEndpointSchemaSatu endpoint secara lengkap: parameter dengan tipe, autentikasi, status respons, contoh.endpointId, atau method + path
listConnectSdkMethodsSumber daya dan metode yang diekspos SDK satu bahasa.language
getConnectSdkMethodSatu metode SDK secara lengkap: tanda tangan, parameter, tipe pengembalian, komentar doc, contoh.language, method
searchConnectKecocokan kata kunci di seluruh endpoint REST dan metode SDK.query
mapConnectEndpointToSdkPanggilan SDK yang setara untuk endpoint REST, dalam setiap bahasa atau satu.endpointId, atau method + path
getConnectErrorTaxonomySetiap kategori kesalahan dengan status HTTP-nya dan tipe pengecualian idiomatis per bahasa.—

[!-success] -success Mulai dengan panggilan resolve

Server berjalan dari jarak jauh dan tidak dapat membaca file Anda, sehingga resolveEnvironment dan resolveConnectEnvironment menerima isi manifes Anda sebagai argumen. Setiap alat lain menerima framework, versi, atau bahasa secara langsung jika Anda sudah mengetahuinya.

Isolasi framework

[!-warning] -warning Kritis

Setiap file aturan dan sumber dokumentasi menargetkan tepat satu framework atau domain. Jangan pernah menggabungkan file dari framework yang berbeda, atau mencampur file framework UI dengan file Connect.

Mengapa ini penting:

  • Sebagian besar opsi API dibagikan di seluruh framework, tetapi penggunaan komponen dan templating berbeda untuk masing-masing — mencampurnya menghasilkan kode yang rusak

Mobiscroll Connect adalah domain terpisah:

  • Connect adalah lapisan integrasi backend — OAuth 2.0, REST API, webhooks, sinkronisasi kalender
  • Tidak memiliki komponen UI, tidak ada JSX, tidak ada binding framework frontend
  • Connect menggunakan mobiscroll-connect.mdc dan llms-connect-full.txt — jangan pernah menggunakan file framework UI
  • Mencampur dokumen Connect dengan dokumen UI menyebabkan AI menggabungkan endpoint REST dengan API komponen

[!-info] -info info

Plugin mobiscroll@mobiscroll juga menggabungkan skill mobiscroll-connect untuk Connect sisi server (OAuth, REST, sinkronisasi kalender). Ini hanya aktif untuk pekerjaan backend Connect dan tidak pernah bercampur dengan kode komponen UI. Lihat Panduan Integrasi AI Connect.

Aturan:

  1. Gunakan hanya file aturan yang cocok dengan satu framework atau domain — jangan pernah mencampur file dari framework yang berbeda
  2. Daftarkan hanya satu sumber dokumentasi di Cursor
  3. Jika proyek Anda menggunakan beberapa framework (mis., micro-frontends), buat direktori terpisah dengan file .mdc terpisah
  4. Jika proyek Anda menggunakan framework UI dan Mobiscroll Connect, gunakan direktori konteks AI terpisah untuk masing-masing
  5. Jika asisten AI menghasilkan kode dengan impor framework yang salah, periksa bahwa file aturan yang benar sudah ada

Contoh kueri

Contoh-contoh ini menunjukkan jenis pertanyaan yang dirancang untuk ditangani dengan benar oleh integrasi 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?

Pemecahan masalah

AI menghasilkan kode dengan framework yang salah

Gejala: Anda menggunakan React tetapi AI menghasilkan kode untuk framework yang berbeda (mis., import { Eventcalendar } from '@mobiscroll/angular').

Perbaikan: Verifikasi bahwa file aturan yang benar sudah ada. Untuk React di Cursor, gunakan mobiscroll-react.mdc; untuk Copilot, gunakan mobiscroll-react.instructions.md. Di Cursor, periksa bahwa sumber @docs yang terdaftar menunjuk ke llms-react-full.txt.

AI menciptakan API yang tidak ada

Gejala: AI menyarankan opsi, events, atau tipe yang tidak ada dalam dokumentasi Mobiscroll.

Perbaikan: Aturan .mdc menginstruksikan AI untuk hanya menggunakan API yang ditemukan di dokumen. Jika ini masih terjadi, secara eksplisit rujuk @docs dalam kueri Cursor, atau verifikasi bahwa plugin Mobiscroll terinstal di Claude Code (/plugin list) atau Codex (codex plugin list). Anda juga dapat meminta AI untuk memverifikasi bahwa suatu opsi ada dalam dokumen Mobiscroll.

AI mencampur Mobiscroll Connect dengan komponen UI

Gejala: AI menghasilkan panggilan API REST saat Anda bertanya tentang komponen kalender frontend, atau menghasilkan kode JSX/komponen saat Anda bertanya tentang API Connect. Perbaikan: Mobiscroll Connect adalah lapisan integrasi backend (OAuth, REST, webhook) dan tidak memiliki komponen UI. Eventcalendar adalah komponen UI frontend tanpa REST API. Keduanya menggunakan file .mdc dan sumber dokumentasi yang sepenuhnya terpisah. Pastikan file .mdc yang benar aktif untuk proyek Anda. Jika Anda menggunakan keduanya dalam basis kode yang sama, simpan direktori konteks AI yang terpisah untuk masing-masing.

Server MCP tidak muncul setelah pengaturan

Gejala: Panel server MCP tidak menampilkan entri mobiscroll, atau alat tidak tersedia.

Perbaikan: Periksa bahwa file konfigurasi berada di lokasi yang benar dan menggunakan kunci root yang tepat — mcpServers untuk Claude Code, Codex, dan Cursor, servers untuk VS Code. Validasi bahwa file tersebut adalah JSON yang terbentuk dengan baik. Untuk Claude Code atau Codex, jalankan /mcp untuk memeriksa server yang terhubung.

Referensi file

Semua file integrasi AI tersedia di URL berikut:

File dokumentasi

FileURL
Reacthttps://mobiscroll.com/docs/llms-react-full.txt

File aturan

FileCursor (.mdc)Copilot (.instructions.md)
Aturan Reactmobiscroll-react.mdccopilot-instructions/mobiscroll-react.instructions.md

File aturan lanjutan

FileCursor (.mdc)Copilot (.instructions.md)
Orkestratormobiscroll-ui.mdccopilot-instructions/mobiscroll-ui.instructions.md
Konvensi Reactmobiscroll-ui-react.mdccopilot-instructions/mobiscroll-ui-react.instructions.md
Temamobiscroll-ui-theming.mdccopilot-instructions/mobiscroll-ui-theming.instructions.md

Isi file

Isi lengkap setiap file ditampilkan di bawah ini. Anda dapat menyalin langsung dari blok-blok ini atau menggunakan tautan unduhan di atas.