Mobiscroll MCP

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

Mobiscroll fournit un serveur MCP et des compétences d'agent afin que les assistants de codage génèrent correctement du code pour les planificateurs, les calendriers d'événements, les timelines et les sélecteurs — pour Claude Code, Codex, Cursor et GitHub Copilot, accompagnés d'une documentation lisible par machine et de règles de comportement pour l'IA.

Pourquoi l'intégration IA ?

Les assistants de codage IA fonctionnent mieux lorsqu'ils ont accès à une documentation structurée et faisant autorité. Sans cela, ils ont souvent tendance à :

• Halluciner des API — inventer des noms d'options, des événements ou des types qui n'existent pas
• Mélanger les frameworks — utiliser des imports de modules Angular ou la syntaxe des plugins jQuery au lieu des hooks React et du JSX
• Référencer des versions obsolètes — générer du code v5 alors que la version actuelle est la v6
• Ignorer les conventions des frameworks — omettre les imports nommés depuis @mobiscroll/react ou négliger l'import CSS

L'intégration IA de Mobiscroll répond à ces problèmes en fournissant une documentation optimisée pour la consommation par l'IA, combinée à des règles de comportement qui imposent l'isolation des frameworks et une utilisation correcte des API.

Vue d'ensemble de l'architecture

L'intégration se compose de trois couches :

Couche de données — fichiers llms

Fichiers de documentation lisibles par machine contenant la référence complète de l'API Mobiscroll et des guides, un par framework. Ce sont les sources de vérité que les outils IA lisent pour répondre aux questions.

Fichier	Description
llms-react-full.txt	Documentation React complète
llms-react.txt	Table des matières React (liens vers les pages individuelles)
llms-icons.txt	Noms d'icônes (IcoMoon, Font Awesome, Ionicons) — tous les frameworks

[!-info] -info info

Vous n'avez pas besoin de télécharger ou d'héberger ces fichiers — les fichiers de règles et les plugins Claude Code et Codex les référencent directement et récupèrent leur contenu automatiquement.

Couche de règles — fichiers de règles

Les fichiers de règles fournissent le contexte Mobiscroll à Cursor et GitHub Copilot uniquement. Claude Code et Codex utilisent le plugin Mobiscroll à la place — aucune configuration manuelle de fichiers n'est nécessaire.

Deux approches sont disponibles :

• Option A — chargement du contexte basé sur des fichiers. Un fichier de règles (.mdc pour Cursor, .instructions.md pour Copilot) contient la documentation de l'API et les règles de comportement. Aucun serveur MCP requis.
• Option B — récupération de schéma en direct via le serveur MCP. Des fichiers de règles étendus demandent à l'IA d'appeler le serveur MCP Mobiscroll pour des recherches de schéma de composants en direct à chaque génération. Adapté aux agents de codage interactifs qui ont besoin de précision par requête.

Choisissez en fonction de vos préférences et de votre configuration.

Fichiers

Option A — règles basées sur des fichiers :

Fichier	Format	Pour
mobiscroll-react.mdc	Fichier de règles Cursor	Cursor
copilot-instructions/mobiscroll-react.instructions.md	Fichier d'instructions Copilot	GitHub Copilot

Option B — règles étendues avec MCP :

Fichier	Format	Pour
mobiscroll-ui.mdc	Règle étendue Cursor (orchestrateur)	Cursor
mobiscroll-ui-react.mdc	Règle étendue Cursor (React)	Cursor
mobiscroll-ui-theming.mdc	Règle étendue Cursor (thèmes)	Cursor
mobiscroll-ui.instructions.md	Instruction étendue Copilot (orchestrateur)	GitHub Copilot
mobiscroll-ui-react.instructions.md	Instruction étendue Copilot (React)	GitHub Copilot
mobiscroll-ui-theming.instructions.md	Instruction étendue Copilot (thèmes)	GitHub Copilot

Quel outil utilise quels fichiers ?

