Mobiscroll MCP

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

Mobiscroll inclui um servidor MCP e habilidades de agente para que assistentes de codificação gerem código correto de agendador, calendário de eventos, linha do tempo e seletor — para Claude Code, Codex, Cursor e GitHub Copilot, juntamente com documentação legível por máquina e regras de comportamento de IA.

Por que integração com IA?

Assistentes de codificação com IA funcionam melhor quando têm acesso a documentação estruturada e autoritativa. Sem ela, eles frequentemente:

• Alucinam APIs — inventam nomes de opções, eventos ou tipos que não existem
• Misturam frameworks — usam imports de módulos Angular ou sintaxe de plugin jQuery em vez de hooks React e JSX
• Referenciam versões desatualizadas — geram código v5 quando a versão atual é v6
• Ignoram convenções de framework — pulam imports nomeados de @mobiscroll/react ou omitem o import de CSS

A integração de IA da Mobiscroll resolve esses problemas fornecendo documentação otimizada para consumo por IA, combinada com regras de comportamento que garantem isolamento de framework e uso correto da API.

Visão geral da arquitetura

A integração consiste em três camadas:

Camada de dados — arquivos llms

Arquivos de documentação legíveis por máquina contendo a referência completa da API Mobiscroll e guias, um por framework. Eles são a fonte de verdade que as ferramentas de IA leem para responder perguntas.

Arquivo	Descrição
llms-react-full.txt	Documentação completa do React
llms-react.txt	Sumário do React (links para páginas individuais)
llms-icons.txt	Nomes de ícones (IcoMoon, Font Awesome, Ionicons) — todos os frameworks

[!-info] -info info

Você não precisa baixar ou hospedar esses arquivos — os arquivos de regras e os plugins do Claude Code e Codex os referenciam diretamente e buscam seu conteúdo automaticamente.

Camada de regras — arquivos de regras

Os arquivos de regras fornecem contexto da Mobiscroll apenas para Cursor e GitHub Copilot. Claude Code e Codex usam o plugin Mobiscroll — sem necessidade de configuração manual de arquivos.

Duas abordagens estão disponíveis:

• Opção A — carregamento de contexto baseado em arquivos. Um arquivo de regras (.mdc para Cursor, .instructions.md para Copilot) contém documentação da API e regras de comportamento. Nenhum servidor MCP necessário.
• Opção B — busca de esquema ao vivo via servidor MCP. Arquivos de regras estendidos instruem a IA a chamar o servidor Mobiscroll MCP para consultas de esquema de componentes ao vivo em cada geração. Adequado para agentes de codificação interativos que precisam de precisão por consulta.

Escolha com base na sua preferência e configuração.

Arquivos

Opção A — regras baseadas em arquivos:

Arquivo	Formato	Para
mobiscroll-react.mdc	Arquivo de regras do Cursor	Cursor
copilot-instructions/mobiscroll-react.instructions.md	Arquivo de instruções do Copilot	GitHub Copilot

Opção B — regras estendidas com MCP:

Arquivo	Formato	Para
mobiscroll-ui.mdc	Regra estendida do Cursor (orquestrador)	Cursor
mobiscroll-ui-react.mdc	Regra estendida do Cursor (React)	Cursor
mobiscroll-ui-theming.mdc	Regra estendida do Cursor (temas)	Cursor
mobiscroll-ui.instructions.md	Instrução estendida do Copilot (orquestrador)	GitHub Copilot
mobiscroll-ui-react.instructions.md	Instrução estendida do Copilot (React)	GitHub Copilot
mobiscroll-ui-theming.instructions.md	Instrução estendida do Copilot (temas)	GitHub Copilot

Qual ferramenta usa quais arquivos?

