MarsalaDS

Buscar

Páginas e componentes da documentação

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/nome e 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:

  1. Aplique o preset base (tokens e estilo Marsala).
  2. 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 cursor

Teste: "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.@youxgroup está no components.json do 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 @youxgroup ou "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.