Mobiscroll MCP

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

Mobiscroll cung cấp một máy chủ MCP và các kỹ năng tác nhân để các trợ lý lập trình tạo mã lịch biểu, lịch sự kiện, dòng thời gian và bộ chọn một cách chính xác — dành cho Claude Code, Codex, Cursor và GitHub Copilot, cùng với tài liệu có thể đọc bằng máy và các quy tắc hành vi AI.

Tại sao cần tích hợp AI?

Các trợ lý lập trình AI hoạt động tốt nhất khi chúng có quyền truy cập vào tài liệu có cấu trúc và có thẩm quyền. Nếu không có, chúng thường:

• Bịa đặt API — phát minh ra tên tùy chọn, sự kiện hoặc kiểu dữ liệu không tồn tại
• Trộn lẫn framework — sử dụng import module Angular hoặc cú pháp plugin jQuery thay vì React hooks và JSX
• Tham chiếu phiên bản cũ — tạo mã v5 khi phiên bản hiện tại là v6
• Bỏ qua quy ước framework — bỏ qua import có tên từ @mobiscroll/react hoặc bỏ qua import CSS

Tích hợp AI của Mobiscroll giải quyết những vấn đề này bằng cách cung cấp tài liệu được tối ưu hóa cho việc tiêu thụ AI, kết hợp với các quy tắc hành vi thực thi sự cô lập framework và cách sử dụng API chính xác.

Tổng quan kiến trúc

Tích hợp bao gồm ba lớp:

Lớp dữ liệu — tệp llms

Các tệp tài liệu có thể đọc bằng máy chứa toàn bộ tài liệu tham khảo API và hướng dẫn Mobiscroll, một tệp cho mỗi framework. Đây là nguồn sự thật mà các công cụ AI đọc để trả lời câu hỏi.

Tệp	Mô tả
llms-react-full.txt	Tài liệu React hoàn chỉnh
llms-react.txt	Mục lục React (liên kết đến từng trang)
llms-icons.txt	Tên biểu tượng (IcoMoon, Font Awesome, Ionicons) — tất cả framework

[!-info] -info info

Bạn không cần tải xuống hoặc lưu trữ các tệp này — các tệp quy tắc và plugin Claude Code và Codex tham chiếu trực tiếp và tự động tìm nạp nội dung của chúng.

Lớp quy tắc — tệp quy tắc

Các tệp quy tắc cung cấp ngữ cảnh Mobiscroll cho Cursor và GitHub Copilot chỉ. Claude Code và Codex sử dụng plugin Mobiscroll thay thế — không cần thiết lập tệp thủ công.

Có hai cách tiếp cận:

• Tùy chọn A — tải ngữ cảnh dựa trên tệp. Một tệp quy tắc (.mdc cho Cursor, .instructions.md cho Copilot) chứa tài liệu API và quy tắc hành vi. Không cần máy chủ MCP.
• Tùy chọn B — tìm nạp schema trực tiếp qua máy chủ MCP. Các tệp quy tắc mở rộng hướng dẫn AI gọi máy chủ Mobiscroll MCP để tra cứu schema thành phần trực tiếp trong mỗi lần tạo. Phù hợp với các tác nhân lập trình tương tác cần độ chính xác theo từng truy vấn.

Chọn dựa trên sở thích và thiết lập của bạn.

Tệp

Tùy chọn A — quy tắc dựa trên tệp:

Tệp	Định dạng	Dành cho
mobiscroll-react.mdc	Tệp quy tắc Cursor	Cursor
copilot-instructions/mobiscroll-react.instructions.md	Tệp hướng dẫn Copilot	GitHub Copilot

Tùy chọn B — quy tắc mở rộng với MCP:

Tệp	Định dạng	Dành cho
mobiscroll-ui.mdc	Quy tắc mở rộng Cursor (điều phối)	Cursor
mobiscroll-ui-react.mdc	Quy tắc mở rộng Cursor (React)	Cursor
mobiscroll-ui-theming.mdc	Quy tắc mở rộng Cursor (theming)	Cursor
mobiscroll-ui.instructions.md	Hướng dẫn mở rộng Copilot (điều phối)	GitHub Copilot
mobiscroll-ui-react.instructions.md	Hướng dẫn mở rộng Copilot (React)	GitHub Copilot
mobiscroll-ui-theming.instructions.md	Hướng dẫn mở rộng Copilot (theming)	GitHub Copilot