Outil	Approche	Fichiers utilisés
Cursor	Option A	mobiscroll-react.mdc
Cursor	Option B	mobiscroll-ui.mdc, mobiscroll-ui-react.mdc, mobiscroll-ui-theming.mdc
GitHub Copilot	Option A	mobiscroll-react.instructions.md
GitHub Copilot	Option B	mobiscroll-ui.instructions.md, mobiscroll-ui-react.instructions.md, mobiscroll-ui-theming.instructions.md

Couche de schéma en direct — serveur MCP

Le serveur MCP Mobiscroll sert des connaissances API structurées et horodatées via le Model Context Protocol. C'est un serveur unique et unifié : le même serveur mobiscroll qui expose ces outils de composants d'interface utilisateur sert également les outils Mobiscroll Connect, préfixés Connect afin qu'ils n'entrent jamais en collision. Au lieu de s'appuyer sur des instantanés de documentation, un assistant peut appeler ces outils pour récupérer le schéma exact du composant, les props/événements valides ou un exemple fonctionnel au moment de la génération — afin de ne jamais halluciner ou s'écarter de l'API actuelle. Voir la référence des outils MCP pour la liste complète de ce qu'il expose.

C'est un serveur HTTP Streamable hébergé à https://mcp.mobiscroll.com/ — aucune installation locale requise. Il est facultatif pour Cursor et GitHub Copilot (utilisé uniquement si vous choisissez l'option B), et inclus/toujours actif pour Claude Code et Codex via le plugin.

Configuration de Cursor

Étape 1 : Enregistrer les sources de documentation

Ouvrez Cursor Settings → Indexing & Docs et ajoutez la source de documentation pour votre framework :

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

N'enregistrez que la source correspondant à votre cas d'utilisation. N'enregistrez pas plusieurs sources — cela empêche la contamination entre domaines.

Étape 2 : Ajouter les règles de comportement

Choisissez une approche — l'option A fonctionne immédiatement sans configuration supplémentaire ; l'option B ajoute des recherches de schéma MCP en direct pour une précision accrue mais nécessite la configuration du serveur MCP.

Option A — fichier de règles .mdc

Téléchargez le fichier mobiscroll-react.mdc et placez-le dans .cursor/rules/ :

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

Le fichier .mdc fournit des règles API basées sur du texte — aucune configuration supplémentaire requise.

Option B — Fichiers de règles étendus + MCP (3 fichiers)

Téléchargez les trois fichiers de règles étendus et placez-les dans .cursor/rules/ :

• mobiscroll-ui.mdc (orchestrateur)
• mobiscroll-ui-react.mdc (conventions React)
• mobiscroll-ui-theming.mdc (thèmes)

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

Contrairement à l'option A, ces fichiers de règles demandent à l'IA de Cursor d'appeler le serveur MCP Mobiscroll pour des recherches de schéma de composants en direct à chaque génération — afin qu'elle travaille à partir de l'API actuelle au lieu de deviner de mémoire. Examinez le code généré avant de le fusionner, comme pour toute sortie IA.

Activation des règles

Les fichiers .mdc étendus utilisent alwaysApply: false avec un description dans leur frontmatter. Cursor lit la description et n'active la règle que lorsque le contexte est pertinent — la règle n'est pas incluse dans chaque message. Vous pouvez également la déclencher manuellement avec @rule-name (par exemple @mobiscroll-ui). Le format .mdc fonctionne dans tous les modes de Cursor, y compris le mode Agent.

Étape 3 : Connecter le serveur MCP

Configurez le serveur MCP Mobiscroll afin que les règles étendues puissent l'appeler pour des recherches de schéma en direct.

Créez ou modifiez .cursor/mcp.json à la racine de votre projet :

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

[!-warning] -warning Pas de champ type

Cursor déduit le type de transport à partir de l'URL. N'ajoutez pas "type": "http" à la configuration de Cursor — cela provoque une erreur.

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

Portée	Fichier de configuration	Partagé avec l'équipe
projet	.cursor/mcp.json à la racine du projet	Oui, si validé
global	~/.cursor/mcp.json	Non, tous vos projets

Vérifiez la connexion : Ouvrez le panneau Output dans Cursor et sélectionnez MCP Logs dans le menu déroulant. Une connexion réussie enregistre les messages de découverte d'outils pour le serveur mobiscroll.

Comment cela fonctionne

