Para devs / CLI & MCP

O Ravox no seu agente

Ligue o Ravox UI no Claude, no Codex, no Cursor, no VS Code, no Lovable ou no Windsurf. O agente busca componentes da comunidade, pega o código, instala o Ravox Kit e os blocos e aplica os temas, direto no seu projeto, sem copiar e colar.

Primeiro, uma chave de API. É grátis e liga o agente à sua conta. Com ela, os comandos abaixo já saem prontos.

1.Registre o servidor

No terminal:

claude mcp add --transport http ravox https://ui.ravoxlabs.com/api/mcp --header "x-api-key: SUA_CHAVE"

2.Ou deixe no projeto, para a equipe

Num .mcp.json na raiz. Cada pessoa põe a própria chave em RAVOX_API_KEY.

.mcp.json

{
  "mcpServers": {
    "ravox": {
      "type": "http",
      "url": "https://ui.ravoxlabs.com/api/mcp",
      "headers": {
        "x-api-key": "${RAVOX_API_KEY}"
      }
    }
  }
}

3.Confira
O ravox aparece como conectado:
```
claude mcp list
```

O que pedir

Achar e usar um componente
“Procure no Ravox um toggle divertido em CSS e coloque no rodapé da página de configurações.”
Montar uma tela com o Kit
“Instale o bloco de entrar pelo celular do Ravox Kit em app/entrar e troque os textos para a minha clínica.”
Trocar o tema do projeto
“Aplique o tema Padaria do Ravox no globals.css e me mostre o que mudou.”
Copiar sem Tailwind
“Pegue o tema Jornal do Ravox em CSS puro e crie um tema.css para este site estático.”

As ferramentas

Todas só leem: nada no seu projeto muda sem você pedir ao agente. As cópias contam nas métricas de quem criou o componente.

buscar_componentes: Busca componentes de UI da comunidade (HTML + CSS ou Tailwind) por texto, categoria ou tecnologia. Devolve até 24 resultados com o slug; use ver_componente para pegar o código.
ver_componente: Devolve o HTML e o CSS (ou o HTML com classes Tailwind) de um componente publicado, pelo slug. Quando existe, traz também a versão na outra tecnologia (CSS ⇄ Tailwind).
listar_kit: Lista os componentes React do Ravox Kit (biblioteca instalável pelo shadcn, API em pt-BR, sem Radix) com o comando de instalação de cada um.
ver_item_kit: Mostra as props de um componente do Ravox Kit, o comando de instalação e o código-fonte do arquivo que o shadcn cria.
listar_blocos: Lista os blocos do Kit: telas inteiras prontas (painéis, barras laterais, entrar, cadastro, gráficos, preços...) com a rota que ganham e o comando que instala a tela com os componentes.
listar_temas: Lista os temas do Ravox Kit (da casa e da comunidade) com fontes, cor da marca e medidas. Use ver_tema para pegar o CSS.
ver_tema: Devolve o CSS de um tema: `tailwind` (variáveis do Tailwind 4 e do shadcn para o globals.css) ou `css` (CSS puro com variáveis, base e classes prontas).

Sem MCP

O Ravox Kit também instala direto pelo shadcn (npx shadcn@latest add, veja a instalação), e o resumo do site para modelos de linguagem fica em /llms.txt. O CLI do Ravox (npx ravox) vem em breve.