Công cụ nào sử dụng tệp nào?

Công cụ	Cách tiếp cận	Tệp được sử dụng
Cursor	Tùy chọn A	mobiscroll-react.mdc
Cursor	Tùy chọn B	mobiscroll-ui.mdc, mobiscroll-ui-react.mdc, mobiscroll-ui-theming.mdc
GitHub Copilot	Tùy chọn A	mobiscroll-react.instructions.md
GitHub Copilot	Tùy chọn B	mobiscroll-ui.instructions.md, mobiscroll-ui-react.instructions.md, mobiscroll-ui-theming.instructions.md

Lớp schema trực tiếp — máy chủ MCP

Máy chủ Mobiscroll MCP phục vụ kiến thức API có cấu trúc, có đánh dấu phiên bản qua Giao thức Ngữ cảnh Mô hình. Đây là một máy chủ thống nhất duy nhất: cùng một máy chủ mobiscroll hiển thị các công cụ thành phần UI này cũng phục vụ các công cụ Mobiscroll Connect, có tiền tố Connect để chúng không bao giờ xung đột. Thay vì dựa vào ảnh chụp tài liệu, trợ lý có thể gọi các công cụ này để tìm nạp schema thành phần chính xác, props/sự kiện hợp lệ hoặc một ví dụ hoạt động tại thời điểm tạo — để không bao giờ bịa đặt hoặc lệch khỏi API hiện tại. Xem tham khảo công cụ MCP để biết danh sách đầy đủ những gì nó hiển thị.

Đây là một máy chủ HTTP Streamable được lưu trữ tại https://mcp.mobiscroll.com/ — không cần cài đặt cục bộ. Nó là tùy chọn cho Cursor và GitHub Copilot (chỉ được sử dụng nếu bạn chọn Tùy chọn B) và được đóng gói/luôn bật cho Claude Code và Codex qua plugin.

Thiết lập Cursor

Bước 1: Đăng ký nguồn tài liệu

Mở Cursor Settings → Indexing & Docs và thêm nguồn tài liệu cho framework của bạn:

Framework	Tên	URL
React	Mobiscroll React	https://mobiscroll.com/docs/llms-react-full.txt

Chỉ đăng ký nguồn khớp với trường hợp sử dụng của bạn. Không đăng ký nhiều nguồn — điều này ngăn chặn ô nhiễm chéo miền.

Bước 2: Thêm quy tắc hành vi

Chọn một cách tiếp cận — Tùy chọn A hoạt động ngay lập tức mà không cần thiết lập thêm; Tùy chọn B thêm tra cứu schema MCP trực tiếp để có độ chính xác cao hơn nhưng yêu cầu máy chủ MCP phải được cấu hình.

Tùy chọn A — tệp quy tắc .mdc

Tải xuống tệp mobiscroll-react.mdc và đặt nó vào .cursor/rules/:

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

Tệp .mdc cung cấp các quy tắc API dựa trên văn bản — không cần thiết lập thêm.

Tùy chọn B — Tệp quy tắc mở rộng + MCP (3 tệp)

Tải xuống ba tệp quy tắc mở rộng và đặt chúng vào .cursor/rules/:

• mobiscroll-ui.mdc (điều phối)
• mobiscroll-ui-react.mdc (quy ước React)
• mobiscroll-ui-theming.mdc (theming)

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

Không giống như Tùy chọn A, các tệp quy tắc này hướng dẫn AI của Cursor gọi máy chủ Mobiscroll MCP để tra cứu schema thành phần trực tiếp trong mỗi lần tạo — để nó hoạt động từ API hiện tại thay vì đoán từ bộ nhớ. Xem lại mã được tạo trước khi hợp nhất, giống như bất kỳ đầu ra AI nào.

Kích hoạt quy tắc