Lorsque vous interrogez Cursor à propos de Mobiscroll, incluez @docs pour garantir qu'il lit la documentation enregistrée :

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

@docs What options does the Eventcalendar timeline view accept?

Configuration de GitHub Copilot

Étape 1 : Ajouter les règles de comportement

Choisissez une approche — l'option A fonctionne immédiatement sans configuration supplémentaire ; l'option B ajoute des recherches de schéma MCP en direct pour une précision accrue mais nécessite la configuration du serveur MCP.

Option A — fichier de règles .instructions.md

Téléchargez le fichier mobiscroll-react.instructions.md et placez-le dans .github/instructions/ :

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

Le fichier .instructions.md fournit des règles API basées sur du texte — aucune configuration supplémentaire requise.

Option B — Fichiers d'instructions étendus + MCP (3 fichiers)

Téléchargez les trois fichiers d'instructions étendus et placez-les dans .github/instructions/ :

• mobiscroll-ui.instructions.md (orchestrateur)
• mobiscroll-ui-react.instructions.md (conventions React)
• mobiscroll-ui-theming.instructions.md (thèmes)

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

Étape 2 : Connecter le serveur MCP

Configurez le serveur MCP Mobiscroll afin que les fichiers d'instructions étendus puissent l'appeler pour des recherches de schéma en direct.

Créez ou modifiez .vscode/mcp.json à la racine de votre projet :

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

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

VS Code utilise "servers" comme clé racine — pas "mcpServers" comme Claude Code et Cursor. Utiliser la mauvaise clé casse silencieusement la configuration sans message d'erreur.

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

Portée	Fichier de configuration	Partagé avec l'équipe
espace de travail	.vscode/mcp.json à la racine du projet	Oui, si validé
profil utilisateur	Ouvert via MCP: Open User Configuration	Non, tous vos espaces de travail

Vérifiez la connexion : Ouvrez la Palette de commandes et exécutez MCP: List Servers. Le serveur mobiscroll devrait apparaître avec un statut connecté. Une boîte de dialogue de confiance apparaît lors de la première utilisation — approuvez-la pour permettre au serveur de démarrer.

Alternativement, ouvrez la Palette de commandes et exécutez MCP: Add Server pour une configuration guidée.

Comment cela fonctionne

Les fichiers d'instructions avec applyTo: "**" s'appliquent automatiquement à toutes les requêtes Copilot Chat — aucune référence manuelle nécessaire. Les deux options contiennent :

• URLs de documentation — pointent l'IA vers la documentation correcte du framework
• Mappage des composants — mappent les intentions de l'utilisateur (par exemple, « planificateur ») vers les API Mobiscroll correctes
• Règles — imposent les imports de packages corrects, le chargement CSS et l'utilisation des API
• Contraintes — empêchent le mélange entre frameworks et l'hallucination d'API

Posez directement des questions sur Mobiscroll :

How do I set up a weekly scheduler with Mobiscroll?

What options does the Eventcalendar timeline view accept?

Configuration de Claude Code

Installez le plugin Mobiscroll pour Claude Code. Le plugin regroupe les compétences de codage du framework et le serveur MCP en une seule installation — aucun fichier de configuration par projet n'est nécessaire.

Étape 1 : Enregistrer la place de marché

Exécutez cette commande une fois dans Claude Code pour enregistrer la place de marché du plugin Mobiscroll :

/plugin marketplace add acidb/mobiscroll-marketplace

Étape 2 : Installer le plugin

/plugin install mobiscroll@mobiscroll

[!-warning] -warning Les compétences du plugin ne se mettent pas à jour automatiquement

L'installation du plugin prend un instantané de ses compétences — Claude Code n'en récupérera pas de plus récentes de lui-même, sauf si vous activez la mise à jour automatique pour la place de marché. Pour obtenir les dernières à tout moment, exécutez /plugin marketplace update mobiscroll && /plugin update mobiscroll@mobiscroll, puis /reload-plugins.

Étape 3 : Connecter le serveur MCP

Le plugin regroupe le serveur MCP — aucune configuration séparée n'est nécessaire pour la plupart des configurations. Pour le configurer manuellement ou le partager avec votre équipe :

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