Ferramenta	Abordagem	Arquivos usados
Cursor	Opção A	mobiscroll-react.mdc
Cursor	Opção B	mobiscroll-ui.mdc, mobiscroll-ui-react.mdc, mobiscroll-ui-theming.mdc
GitHub Copilot	Opção A	mobiscroll-react.instructions.md
GitHub Copilot	Opção B	mobiscroll-ui.instructions.md, mobiscroll-ui-react.instructions.md, mobiscroll-ui-theming.instructions.md

Camada de esquema ao vivo — servidor MCP

O servidor Mobiscroll MCP fornece conhecimento de API estruturado e com versão carimbada através do Model Context Protocol. É um servidor único e unificado: o mesmo servidor mobiscroll que expõe essas ferramentas de componentes de UI também serve as ferramentas Mobiscroll Connect, prefixadas com Connect para que nunca colidam. Em vez de depender de instantâneos de documentação, um assistente pode chamar essas ferramentas para buscar o esquema exato do componente, props/eventos válidos ou um exemplo funcional no momento da geração — para que nunca alucine ou se desvie da API atual. Veja a referência de ferramentas MCP para a lista completa do que ele expõe.

É um servidor HTTP Streamable hospedado em https://mcp.mobiscroll.com/ — sem necessidade de instalação local. É opcional para Cursor e GitHub Copilot (usado apenas se você escolher a Opção B), e incluído/sempre ativo para Claude Code e Codex via plugin.

Configuração do Cursor

Passo 1: Registrar fontes de documentação

Abra Cursor Settings → Indexing & Docs e adicione a fonte de documentação para o seu framework:

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

Registre apenas a fonte correspondente ao seu caso de uso. Não registre múltiplas fontes — isso evita contaminação entre domínios.

Passo 2: Adicionar regras de comportamento

Escolha uma abordagem — a Opção A funciona imediatamente sem configuração adicional; a Opção B adiciona consultas de esquema MCP ao vivo para maior precisão, mas requer que o servidor MCP esteja configurado.

Opção A — arquivo de regras .mdc

Baixe o arquivo mobiscroll-react.mdc e coloque-o em .cursor/rules/:

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

O arquivo .mdc fornece regras de API baseadas em texto — sem configuração adicional necessária.

Opção B — Arquivos de regras estendidos + MCP (3 arquivos)

Baixe os três arquivos de regras estendidos e coloque-os em .cursor/rules/:

• mobiscroll-ui.mdc (orquestrador)
• mobiscroll-ui-react.mdc (convenções React)
• mobiscroll-ui-theming.mdc (temas)

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

Ao contrário da Opção A, esses arquivos de regras instruem a IA do Cursor a chamar o servidor Mobiscroll MCP para consultas de esquema de componentes ao vivo em cada geração — para que funcione com a API atual em vez de adivinhar pela memória. Revise o código gerado antes de mesclá-lo, da mesma forma que faria com qualquer saída de IA.

Ativação de regras

Os arquivos .mdc estendidos usam alwaysApply: false com um description em seu frontmatter. O Cursor lê a descrição e ativa a regra apenas quando o contexto é relevante — a regra não é incluída em todas as mensagens. Você também pode acioná-la manualmente com @rule-name (ex.: @mobiscroll-ui). O formato .mdc funciona em todos os modos do Cursor, incluindo o modo Agente.

Passo 3: Conectar o servidor MCP

Configure o servidor Mobiscroll MCP para que as regras estendidas possam chamá-lo para consultas de esquema ao vivo.

Crie ou edite .cursor/mcp.json na raiz do seu projeto:

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

[!-warning] -warning Sem campo type

O Cursor infere o tipo de transporte a partir da URL. Não adicione "type": "http" à configuração do Cursor — isso causa um erro.

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

Escopo	Arquivo de configuração	Compartilhado com a equipe
projeto	.cursor/mcp.json na raiz do projeto	Sim, se versionado
global	~/.cursor/mcp.json	Não, todos os seus projetos