Các tệp .mdc mở rộng sử dụng alwaysApply: false với description trong frontmatter của chúng. Cursor đọc mô tả và kích hoạt quy tắc chỉ khi ngữ cảnh có liên quan — quy tắc không được bao gồm trong mọi tin nhắn. Bạn cũng có thể kích hoạt thủ công với @rule-name (ví dụ: @mobiscroll-ui). Định dạng .mdc hoạt động trong tất cả các chế độ Cursor bao gồm cả chế độ Agent.

Bước 3: Kết nối máy chủ MCP

Cấu hình máy chủ Mobiscroll MCP để các quy tắc mở rộng có thể gọi nó để tra cứu schema trực tiếp.

Tạo hoặc chỉnh sửa .cursor/mcp.json trong thư mục gốc dự án của bạn:

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

[!-warning] -warning Không có trường type

Cursor suy ra loại truyền tải từ URL. Không thêm "type": "http" vào cấu hình của Cursor — điều này gây ra lỗi.

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

Phạm vi	Tệp cấu hình	Chia sẻ với nhóm
dự án	.cursor/mcp.json trong thư mục gốc dự án	Có, nếu được cam kết
toàn cầu	~/.cursor/mcp.json	Không, tất cả các dự án của bạn

Xác minh kết nối: Mở bảng Output trong Cursor và chọn MCP Logs từ menu thả xuống. Kết nối thành công ghi lại các thông báo khám phá công cụ cho máy chủ mobiscroll.

Cách hoạt động

Khi hỏi Cursor về Mobiscroll, hãy bao gồm @docs để đảm bảo nó đọc tài liệu đã đăng ký:

@docs How do I set up a weekly scheduler with Mobiscroll?

@docs What options does the Eventcalendar timeline view accept?

Thiết lập GitHub Copilot

Bước 1: Thêm quy tắc hành vi

Chọn một cách tiếp cận — Tùy chọn A hoạt động ngay lập tức mà không cần thiết lập thêm; Tùy chọn B thêm tra cứu schema MCP trực tiếp để có độ chính xác cao hơn nhưng yêu cầu máy chủ MCP phải được cấu hình.

Tùy chọn A — tệp quy tắc .instructions.md

Tải xuống tệp mobiscroll-react.instructions.md và đặt nó vào .github/instructions/:

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

Tệp .instructions.md cung cấp các quy tắc API dựa trên văn bản — không cần thiết lập thêm.

Tùy chọn B — Tệp hướng dẫn mở rộng + MCP (3 tệp)

Tải xuống ba tệp hướng dẫn mở rộng và đặt chúng vào .github/instructions/:

• mobiscroll-ui.instructions.md (điều phối)
• mobiscroll-ui-react.instructions.md (quy ước React)
• mobiscroll-ui-theming.instructions.md (theming)

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

Bước 2: Kết nối máy chủ MCP

Cấu hình máy chủ Mobiscroll MCP để các tệp hướng dẫn mở rộng có thể gọi nó để tra cứu schema trực tiếp.

Tạo hoặc chỉnh sửa .vscode/mcp.json trong thư mục gốc dự án của bạn:

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

[!-warning] -warning "servers" không phải "mcpServers"

VS Code sử dụng "servers" làm khóa gốc — không phải "mcpServers" như Claude Code và Cursor. Sử dụng sai khóa sẽ âm thầm phá vỡ cấu hình mà không có thông báo lỗi.

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

Phạm vi	Tệp cấu hình	Chia sẻ với nhóm
không gian làm việc	.vscode/mcp.json trong thư mục gốc dự án	Có, nếu được cam kết
hồ sơ người dùng	Được mở qua MCP: Open User Configuration	Không, tất cả các không gian làm việc của bạn

Xác minh kết nối: Mở Command Palette và chạy MCP: List Servers. Máy chủ mobiscroll sẽ xuất hiện với trạng thái đã kết nối. Hộp thoại tin cậy xuất hiện khi sử dụng lần đầu — hãy phê duyệt để cho phép máy chủ khởi động.

Ngoài ra, mở Command Palette và chạy MCP: Add Server để thiết lập có hướng dẫn.

Cách hoạt động

Các tệp hướng dẫn với applyTo: "**" tự động áp dụng cho tất cả các truy vấn Copilot Chat — không cần tham chiếu thủ công. Cả hai tùy chọn đều chứa:

• URL tài liệu — trỏ AI đến tài liệu framework chính xác
• Ánh xạ thành phần — ánh xạ ý định của người dùng (ví dụ: "lịch biểu") đến các API Mobiscroll chính xác
• Quy tắc — thực thi import gói chính xác, tải CSS và cách sử dụng API
• Ràng buộc — ngăn chặn trộn lẫn framework và bịa đặt API

Hỏi trực tiếp các câu hỏi về Mobiscroll:

How do I set up a weekly scheduler with Mobiscroll?

What options does the Eventcalendar timeline view accept?

Thiết lập Claude Code

Cài đặt plugin Mobiscroll cho Claude Code. Plugin đóng gói các kỹ năng lập trình framework và máy chủ MCP trong một lần cài đặt — không cần tệp cấu hình cho từng dự án.

Bước 1: Đăng ký marketplace

Chạy lệnh này một lần trong Claude Code để đăng ký marketplace plugin Mobiscroll:

/plugin marketplace add acidb/mobiscroll-marketplace

Bước 2: Cài đặt plugin

/plugin install mobiscroll@mobiscroll

[!-warning] -warning Kỹ năng plugin không tự động cập nhật

Cài đặt plugin tạo một ảnh chụp nhanh các kỹ năng của nó — Claude Code sẽ không tự kéo các phiên bản mới hơn trừ khi bạn bật tự động cập nhật cho marketplace. Để có phiên bản mới nhất bất cứ lúc nào, hãy chạy /plugin marketplace update mobiscroll && /plugin update mobiscroll@mobiscroll, sau đó /reload-plugins.

Bước 3: Kết nối máy chủ MCP

Plugin đóng gói máy chủ MCP — không cần cấu hình riêng cho hầu hết các thiết lập. Để cấu hình thủ công hoặc chia sẻ với nhóm của bạn:

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

[!-warning] -warning Tiện ích mở rộng VS Code

Nếu bạn đang sử dụng tiện ích mở rộng Claude Visual Studio Code, máy chủ sẽ không xuất hiện trừ khi nó được thêm với phạm vi dự án. Xem lệnh tiếp theo bên dưới.

Để chia sẻ máy chủ với nhóm của bạn tự động, hãy sử dụng phạm vi dự án:

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

Điều này tạo hoặc cập nhật .mcp.json trong thư mục gốc dự án của bạn. Bạn cũng có thể tạo tệp đó thủ công:

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

Phạm vi	Cờ CLI	Vị trí cấu hình	Chia sẻ với nhóm
cục bộ (mặc định)	--scope local	~/.claude.json	Không
dự án	--scope project	.mcp.json trong thư mục gốc dự án	Có, qua kiểm soát phiên bản
người dùng	--scope user	~/.claude.json	Không, tất cả các dự án của bạn

[!-info] -info info

Sử dụng --scope project cho các kho lưu trữ nhóm để mọi người tự động nhận được máy chủ MCP khi họ sao chép dự án. [!-warning] -warning Cũng kết nối từ thư mục?

Nếu tổ chức của bạn đã bật trình kết nối Mobiscroll từ thư mục của Anthropic, bạn có thể đã có máy chủ thông qua tài khoản Claude của mình. Một mục .mcp.json ở phạm vi dự án và trình kết nối thư mục là hai đường dẫn đến cùng một máy chủ, và Claude Code có thể báo cáo mục dự án không tải được cho đến khi bạn ủy quyền trình kết nối trên tài khoản của chính mình. Ủy quyền một lần và cả hai đều hoạt động, hoặc xóa mục .mcp.json và chỉ dựa vào trình kết nối. Xem Thiết lập ứng dụng Claude bên dưới.

Xác minh kết nối: Chạy /mcp bên trong Claude Code. Bảng điều khiển liệt kê từng máy chủ đã kết nối và số lượng công cụ của nó. Một kết nối khỏe mạnh hiển thị mobiscroll với ít nhất một công cụ.

Cách hoạt động

Sau khi cài đặt, plugin cung cấp:

• Kỹ năng — mobiscroll-ui là kỹ năng điều phối phát hiện framework của bạn (React, Angular, Vue, JavaScript hoặc jQuery) và tải kỹ năng phụ framework tương ứng. Các câu hỏi về chủ đề được xử lý bởi mobiscroll-ui-theming. Tất cả các kỹ năng được cài đặt cùng nhau.
• Máy chủ MCP — Máy chủ Mobiscroll MCP đi kèm cung cấp tra cứu lược đồ thành phần trực tiếp, xác thực mã và tìm kiếm ví dụ theo yêu cầu, để Claude làm việc từ API hiện tại thay vì đoán từ bộ nhớ. Hãy xem lại mã đã tạo trước khi hợp nhất, giống như bất kỳ đầu ra AI nào.

Khi bạn yêu cầu Claude Code viết mã Mobiscroll, nó:

1. Phát hiện framework và phiên bản Mobiscroll của bạn qua resolveEnvironment
2. Tải kỹ năng framework phù hợp với các quy ước thành ngữ
3. Tra cứu lược đồ thành phần trước khi viết bất kỳ props hoặc sự kiện nào
4. Xác thực mã đã tạo trước khi trả lại cho bạn

Thiết lập Codex

Cài đặt plugin Mobiscroll cho OpenAI Codex. Plugin đóng gói các kỹ năng viết mã framework và máy chủ MCP trong một lần cài đặt — không cần tệp cấu hình cho từng dự án.

Bước 1: Đăng ký marketplace

Chạy lệnh này một lần trong Codex để đăng ký marketplace plugin Mobiscroll:

/plugins marketplace add acidb/mobiscroll-marketplace

Bước 2: Cài đặt plugin

/plugins install mobiscroll@mobiscroll

[!-warning] -warning Kỹ năng plugin không tự động cập nhật

Cài đặt plugin sẽ chụp nhanh các kỹ năng của nó — Codex sẽ không tự kéo các phiên bản mới hơn. Để có phiên bản mới nhất bất kỳ lúc nào, hãy cập nhật danh mục marketplace và cài đặt lại plugin: /plugins marketplace update mobiscroll, sau đó /plugins install mobiscroll@mobiscroll.

Bước 3: Kết nối máy chủ MCP

Plugin đóng gói máy chủ MCP — không cần cấu hình riêng cho hầu hết các thiết lập. Để cấu hình thủ công hoặc chia sẻ với nhóm của bạn, hãy thêm nó vào ~/.codex/config.toml (toàn cục) hoặc .codex/config.toml (dự án):

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

Bạn cũng có thể đăng ký nó từ dòng lệnh:

codex mcp add mobiscroll --url https://mcp.mobiscroll.com/

Phạm vi	Vị trí cấu hình	Chia sẻ với nhóm
toàn cục	~/.codex/config.toml	Không, tất cả dự án của bạn
dự án	.codex/config.toml trong thư mục gốc dự án (chỉ các dự án đáng tin cậy)	Có, qua kiểm soát phiên bản

[!-info] -info info

Sử dụng .codex/config.toml ở cấp dự án cho các kho lưu trữ nhóm để mọi người tự động nhận máy chủ MCP khi họ sao chép dự án.

Xác minh kết nối: Chạy /mcp bên trong Codex. Bảng điều khiển liệt kê từng máy chủ đã kết nối và số lượng công cụ của nó. Một kết nối khỏe mạnh hiển thị mobiscroll với các công cụ của nó được liệt kê.

Cách hoạt động

Sau khi cài đặt, plugin cung cấp:

• Kỹ năng — mobiscroll-ui là kỹ năng điều phối phát hiện framework của bạn (React, Angular, Vue, JavaScript hoặc jQuery) và tải kỹ năng phụ framework tương ứng. Các câu hỏi về chủ đề được xử lý bởi mobiscroll-ui-theming. Tất cả các kỹ năng được cài đặt cùng nhau.
• Máy chủ MCP — Máy chủ Mobiscroll MCP đi kèm cung cấp tra cứu lược đồ thành phần trực tiếp, xác thực mã và tìm kiếm ví dụ theo yêu cầu, để Codex làm việc từ API hiện tại thay vì đoán từ bộ nhớ. Hãy xem lại mã đã tạo trước khi hợp nhất, giống như bất kỳ đầu ra AI nào.

Khi bạn yêu cầu Codex viết mã Mobiscroll, nó:

1. Phát hiện framework và phiên bản Mobiscroll của bạn qua resolveEnvironment
2. Tải kỹ năng framework phù hợp với các quy ước thành ngữ
3. Tra cứu lược đồ thành phần trước khi viết bất kỳ props hoặc sự kiện nào
4. Xác thực mã đã tạo trước khi trả lại cho bạn

Thiết lập ứng dụng Claude — claude.ai, Desktop và di động

Máy chủ MCP được xuất bản trong thư mục trình kết nối của Anthropic, vì vậy Claude trên web, Claude Desktop và các ứng dụng di động Claude có thể sử dụng nó mà không cần bất kỳ tệp dự án hoặc lệnh CLI nào. Đây là cùng một máy chủ mà các thiết lập trình soạn thảo ở trên sử dụng — sự khác biệt chỉ là cách bạn truy cập nó.

Bước 1: Kết nối từ thư mục

Mở Cài đặt → Trình kết nối → Duyệt trình kết nối, tìm kiếm Mobiscroll, và nhấp Kết nối.

Không có gì để cấu hình. Máy chủ chỉ đọc và không cần tài khoản, khóa API hoặc đăng nhập OAuth.

Bước 2: Bật nó cho tổ chức của bạn (Team và Enterprise)

Trên các gói Team và Enterprise, Chủ sở hữu thêm trình kết nối cho tổ chức trước. Sau đó, mỗi thành viên kết nối nó trên tài khoản của riêng họ — trình kết nối được liệt kê cho mọi người, nhưng nó không trả lời cho đến khi thành viên cá nhân đã kết nối nó.

[!-warning] -warning Đã thêm nó như một trình kết nối tùy chỉnh?

Nếu bạn đã thêm mobiscroll bằng tay trước khi nó có trong thư mục, hãy xóa mục đó trước khi kết nối từ thư mục. Hai mục trỏ đến https://mcp.mobiscroll.com/ đăng ký cùng một công cụ hai lần, và Claude có thể gọi bản sao mà bạn không mong đợi.

Mở Cài đặt → Trình kết nối, tìm mục mobiscroll tùy chỉnh của bạn, và xóa nó. Sau đó kết nối từ thư mục.

Cách hoạt động

Claude gọi cùng 14 công cụ chỉ đọc được liệt kê trong tham chiếu công cụ MCP bên dưới. Hỏi nó về các tùy chọn của một thành phần, chữ ký sự kiện, điểm cuối Connect hoặc tương đương SDK của một lệnh gọi REST, và nó đọc lược đồ hiện tại thay vì trả lời từ bộ nhớ.

Trình kết nối thư mục không mang kỹ năng. Những kỹ năng đó là một phần của plugin Claude Code và Codex — để viết mã Mobiscroll bên trong một dự án, hãy sử dụng Thiết lập Claude Code ở trên.

Tham chiếu công cụ MCP

Máy chủ MCP hiển thị 14 công cụ. Tất cả đều chỉ đọc và được chú thích như vậy, để trợ lý AI có thể gọi chúng mà không cần xác nhận mỗi lần. Không công cụ nào đọc hoặc ghi bất cứ thứ gì trong tài khoản Mobiscroll của bạn, và các công cụ Connect mô tả API Connect thay vì gọi nó.

Công cụ Mobiscroll UI

Công cụ	Nội dung trả về	Yêu cầu
resolveEnvironment	Framework và phiên bản chính mà một dự án sử dụng, đọc từ package.json của nó. Đây là các giá trị mà các công cụ UI khác nhận làm đối số.	nội dung package.json
listComponents	Mọi thành phần có sẵn cho một framework và phiên bản, với mô tả ngắn và số lượng thực thể.	framework, major
getComponentSchema	Các tùy chọn, sự kiện, phương thức và trình kết xuất cho một thành phần. Trả về một chỉ mục gọn trước; gọi lại với tên cụ thể để biết chi tiết đầy đủ.	component, framework, major
searchExamples	Các ví dụ khớp từ khóa, được lọc theo thành phần và phiên bản, sắp xếp theo mức độ liên quan.	framework, major
getExampleById	Một ví dụ hoàn chỉnh với các tệp nguồn, mô tả và ghi chú triển khai của nó.	exampleId, framework, major
validateCode	Các props, sự kiện và phương thức không xác định trong một đoạn mã, cộng với cách sử dụng không được dùng nữa. Phân tích tĩnh — không có gì được thực thi.	component, framework, major, snippet