[!-warning] -warning Extension VS Code

Si vous utilisez l'extension Claude Visual Studio Code, le serveur n'apparaîtra pas à moins d'être ajouté avec une portée de projet. Voir la commande suivante ci-dessous.

Pour partager le serveur avec votre équipe automatiquement, utilisez la portée de projet :

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

Cela crée ou met à jour .mcp.json à la racine de votre projet. Vous pouvez également créer ce fichier manuellement :

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

Portée	Indicateur CLI	Emplacement de configuration	Partagé avec l'équipe
local (par défaut)	--scope local	~/.claude.json	Non
projet	--scope project	.mcp.json à la racine du projet	Oui, via le contrôle de version
utilisateur	--scope user	~/.claude.json	Non, tous vos projets

[!-info] -info info

Utilisez --scope project pour les dépôts d'équipe afin que tout le monde reçoive le serveur MCP automatiquement lors du clonage du projet. [!-warning] -warning Aussi connecté depuis le répertoire ?

Si votre organisation a activé le connecteur Mobiscroll depuis le répertoire d'Anthropic, vous disposez peut-être déjà du serveur via votre compte Claude. Une entrée .mcp.json au niveau du projet et le connecteur du répertoire sont deux chemins vers le même serveur, et Claude Code peut signaler l'entrée du projet comme échouant à charger jusqu'à ce que vous autorisiez le connecteur sur votre propre compte. Autorisez-le une fois et les deux fonctionnent, ou supprimez l'entrée .mcp.json et reposez-vous uniquement sur le connecteur. Voir Configuration de l'application Claude ci-dessous.

Vérifier la connexion : Exécutez /mcp dans Claude Code. Le panneau liste chaque serveur connecté et son nombre d'outils. Une connexion saine affiche mobiscroll avec au moins un outil.

Comment cela fonctionne

Une fois installé, le plugin fournit :

• Compétences — mobiscroll-ui est la compétence orchestratrice qui détecte votre framework (React, Angular, Vue, JavaScript ou jQuery) et charge la sous-compétence framework correspondante. Les questions de thème sont gérées par mobiscroll-ui-theming. Toutes les compétences sont installées ensemble.
• Serveur MCP — Le serveur Mobiscroll MCP inclus fournit une recherche de schéma de composants en direct, une validation de code et une recherche d'exemples à la demande, afin que Claude travaille à partir de l'API actuelle au lieu de deviner de mémoire. Examinez le code généré avant de le fusionner, comme pour toute sortie d'IA.

Lorsque vous demandez à Claude Code d'écrire du code Mobiscroll, il :

1. Détecte votre framework et la version Mobiscroll via resolveEnvironment
2. Charge la compétence framework correspondante avec les conventions idiomatiques
3. Recherche le schéma du composant avant d'écrire des props ou des événements
4. Valide le code généré avant de vous le renvoyer

Configuration Codex

Installez le plugin Mobiscroll pour OpenAI Codex. Le plugin regroupe les compétences de codage framework et le serveur MCP en une seule installation — aucun fichier de configuration par projet n'est nécessaire.

Étape 1 : Enregistrer la place de marché

Exécutez cette commande une fois dans Codex pour enregistrer la place de marché du plugin Mobiscroll :

/plugins marketplace add acidb/mobiscroll-marketplace

Étape 2 : Installer le plugin

/plugins install mobiscroll@mobiscroll

[!-warning] -warning Les compétences du plugin ne se mettent pas à jour automatiquement

L'installation du plugin prend un instantané de ses compétences — Codex n'en récupérera pas de plus récentes de lui-même. Pour obtenir les dernières à tout moment, mettez à jour le catalogue de la place de marché et réinstallez le plugin : /plugins marketplace update mobiscroll, puis /plugins install mobiscroll@mobiscroll.

Étape 3 : Connecter le serveur MCP

Le plugin inclut le serveur MCP — aucune configuration séparée n'est nécessaire pour la plupart des configurations. Pour le configurer manuellement ou le partager avec votre équipe, ajoutez-le à ~/.codex/config.toml (global) ou .codex/config.toml (projet) :

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