Verifique a conexão: Abra o painel Output no Cursor e selecione MCP Logs no menu suspenso. Uma conexão bem-sucedida registra mensagens de descoberta de ferramentas para o servidor mobiscroll.

Como funciona

Ao perguntar ao Cursor sobre Mobiscroll, inclua @docs para garantir que ele leia a documentação registrada:

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

@docs What options does the Eventcalendar timeline view accept?

Configuração do GitHub Copilot

Passo 1: Adicionar regras de comportamento

Escolha uma abordagem — a Opção A funciona imediatamente sem configuração adicional; a Opção B adiciona consultas de esquema MCP ao vivo para maior precisão, mas requer que o servidor MCP esteja configurado.

Opção A — arquivo de regras .instructions.md

Baixe o arquivo mobiscroll-react.instructions.md e coloque-o em .github/instructions/:

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

O arquivo .instructions.md fornece regras de API baseadas em texto — sem configuração adicional necessária.

Opção B — Arquivos de instrução estendidos + MCP (3 arquivos)

Baixe os três arquivos de instrução estendidos e coloque-os em .github/instructions/:

• mobiscroll-ui.instructions.md (orquestrador)
• mobiscroll-ui-react.instructions.md (convenções React)
• mobiscroll-ui-theming.instructions.md (temas)

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

Passo 2: Conectar o servidor MCP

Configure o servidor Mobiscroll MCP para que os arquivos de instrução estendidos possam chamá-lo para consultas de esquema ao vivo.

Crie ou edite .vscode/mcp.json na raiz do seu projeto:

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

[!-warning] -warning "servers" não "mcpServers"

O VS Code usa "servers" como chave raiz — não "mcpServers" como Claude Code e Cursor. Usar a chave errada quebra silenciosamente a configuração sem mensagem de erro.

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

Escopo	Arquivo de configuração	Compartilhado com a equipe
workspace	.vscode/mcp.json na raiz do projeto	Sim, se versionado
perfil do usuário	Aberto via MCP: Open User Configuration	Não, todos os seus workspaces

Verifique a conexão: Abra a Paleta de Comandos e execute MCP: List Servers. O servidor mobiscroll deve aparecer com status conectado. Uma caixa de diálogo de confiança aparece no primeiro uso — aprove-a para permitir que o servidor inicie.

Alternativamente, abra a Paleta de Comandos e execute MCP: Add Server para uma configuração guiada.

Como funciona

Os arquivos de instrução com applyTo: "**" se aplicam automaticamente a todas as consultas do Copilot Chat — sem necessidade de referência manual. Ambas as opções contêm:

• URLs de documentação — apontam a IA para a documentação correta do framework
• Mapeamento de componentes — mapeiam intenções do usuário (ex.: "scheduler") para as APIs Mobiscroll corretas
• Regras — garantem imports de pacotes corretos, carregamento de CSS e uso da API
• Restrições — previnem mistura entre frameworks e alucinação de API

Faça perguntas sobre Mobiscroll diretamente:

How do I set up a weekly scheduler with Mobiscroll?

What options does the Eventcalendar timeline view accept?

Configuração do Claude Code

Instale o plugin Mobiscroll para Claude Code. O plugin agrupa habilidades de codificação de framework e o servidor MCP em uma única instalação — sem necessidade de arquivos de configuração por projeto.

Passo 1: Registrar o marketplace

Execute isto uma vez no Claude Code para registrar o marketplace de plugins Mobiscroll:

/plugin marketplace add acidb/mobiscroll-marketplace

Passo 2: Instalar o plugin

/plugin install mobiscroll@mobiscroll

[!-warning] -warning Habilidades de plugin não são atualizadas automaticamente

Instalar o plugin tira um instantâneo de suas habilidades — o Claude Code não baixará versões mais novas por conta própria, a menos que você ative a atualização automática para o marketplace. Para obter as versões mais recentes a qualquer momento, execute /plugin marketplace update mobiscroll && /plugin update mobiscroll@mobiscroll e depois /reload-plugins.