Công cụ Mobiscroll Connect

Cùng một máy chủ cũng trả lời các câu hỏi về API REST Connect và các SDK của nó. Chúng được ghi chép đầy đủ trong hướng dẫn Tích hợp AI Connect.

Công cụ	Nội dung trả về	Yêu cầu
resolveConnectEnvironment	SDK Connect và phiên bản mà một dự án phụ thuộc, đọc từ tệp kê khai phụ thuộc của nó.	nội dung tệp kê khai
listConnectEndpoints	Mọi điểm cuối REST Connect với phương thức, đường dẫn, tóm tắt và xác thực của nó.	—
getConnectEndpointSchema	Một điểm cuối đầy đủ: tham số với kiểu, xác thực, trạng thái phản hồi, ví dụ.	endpointId, hoặc method + path
listConnectSdkMethods	Các tài nguyên và phương thức mà SDK của một ngôn ngữ hiển thị.	language
getConnectSdkMethod	Một phương thức SDK đầy đủ: chữ ký, tham số, kiểu trả về, chú thích tài liệu, ví dụ.	language, method
searchConnect	Các khớp từ khóa trên các điểm cuối REST và phương thức SDK.	query
mapConnectEndpointToSdk	Lệnh gọi SDK tương đương cho một điểm cuối REST, trong mỗi ngôn ngữ hoặc một ngôn ngữ.	endpointId, hoặc method + path
getConnectErrorTaxonomy	Mỗi danh mục lỗi với trạng thái HTTP của nó và loại ngoại lệ thành ngữ theo ngôn ngữ.	—

[!-success] -success Bắt đầu bằng một lệnh gọi resolve

Máy chủ chạy từ xa và không thể đọc tệp của bạn, vì vậy resolveEnvironment và resolveConnectEnvironment nhận nội dung tệp kê khai của bạn làm đối số. Mọi công cụ khác chấp nhận framework, phiên bản hoặc ngôn ngữ trực tiếp nếu bạn đã biết chúng.

Cách ly framework

[!-warning] -warning Quan trọng

Mỗi tệp quy tắc và nguồn tài liệu nhắm chính xác một framework hoặc miền. Không bao giờ kết hợp các tệp từ các framework khác nhau, hoặc trộn các tệp framework UI với các tệp Connect.

Tại sao điều này quan trọng:

• Hầu hết các tùy chọn API được chia sẻ giữa các framework, nhưng cách sử dụng thành phần và tạo mẫu khác nhau cho mỗi framework — trộn chúng tạo ra mã hỏng

Mobiscroll Connect là một miền riêng biệt:

• Connect là một lớp tích hợp backend — OAuth 2.0, API REST, webhook, đồng bộ lịch
• Nó không có thành phần UI, không có JSX, không có ràng buộc framework frontend
• Connect sử dụng mobiscroll-connect.mdc và llms-connect-full.txt — không bao giờ dùng các tệp framework UI
• Trộn tài liệu Connect với tài liệu UI khiến AI nhầm lẫn các điểm cuối REST với API thành phần

[!-info] -info info

Plugin mobiscroll@mobiscroll cũng đóng gói một kỹ năng mobiscroll-connect cho Connect phía máy chủ (OAuth, REST, đồng bộ lịch). Nó chỉ kích hoạt cho công việc Connect backend và không bao giờ trộn với mã thành phần UI. Xem hướng dẫn Tích hợp AI Connect.

Quy tắc:

1. Chỉ sử dụng các tệp quy tắc khớp một framework hoặc miền — không bao giờ trộn các tệp từ các framework khác nhau
2. Chỉ đăng ký một nguồn tài liệu trong Cursor
3. Nếu dự án của bạn sử dụng nhiều framework (ví dụ: micro-frontends), hãy thiết lập các thư mục riêng biệt với các tệp .mdc riêng biệt
4. Nếu dự án của bạn sử dụng cả framework UI và Mobiscroll Connect, hãy sử dụng các thư mục ngữ cảnh AI riêng biệt cho mỗi loại
5. Nếu trợ lý AI tạo mã với import framework sai, hãy kiểm tra rằng tệp quy tắc chính xác đã được đặt đúng chỗ

