MCP e IA
No seu app (não neste site), conecte o assistente ao registry Marsala para listar componentes, rodar shadcn add com @youxgroup e montar telas com o design system da Youx.
O que isso faz no dia a dia
O servidor MCP do shadcn lê o components.json do seu projeto. Com @youxgroup configurado, a IA usa o Marsala DS em vez do registry padrão do shadcn.
- Ver quais componentes existem no Marsala (button, field, attachment, etc.).
- Instalar no projeto com
@youxgroup/nomee dependências corretas. - Gerar formulários, chat e layouts alinhados a base-nova, tokens Marsala e Hugeicons.
1. Prepare o projeto para o Marsala
Faça isso na raiz do repositório do produto. Sem esses passos, o MCP só enxerga o shadcn oficial.
Detalhes em Instalação. Resumo:
- Aplique o preset
base(tokens e estilo Marsala). - Registre o namespace abaixo no
components.json.
pnpm dlx shadcn@latest init "https://marsala-ds.youxgroup.com.br/r/base.json" -b base -y{
"registries": {
"@youxgroup": "https://marsala-ds.youxgroup.com.br/r/{name}.json"
}
}2. Ative o MCP no editor
Ainda na raiz do seu app. O comando configura o servidor shadcn; ele usa automaticamente os registries do seu components.json, incluindo @youxgroup.
Na pasta do seu app, rode o comando e reinicie o Cursor. Em Settings → MCP, ative o servidor shadcn.
pnpm dlx shadcn@latest mcp init --client cursorTeste: "Quais componentes existem no registry @youxgroup?"
3. Peça para a IA usando o Marsala
Mencione @youxgroup ou Marsala DS para não misturar com componentes do shadcn/ui padrão.
Liste os componentes disponíveis no registry @youxgroup.
Instale @youxgroup/button e @youxgroup/field e monte um formulário de login.
Adicione @youxgroup/attachment e monte um preview de arquivo no chat.
Use só componentes do Marsala DS (@youxgroup) — não use o registry padrão do shadcn.Se a IA não usar o Marsala
- Confira se
registries.@youxgroupestá nocomponents.jsondo projeto aberto no editor. - Confirme que o servidor MCP shadcn está ligado (Cursor: Settings → MCP).
- Abra o chat no mesmo workspace onde você rodou o
mcp init. - No prompt, cite
@youxgroupou "Marsala DS" explicitamente.
Referência do protocolo MCP do shadcn: documentação oficial.
Skill IA (complementar)
O MCP instala componentes; a skill ensina o agente a escolher qual usar e como compor telas no seu app.
Instale com pnpm dlx shadcn@latest add @youxgroup/marsala-skill. Detalhes em Skill no Cursor.