Passo 3: Conectar o servidor MCP

O plugin inclui o servidor MCP — nenhuma configuração separada é necessária para a maioria das configurações. Para configurá-lo manualmente ou compartilhá-lo com sua equipe:

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

[!-warning] -warning Extensão VS Code

Se você estiver usando a extensão Claude Visual Studio Code, o servidor não aparecerá a menos que seja adicionado com escopo de projeto. Veja o próximo comando abaixo.

Para compartilhar o servidor com sua equipe automaticamente, use o escopo de projeto:

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

Isso cria ou atualiza .mcp.json na raiz do seu projeto. Você também pode criar esse arquivo manualmente:

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

Escopo	Flag CLI	Local da configuração	Compartilhado com a equipe
local (padrão)	--scope local	~/.claude.json	Não
projeto	--scope project	.mcp.json na raiz do projeto	Sim, via controle de versão
usuário	--scope user	~/.claude.json	Não, todos os seus projetos

[!-info] -info info

Use --scope project para repositórios de equipe para que todos recebam o servidor MCP automaticamente ao clonar o projeto. [!-warning] -warning Também conectado pelo diretório?

Se sua organização habilitou o conector Mobiscroll pelo diretório da Anthropic, você pode já ter o servidor através da sua conta Claude. Uma entrada .mcp.json no escopo do projeto e o conector do diretório são duas rotas para o mesmo servidor, e o Claude Code pode reportar a entrada do projeto como falha ao carregar até que você autorize o conector na sua própria conta. Autorize uma vez e ambos funcionam, ou remova a entrada .mcp.json e dependa apenas do conector. Veja Configuração do app Claude abaixo.

Verifique a conexão: Execute /mcp dentro do Claude Code. O painel lista cada servidor conectado e sua contagem de ferramentas. Uma conexão saudável mostra mobiscroll com pelo menos uma ferramenta.

Como funciona

Uma vez instalado, o plugin fornece:

• Skills — mobiscroll-ui é a skill orquestradora que detecta seu framework (React, Angular, Vue, JavaScript ou jQuery) e carrega a sub-skill de framework correspondente. Perguntas sobre temas são tratadas por mobiscroll-ui-theming. Todas as skills são instaladas juntas.
• Servidor MCP — O servidor Mobiscroll MCP incluído fornece consulta de schema de componentes ao vivo, validação de código e busca de exemplos sob demanda, para que o Claude trabalhe com a API atual em vez de adivinhar pela memória. Revise o código gerado antes de mesclá-lo, como faria com qualquer saída de IA.

Quando você pede ao Claude Code para escrever código Mobiscroll, ele:

1. Detecta seu framework e versão do Mobiscroll via resolveEnvironment
2. Carrega a skill de framework correspondente com convenções idiomáticas
3. Consulta o schema do componente antes de escrever qualquer prop ou evento
4. Valida o código gerado antes de devolvê-lo a você

Configuração do Codex

Instale o plugin Mobiscroll para OpenAI Codex. O plugin agrupa skills de codificação de framework e o servidor MCP em uma única instalação — sem necessidade de arquivos de configuração por projeto.

Passo 1: Registre o marketplace

Execute isto uma vez no Codex para registrar o marketplace de plugins Mobiscroll:

/plugins marketplace add acidb/mobiscroll-marketplace

Passo 2: Instale o plugin

/plugins install mobiscroll@mobiscroll

[!-warning] -warning Skills do plugin não são atualizadas automaticamente

Instalar o plugin tira um snapshot das suas skills — o Codex não baixará versões mais novas por conta própria. Para obter as mais recentes a qualquer momento, atualize o catálogo do marketplace e reinstale o plugin: /plugins marketplace update mobiscroll, depois /plugins install mobiscroll@mobiscroll.

Passo 3: Conecte o servidor MCP