Truy vấn ví dụ

Các ví dụ này cho thấy loại câu hỏi mà tích hợp AI được thiết kế để xử lý chính xác.

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?

Khắc phục sự cố

AI tạo mã với framework sai

Triệu chứng: Bạn đang sử dụng React nhưng AI tạo mã cho một framework khác (ví dụ: import { Eventcalendar } from '@mobiscroll/angular').

Khắc phục: Xác minh rằng bạn có tệp quy tắc chính xác. Đối với React trong Cursor, sử dụng mobiscroll-react.mdc; cho Copilot, sử dụng mobiscroll-react.instructions.md. Trong Cursor, kiểm tra rằng nguồn @docs đã đăng ký trỏ đến llms-react-full.txt.

AI bịa ra các API không tồn tại

Triệu chứng: AI đề xuất các tùy chọn, sự kiện hoặc kiểu không tồn tại trong tài liệu Mobiscroll.

Khắc phục: Các quy tắc .mdc hướng dẫn AI chỉ sử dụng các API có trong tài liệu. Nếu điều này vẫn xảy ra, hãy tham chiếu rõ ràng @docs trong các truy vấn Cursor, hoặc xác minh rằng plugin Mobiscroll đã được cài đặt trong Claude Code (/plugin list) hoặc Codex (codex plugin list). Bạn cũng có thể yêu cầu AI xác minh một tùy chọn tồn tại trong tài liệu Mobiscroll.

AI trộn Mobiscroll Connect với các thành phần UI

Triệu chứng: AI tạo các lệnh gọi API REST khi bạn hỏi về một thành phần lịch frontend, hoặc tạo mã JSX/thành phần khi bạn hỏi về API Connect. Khắc phục: Mobiscroll Connect là một lớp tích hợp backend (OAuth, REST, webhooks) và không có thành phần giao diện người dùng. Eventcalendar là một thành phần giao diện người dùng frontend không có REST API. Chúng sử dụng các tệp .mdc và nguồn tài liệu hoàn toàn riêng biệt. Hãy xác minh rằng tệp .mdc chính xác đang hoạt động cho dự án của bạn. Nếu bạn sử dụng cả hai trong cùng một codebase, hãy giữ các thư mục ngữ cảnh AI riêng biệt cho từng loại.

Máy chủ MCP không xuất hiện sau khi thiết lập

Triệu chứng: Bảng điều khiển máy chủ MCP không hiển thị mục mobiscroll nào, hoặc các công cụ không khả dụng.

Khắc phục: Kiểm tra rằng tệp cấu hình nằm ở vị trí chính xác và sử dụng khóa gốc chính xác — mcpServers cho Claude Code, Codex và Cursor, servers cho VS Code. Xác thực rằng tệp là JSON hợp lệ. Đối với Claude Code hoặc Codex, chạy /mcp để kiểm tra các máy chủ đã kết nối.

Tham chiếu tệp

Tất cả các tệp tích hợp AI đều có sẵn tại các URL sau:

Tệp tài liệu

Tệp	URL
React	https://mobiscroll.com/docs/llms-react-full.txt

Tệp quy tắc

Tệp	Cursor (.mdc)	Copilot (.instructions.md)
Quy tắc React	mobiscroll-react.mdc	copilot-instructions/mobiscroll-react.instructions.md

Tệp quy tắc mở rộng

Tệp	Cursor (.mdc)	Copilot (.instructions.md)
Điều phối viên	mobiscroll-ui.mdc	copilot-instructions/mobiscroll-ui.instructions.md
Quy ước React	mobiscroll-ui-react.mdc	copilot-instructions/mobiscroll-ui-react.instructions.md
Theming	mobiscroll-ui-theming.mdc	copilot-instructions/mobiscroll-ui-theming.instructions.md

Nội dung tệp

Nội dung đầy đủ của từng tệp được hiển thị bên dưới. Bạn có thể sao chép trực tiếp từ các khối này hoặc sử dụng các liên kết tải xuống ở trên.