Vous pouvez également l'enregistrer depuis la ligne de commande :

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

Portée	Emplacement de configuration	Partagé avec l'équipe
global	~/.codex/config.toml	Non, tous vos projets
projet	.codex/config.toml à la racine du projet (projets de confiance uniquement)	Oui, via le contrôle de version

[!-info] -info info

Utilisez le .codex/config.toml au niveau du projet pour les dépôts d'équipe afin que tout le monde reçoive automatiquement le serveur MCP lors du clonage du projet.

Vérifier la connexion : Exécutez /mcp dans Codex. Le panneau liste chaque serveur connecté et son nombre d'outils. Une connexion saine affiche mobiscroll avec ses outils listés.

Comment cela fonctionne

Une fois installé, le plugin fournit :

• Compétences — mobiscroll-ui est la compétence orchestratrice qui détecte votre framework (React, Angular, Vue, JavaScript ou jQuery) et charge la sous-compétence framework correspondante. Les questions de thème sont gérées par mobiscroll-ui-theming. Toutes les compétences sont installées ensemble.
• Serveur MCP — Le serveur Mobiscroll MCP inclus fournit une recherche de schéma de composants en direct, une validation de code et une recherche d'exemples à la demande, afin que Codex travaille à partir de l'API actuelle au lieu de deviner de mémoire. Examinez le code généré avant de le fusionner, comme pour toute sortie d'IA.

Lorsque vous demandez à Codex d'écrire du code Mobiscroll, il :

1. Détecte votre framework et la version Mobiscroll via resolveEnvironment
2. Charge la compétence framework correspondante avec les conventions idiomatiques
3. Recherche le schéma du composant avant d'écrire des props ou des événements
4. Valide le code généré avant de vous le renvoyer

Configuration de l'application Claude — claude.ai, Bureau et mobile

Le serveur MCP est publié dans le répertoire de connecteurs d'Anthropic, donc Claude sur le web, Claude Desktop et les applications mobiles Claude peuvent l'utiliser sans aucun fichier de projet ni commande CLI. C'est le même serveur que celui utilisé par les configurations d'éditeur ci-dessus — la différence réside uniquement dans la façon dont vous y accédez.

Étape 1 : Connecter depuis le répertoire

Ouvrez Paramètres → Connecteurs → Parcourir les connecteurs, recherchez Mobiscroll, et cliquez sur Connecter.

Il n'y a rien à configurer. Le serveur est en lecture seule et ne nécessite ni compte, ni clé API, ni connexion OAuth.

Étape 2 : L'activer pour votre organisation (Team et Enterprise)

Sur les formules Team et Enterprise, un propriétaire ajoute d'abord le connecteur pour l'organisation. Chaque membre le connecte ensuite sur son propre compte — le connecteur est listé pour tout le monde, mais il ne répond pas tant que le membre individuel ne l'a pas connecté.

[!-warning] -warning Déjà ajouté comme connecteur personnalisé ?

Si vous avez ajouté mobiscroll manuellement avant qu'il ne soit dans le répertoire, supprimez cette entrée avant de vous connecter depuis le répertoire. Deux entrées pointant vers https://mcp.mobiscroll.com/ enregistrent les mêmes outils deux fois, et Claude peut appeler la copie à laquelle vous ne vous attendez pas.

Ouvrez Paramètres → Connecteurs, trouvez votre entrée personnalisée mobiscroll, et supprimez-la. Ensuite, connectez-vous depuis le répertoire.

Comment cela fonctionne

Claude appelle les mêmes 14 outils en lecture seule listés dans la référence des outils MCP ci-dessous. Demandez-lui à propos des options d'un composant, d'une signature d'événement, d'un endpoint Connect ou de l'équivalent SDK d'un appel REST, et il lit le schéma actuel au lieu de répondre de mémoire.

Le connecteur du répertoire ne comporte aucune compétence. Celles-ci font partie des plugins Claude Code et Codex — pour écrire du code Mobiscroll dans un projet, utilisez la configuration Claude Code ci-dessus.

Référence des outils MCP