O plugin inclui o servidor MCP — nenhuma configuração separada é necessária para a maioria das configurações. Para configurá-lo manualmente ou compartilhá-lo com sua equipe, adicione-o a ~/.codex/config.toml (global) ou .codex/config.toml (projeto):

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

Você também pode registrá-lo pela linha de comando:

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

Escopo	Local da configuração	Compartilhado com a equipe
global	~/.codex/config.toml	Não, todos os seus projetos
projeto	.codex/config.toml na raiz do projeto (apenas projetos confiáveis)	Sim, via controle de versão

[!-info] -info info

Use o .codex/config.toml no nível do projeto para repositórios de equipe, para que todos recebam o servidor MCP automaticamente ao clonar o projeto.

Verifique a conexão: Execute /mcp dentro do Codex. O painel lista cada servidor conectado e sua contagem de ferramentas. Uma conexão saudável mostra mobiscroll com suas ferramentas listadas.

Como funciona

Uma vez instalado, o plugin fornece:

• Skills — mobiscroll-ui é a skill orquestradora que detecta seu framework (React, Angular, Vue, JavaScript ou jQuery) e carrega a sub-skill de framework correspondente. Perguntas sobre temas são tratadas por mobiscroll-ui-theming. Todas as skills são instaladas juntas.
• Servidor MCP — O servidor Mobiscroll MCP incluído fornece consulta de schema de componentes ao vivo, validação de código e busca de exemplos sob demanda, para que o Codex trabalhe com a API atual em vez de adivinhar pela memória. Revise o código gerado antes de mesclá-lo, como faria com qualquer saída de IA.

Quando você pede ao Codex para escrever código Mobiscroll, ele:

1. Detecta seu framework e versão do Mobiscroll via resolveEnvironment
2. Carrega a skill de framework correspondente com convenções idiomáticas
3. Consulta o schema do componente antes de escrever qualquer prop ou evento
4. Valida o código gerado antes de devolvê-lo a você

Configuração do app Claude — claude.ai, Desktop e mobile

O servidor MCP está publicado no diretório de conectores da Anthropic, então o Claude na web, o Claude Desktop e os apps mobile do Claude podem usá-lo sem arquivos de projeto ou comandos CLI. É o mesmo servidor que as configurações de editor acima usam — a diferença é apenas como você o acessa.

Passo 1: Conecte pelo diretório

Abra Configurações → Conectores → Procurar conectores, pesquise por Mobiscroll e clique em Conectar.

Não há nada para configurar. O servidor é somente leitura e não precisa de conta, chave de API ou login OAuth.

Passo 2: Habilite para sua organização (Team e Enterprise)

Nos planos Team e Enterprise, um Proprietário adiciona o conector para a organização primeiro. Cada membro então o conecta na sua própria conta — o conector está listado para todos, mas não responde até que o membro individual o tenha conectado.

[!-warning] -warning Já adicionou como conector personalizado?

Se você adicionou mobiscroll manualmente antes de ele estar no diretório, remova essa entrada antes de conectar pelo diretório. Duas entradas apontando para https://mcp.mobiscroll.com/ registram as mesmas ferramentas duas vezes, e o Claude pode chamar a cópia que você não espera.

Abra Configurações → Conectores, encontre sua entrada personalizada mobiscroll e remova-a. Depois conecte pelo diretório.

Como funciona

O Claude chama as mesmas 14 ferramentas somente leitura listadas na referência de ferramentas MCP abaixo. Pergunte sobre as opções de um componente, a assinatura de um evento, um endpoint Connect ou o equivalente SDK de uma chamada REST, e ele lê o schema atual em vez de responder pela memória.

O conector do diretório não carrega skills. Elas fazem parte do plugin Claude Code e Codex — para escrever código Mobiscroll dentro de um projeto, use a Configuração do Claude Code acima.

Referência de ferramentas MCP

