Servidor MCP

BoardUI inclui um servidor MCP para que agentes de IA façam a instalação. Claude Code, Cursor, VS Code, Codex e qualquer cliente MCP podem explorar o registro, ler o código dos componentes e exemplos reais, configurar um projeto e instalar os arquivos nele. Basta descrever o que você quer criar.

O servidor roda localmente via stdio com npx, sem hospedagem externa. Os componentes gratuitos funcionam sem configuração. Ative o BoardUI Pro no mesmo chat com a sua chave de licença.

Uma regra para todos os clientes: as ferramentas MCP são carregadas no início da sessão. Se adicionar o servidor durante uma sessão, reinicie o cliente ou abra um novo chat para disponibilizar as ferramentas.

Configuração

Escolha seu cliente. Cursor e VS Code instalam com um clique; Claude Code e Codex usam um comando.

Claude Code

Cursor

VS Code

Codex

Outros clientes

Um comando no seu directório do projeto. Adicionar --scope user para habilitá-lo para cada projeto, e reiniciar o Claude Code (ou abrir uma nova sessão) depois para que as ferramentas se liguem.

claude mcp add boardui -- npx -y boardui@latest mcp

Monorepos e aliases personalizados

O servidor MCP local lê o mesmo arquivo opcional boardui.json como o CLI. Coloque-o ao lado do pacote de destino package.json e passar o caminho absoluto desse pacote como projectDir para init_boardui, install_components, e install_rules. Os arquivos e as dependências npm são instalados nesse pacote com os aliases de importação configurados.

Passar o mesmo projectDir para get_component e get_usage_examples para a correspondência de fonte e exemplos. Sem ela, estas ferramentas de leitura retornam as importações de registro originais. As exportações de pacotes e os estilos de cada aplicativo ainda precisam ser configurados.

Configurar um pacote de UI compartilhado

Experimente pedir ao seu agente

Depois de conectar, converse normalmente com seu agente. Alguns exemplos:

“Configure BoardUI neste projeto e adicione os componentes button, select e date-picker.”
“Comprei o BoardUI Pro. Minha chave de licença é XXXX. Ative e instale o template de chat com IA.”
“Crie uma página de login com o card de autenticação e os botões sociais do BoardUI.”
“Ative RTL para árabe e hebraico neste projeto BoardUI, incluindo blocos e templates Pro.”
“Quais props o botão BoardUI aceita? Mostre as variantes com ícones.”
“Adicione a tabela de dados BoardUI e conecte ao endpoint /api/orders.”
“Mostre os tokens de tema BoardUI e adapte o botão primário à minha marca.”
“Crie um dashboard de receita com cards de indicadores BoardUI, um gráfico de área e uma lista de barras.”

Ferramentas

O que o servidor disponibiliza ao seu agente:

Ferramenta	O que faz
get_started	Overview of BoardUI, the typical flow, RTL setup, and the Pro licensing rules.
list_components	Every installable item with exact names, free and Pro, grouped by type.
get_component	Description, dependencies, usage example, and full source for one item.
get_usage_examples	Working code snippets from the item's docs page, Pro items included.
install_components	Writes component source into the project and installs missing npm deps.
init_boardui	One-time setup: Tailwind v4, runtime deps, theme and global styles, utils.
install_rules	Writes the always-on design rules into AGENTS.md and .cursor/rules/.
get_skill	Explains the agent skill: live SKILL.md, bundled files, install options per client.
install_skill	Installs the BoardUI agent skill (catalog, theming, patterns) into .claude/skills/.
get_theme	The theme tokens, type scale, global stylesheet, and RTL setup guidance.
activate_license	Activates a BoardUI Pro license key on the machine and stores it.
license_status	Whether a Pro license is active, with the key shown masked.
deactivate_license	Releases the machine's Pro seat and removes the stored key.

Regras de design sempre ativas

As ferramentas MCP estão sob demanda: um agente só vê seu tema quando pensa em perguntar, e um modelo que nunca pede inventa seu próprio espaçamento, cores e tipo. init_boardui (e npx boardui init) também instala as fundações de design como sempre-on arquivos de instrução que agentes carregam cada sessão: uma seção cercada em AGENTS.md e uma regra de Cursor em .cursor/rules/boardui.mdc. Eles fixam os tokens de cor semântica, a escala do tipo composto, convenções de espaçamento e raio, modo escuro, e cx(), e re-execuções atualizar a seção no lugar sem tocar no resto do seu arquivo.

Inicializou o seu projeto antes de este existir? Peça ao seu agente para executar install_rules.

Quer mais profundo conhecimento sempre carregado, com o catálogo completo, temas e padrões de página? Instale o Skill do BoardUI para agentes a par do MCP (install_skill, ou npx boardui skill).

BoardUI Pro via MCP

Componentes e modelos pro aparecem em list_components para cada usuário. Sem uma licença, seu agente recebe a descrição, um exemplo de uso público e instruções de compra em vez de fonte. Depois de comprar o Pro, cole a chave de licença do seu e-mail de compra no chat; o agente ativa-o com activate_license (um assento, liberado em qualquer momento com deactivate_license), e a partir de então os itens Pro instalar exatamente como os gratuitos. A chave é validado servidor-lado em cada download Pro.

Já fez login com boardui login? O servidor MCP usa a mesma licença armazenada, nada para refazer.

Telemetria anônima

Installas bem- sucedidas reportam os mesmos eventos anônimos que o CLI (nomes do componente, gerenciador de pacotes, versão), marcados como orientado por MCP. Nenhum caminho do projeto, prompts ou código fonte. Desable with BOARDUI_TELEMETRY_DISABLED=1 ou DO_NOT_TRACK=1 no ambiente do servidor.

Usando o MCP do shadcn

O registro BoardUI fala o esquema shadcn, então se seu agente já executa o servidor MCP shadcn você pode chegar a BoardUI através dele: adicione o espaço de nomes para components.json e pedir por @boardui/button. O servidor BoardUI acima também oferece exemplos de uso, configuração de projetos e licenciamento Pro.

{ "registries": { "@boardui": "https://www.boardui.com/r/{name}.json" }}

Como funciona

npx boardui@latest mcp inicia o mesmo motor que o CLI usa, falando MCP sobre stdio. Ele obtém o registro público de boardui.com, resolve dependências de componentes de forma transitória, e escreve arquivos usando o layout padrão ou seu boardui.json mapeamentos. Você também pode executá- lo manualmente para verificar a configuração:

npx boardui@latest mcp