Le serveur MCP expose 14 outils. Tous sont en lecture seule et annotés comme tels, afin qu'un assistant IA puisse les appeler sans demander de confirmation à chaque fois. Aucun d'entre eux ne lit ou n'écrit quoi que ce soit dans votre compte Mobiscroll, et les outils Connect décrivent l'API Connect plutôt que de l'appeler.

Outils Mobiscroll UI

Outil	Ce qu'il retourne	Nécessite
resolveEnvironment	Le framework et la version majeure qu'un projet utilise, lus depuis son package.json. Ce sont les valeurs que les autres outils UI prennent comme arguments.	contenu de package.json
listComponents	Chaque composant disponible pour un framework et une version, avec une courte description et le nombre d'entités.	framework, majeur
getComponentSchema	Options, événements, méthodes et rendus pour un composant. Retourne d'abord un index compact ; appelez à nouveau avec des noms spécifiques pour plus de détails.	composant, framework, majeur
searchExamples	Exemples correspondant à des mots-clés, filtrés par composant et version, triés par pertinence.	framework, majeur
getExampleById	Un exemple complet avec ses fichiers sources, sa description et ses notes d'implémentation.	exampleId, framework, majeur
validateCode	Props, événements et méthodes inconnus dans un extrait, plus l'utilisation obsolète. Analyse statique — rien n'est exécuté.	composant, framework, majeur, extrait

Outils Mobiscroll Connect

Le même serveur répond également aux questions sur l'API REST Connect et ses SDK. Ceux-ci sont documentés en détail dans le guide d'intégration IA Connect.

Outil	Ce qu'il retourne	Nécessite
resolveConnectEnvironment	Le SDK Connect et la version dont un projet dépend, lus depuis son manifeste de dépendances.	contenu du manifeste
listConnectEndpoints	Chaque endpoint REST Connect avec sa méthode, son chemin, son résumé et son authentification.	—
getConnectEndpointSchema	Un endpoint en détail : paramètres avec types, authentification, statuts de réponse, exemples.	endpointId, ou méthode + chemin
listConnectSdkMethods	Les ressources et méthodes exposées par le SDK d'un langage.	langage
getConnectSdkMethod	Une méthode SDK en détail : signature, paramètres, type de retour, commentaire de documentation, exemple.	langage, méthode
searchConnect	Correspondances de mots-clés dans les endpoints REST et les méthodes SDK.	requête
mapConnectEndpointToSdk	L'appel SDK équivalent pour un endpoint REST, dans chaque langage ou un seul.	endpointId, ou méthode + chemin
getConnectErrorTaxonomy	Chaque catégorie d'erreur avec son statut HTTP et le type d'exception idiomatique par langage.	—

[!-success] -success Commencez par un appel de résolution

Le serveur s'exécute à distance et ne peut pas lire vos fichiers, donc resolveEnvironment et resolveConnectEnvironment prennent le contenu de votre manifeste comme argument. Chaque autre outil accepte le framework, la version ou le langage directement si vous les connaissez déjà.

Isolation des frameworks

[!-warning] -warning Critique

Chaque fichier de règles et source de documentation cible exactement un framework ou domaine. Ne combinez jamais des fichiers de frameworks différents, ni ne mélangez des fichiers de framework UI avec des fichiers Connect.

Pourquoi c'est important :

• La plupart des options d'API sont partagées entre les frameworks, mais l'utilisation des composants et le templating diffèrent pour chacun — les mélanger produit un code cassé

Mobiscroll Connect est un domaine séparé :

• Connect est une couche d'intégration backend — OAuth 2.0, API REST, webhooks, synchronisation de calendrier
• Il n'a pas de composants UI, pas de JSX, pas de liaisons de framework frontend
• Connect utilise mobiscroll-connect.mdc et llms-connect-full.txt — jamais les fichiers de framework UI
• Mélanger la documentation Connect avec la documentation UI amène l'IA à confondre les endpoints REST avec les API de composants

[!-info] -info info

Le plugin mobiscroll@mobiscroll inclut également une compétence mobiscroll-connect pour Connect côté serveur (OAuth, REST, synchronisation de calendrier). Elle s'active uniquement pour le travail backend Connect et ne se mélange jamais avec le code de composants UI. Voir le guide d'intégration IA Connect.