O servidor MCP expõe 14 ferramentas. Todas são somente leitura e anotadas como tal, para que um assistente de IA possa chamá-las sem pedir confirmação a cada vez. Nenhuma delas lê ou escreve nada na sua conta Mobiscroll, e as ferramentas Connect descrevem a API Connect em vez de chamá-la.

Ferramentas de UI Mobiscroll

Ferramenta	O que retorna	Requer
resolveEnvironment	O framework e a versão principal que um projeto usa, lidos do seu package.json. Esses são os valores que as outras ferramentas de UI recebem como argumentos.	conteúdo do package.json
listComponents	Todos os componentes disponíveis para um framework e versão, com uma breve descrição e contagem de entidades.	framework, major
getComponentSchema	Opções, eventos, métodos e renderizadores para um componente. Retorna um índice compacto primeiro; chame novamente com nomes específicos para detalhes completos.	componente, framework, major
searchExamples	Exemplos que correspondem a palavras-chave, filtrados por componente e versão, ordenados por relevância.	framework, major
getExampleById	Um exemplo completo com seus arquivos de origem, descrição e notas de implementação.	exampleId, framework, major
validateCode	Props, eventos e métodos desconhecidos em um trecho, além de uso obsoleto. Análise estática — nada é executado.	componente, framework, major, trecho

Ferramentas Mobiscroll Connect

O mesmo servidor também responde perguntas sobre a API REST Connect e seus SDKs. Elas estão documentadas por completo no guia de Integração de IA Connect.

Ferramenta	O que retorna	Requer
resolveConnectEnvironment	Qual SDK Connect e versão um projeto depende, lido do seu manifesto de dependências.	conteúdo do manifesto
listConnectEndpoints	Todos os endpoints REST Connect com método, caminho, resumo e autenticação.	—
getConnectEndpointSchema	Um endpoint completo: parâmetros com tipos, autenticação, status de resposta, exemplos.	endpointId, ou método + caminho
listConnectSdkMethods	Os recursos e métodos que o SDK de uma linguagem expõe.	linguagem
getConnectSdkMethod	Um método SDK completo: assinatura, parâmetros, tipo de retorno, comentário de documentação, exemplo.	linguagem, método
searchConnect	Correspondências de palavras-chave em endpoints REST e métodos SDK.	consulta
mapConnectEndpointToSdk	A chamada SDK equivalente para um endpoint REST, em cada linguagem ou em uma.	endpointId, ou método + caminho
getConnectErrorTaxonomy	Cada categoria de erro com seu status HTTP e o tipo de exceção idiomática por linguagem.	—

[!-success] -success Comece com uma chamada de resolução

O servidor roda remotamente e não pode ler seus arquivos, então resolveEnvironment e resolveConnectEnvironment recebem o conteúdo do seu manifesto como argumento. Todas as outras ferramentas aceitam o framework, versão ou linguagem diretamente se você já os conhece.

Isolamento de frameworks

[!-warning] -warning Crítico

Cada arquivo de regras e fonte de documentação tem como alvo exatamente um framework ou domínio. Nunca combine arquivos de frameworks diferentes, nem misture arquivos de framework de UI com arquivos Connect.

Por que isso importa:

• A maioria das opções de API é compartilhada entre frameworks, mas o uso de componentes e templates difere para cada um — misturá-los produz código quebrado

Mobiscroll Connect é um domínio separado:

• Connect é uma camada de integração de backend — OAuth 2.0, API REST, webhooks, sincronização de calendário
• Não tem componentes de UI, JSX ou bindings de frameworks frontend
• Connect usa mobiscroll-connect.mdc e llms-connect-full.txt — nunca os arquivos de framework de UI
• Misturar documentação Connect com documentação de UI faz a IA confundir endpoints REST com APIs de componentes

[!-info] -info info

O plugin mobiscroll@mobiscroll também inclui uma skill mobiscroll-connect para Connect no lado do servidor (OAuth, REST, sincronização de calendário). Ela ativa apenas para trabalho de backend Connect e nunca se mistura com código de componentes de UI. Veja o guia de Integração de IA Connect.

Regras:

1. Use apenas arquivos de regras que correspondam a um framework ou domínio — nunca misture arquivos de frameworks diferentes
2. Registre apenas uma fonte de documentação no Cursor
3. Se seu projeto usa múltiplos frameworks (ex.: micro-frontends), configure diretórios separados com arquivos .mdc separados
4. Se seu projeto usa tanto um framework de UI quanto Mobiscroll Connect, use diretórios de contexto de IA separados para cada um
5. Se um assistente de IA gera código com imports de framework errados, verifique se o arquivo de regras correto está no lugar

Exemplos de consultas

Estes exemplos mostram o tipo de perguntas que a integração de IA foi projetada para tratar corretamente.

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?

Solução de problemas

IA gera código com o framework errado

Sintoma: Você está usando React, mas a IA gera código para um framework diferente (ex.: import { Eventcalendar } from '@mobiscroll/angular').

Correção: Verifique se você tem o arquivo de regras correto no lugar. Para React no Cursor, use mobiscroll-react.mdc; para Copilot, use mobiscroll-react.instructions.md. No Cursor, verifique se a fonte @docs registrada aponta para llms-react-full.txt.

IA inventa APIs que não existem

Sintoma: A IA sugere opções, eventos ou tipos que não existem na documentação do Mobiscroll.

Correção: As regras .mdc instruem a IA a usar apenas APIs encontradas na documentação. Se isso ainda acontecer, referencie explicitamente @docs em consultas no Cursor, ou verifique se o plugin Mobiscroll está instalado no Claude Code (/plugin list) ou no Codex (codex plugin list). Você também pode pedir à IA para verificar se uma opção existe na documentação do Mobiscroll.

IA mistura Mobiscroll Connect com componentes de UI

Sintoma: A IA gera chamadas de API REST quando você perguntou sobre um componente de calendário frontend, ou gera código JSX/componente quando você perguntou sobre a API Connect. Correção: Mobiscroll Connect é uma camada de integração de backend (OAuth, REST, webhooks) e não possui componentes de UI. Eventcalendar é um componente de UI de frontend sem API REST. Eles usam arquivos .mdc e fontes de documentação totalmente separados. Verifique se o arquivo .mdc correto está ativo para o seu projeto. Se você usar ambos no mesmo código, mantenha diretórios de contexto de IA separados para cada um.

O servidor MCP não aparece após a configuração

Sintoma: O painel do servidor MCP não mostra nenhuma entrada mobiscroll, ou as ferramentas não estão disponíveis.

Correção: Verifique se o arquivo de configuração está no local correto e usa a chave raiz correta — mcpServers para Claude Code, Codex e Cursor, servers para VS Code. Valide se o arquivo é JSON bem formado. Para Claude Code ou Codex, execute /mcp para inspecionar os servidores conectados.

Referência de arquivos

Todos os arquivos de integração de IA estão disponíveis nos seguintes URLs:

Arquivos de documentação

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

Arquivos de regras

Arquivo	Cursor (.mdc)	Copilot (.instructions.md)
Regras React	mobiscroll-react.mdc	copilot-instructions/mobiscroll-react.instructions.md

Arquivos de regras estendidas

Arquivo	Cursor (.mdc)	Copilot (.instructions.md)
Orquestrador	mobiscroll-ui.mdc	copilot-instructions/mobiscroll-ui.instructions.md
Convenções React	mobiscroll-ui-react.mdc	copilot-instructions/mobiscroll-ui-react.instructions.md
Temas	mobiscroll-ui-theming.mdc	copilot-instructions/mobiscroll-ui-theming.instructions.md

Conteúdo dos arquivos

O conteúdo completo de cada arquivo é mostrado abaixo. Você pode copiar diretamente desses blocos ou usar os links de download acima.