Règles :

1. Utilisez uniquement des fichiers de règles qui correspondent à un framework ou domaine — ne mélangez jamais des fichiers de frameworks différents
2. Enregistrez uniquement une source de documentation dans Cursor
3. Si votre projet utilise plusieurs frameworks (par exemple, des micro-frontends), configurez des répertoires séparés avec des fichiers .mdc séparés
4. Si votre projet utilise à la fois un framework UI et Mobiscroll Connect, utilisez des répertoires de contexte IA séparés pour chacun
5. Si un assistant IA génère du code avec des imports de framework incorrects, vérifiez que le fichier de règles correct est en place

Exemples de requêtes

Ces exemples montrent le type de questions que l'intégration IA est conçue pour traiter correctement.

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?

Dépannage

L'IA génère du code avec le mauvais framework

Symptôme : Vous utilisez React mais l'IA génère du code pour un framework différent (par exemple import { Eventcalendar } from '@mobiscroll/angular').

Correctif : Vérifiez que vous avez le fichier de règles correct en place. Pour React dans Cursor, utilisez mobiscroll-react.mdc ; pour Copilot, utilisez mobiscroll-react.instructions.md. Dans Cursor, vérifiez que la source @docs enregistrée pointe vers llms-react-full.txt.

L'IA invente des API inexistantes

Symptôme : L'IA suggère des options, des événements ou des types qui n'existent pas dans la documentation Mobiscroll.

Correctif : Les règles .mdc demandent à l'IA de n'utiliser que les API trouvées dans la documentation. Si cela se reproduit, référencez explicitement @docs dans les requêtes Cursor, ou vérifiez que le plugin Mobiscroll est installé dans Claude Code (/plugin list) ou Codex (codex plugin list). Vous pouvez également demander à l'IA de vérifier qu'une option existe dans la documentation Mobiscroll.

L'IA mélange Mobiscroll Connect avec les composants UI

Symptôme : L'IA génère des appels API REST lorsque vous demandez un composant de calendrier frontend, ou génère du code JSX/composant lorsque vous demandez l'API Connect. Correctif : Mobiscroll Connect est une couche d'intégration backend (OAuth, REST, webhooks) et ne possède aucun composant d'interface utilisateur. Eventcalendar est un composant d'interface utilisateur frontend sans API REST. Ils utilisent des fichiers .mdc et des sources de documentation entièrement séparés. Vérifiez que le fichier .mdc correct est actif pour votre projet. Si vous utilisez les deux dans le même codebase, conservez des répertoires de contexte IA séparés pour chacun.

Le serveur MCP n'apparaît pas après la configuration

Symptôme : Le panneau du serveur MCP n'affiche aucune entrée mobiscroll, ou les outils ne sont pas disponibles.

Correctif : Vérifiez que le fichier de configuration se trouve au bon emplacement et utilise la clé racine correcte — mcpServers pour Claude Code, Codex et Cursor, servers pour VS Code. Validez que le fichier est un JSON bien formé. Pour Claude Code ou Codex, exécutez /mcp pour inspecter les serveurs connectés.

Référence des fichiers

Tous les fichiers d'intégration IA sont disponibles aux URL suivantes :

Fichiers de documentation

Fichier	URL
React	https://mobiscroll.com/docs/llms-react-full.txt

Fichiers de règles

Fichier	Cursor (.mdc)	Copilot (.instructions.md)
Règles React	mobiscroll-react.mdc	copilot-instructions/mobiscroll-react.instructions.md

Fichiers de règles étendus

Fichier	Cursor (.mdc)	Copilot (.instructions.md)
Orchestrateur	mobiscroll-ui.mdc	copilot-instructions/mobiscroll-ui.instructions.md
Conventions React	mobiscroll-ui-react.mdc	copilot-instructions/mobiscroll-ui-react.instructions.md
Thèmes	mobiscroll-ui-theming.mdc	copilot-instructions/mobiscroll-ui-theming.instructions.md

Contenu des fichiers

Le contenu complet de chaque fichier est affiché ci-dessous. Vous pouvez copier directement depuis ces blocs ou utiliser les liens de téléchargement ci-dessus.