MCP Server

Servidor MCP oficial da Corvex Store — tools, resources, Dev Server e segurança.

corvex mcp expõe contratos, validação, Theme Check, build e sessões do Dev Server a agentes compatíveis com o Model Context Protocol (stdio local).

Não é um serviço remoto. Não exige autenticação com a loja para operações locais. Não inicia --store.

Execução

cd minha-loja
corvex mcp

• stdout — protocolo MCP apenas
• stderr — logs humanos

corvex mcp doctor
corvex mcp setup
corvex mcp setup --cursor

setup --cursor grava .cursor/mcp.json no projeto sem sobrescrever uma entrada corvex já existente.

Snippet Cursor

{
  "mcpServers": {
    "corvex": {
      "command": "node",
      "args": ["C:/caminho/para/corvex.js", "mcp"],
      "env": {}
    }
  }
}

Execute o servidor com o cwd na raiz do tema (theme.json).

Tools

Tool	Papel
corvex_theme_info	Manifest + seções/blocos/templates/snippets
corvex_list_rules	Regras do Theme Check
corvex_validate	Mesmo motor de corvex validate
corvex_check	Mesmo motor de corvex check
corvex_build	Pipeline oficial (prepareThemeDir / buildThemeBundleV2)
corvex_read_theme_file	Lê arquivo relativo (sandbox)
corvex_list_theme_files	Lista entradas de um diretório relativo
corvex_dev_list	Sessões Dev iniciadas pelo MCP
corvex_dev_start	Inicia corvexdev em modo mock
corvex_dev_stop	Encerra sessão iniciada pelo MCP

Não há tool de shell arbitrário, publish ou sync.

Resources

Consulta sob demanda (não dump completo da docs):

• corvex://contracts/setting-types
• corvex://contracts/required-templates
• corvex://contracts/sdk-exports
• corvex://check/rules
• corvex://cli/commands
• corvex://cli/version

Prompts

• corvex_fix_diagnostics — fluxo para corrigir diagnósticos com contratos oficiais

Dev Server

O MCP reutiliza o mesmo binário corvexdev. Não cria segundo renderer nem segundo pipeline de build.

• Mock permanece o padrão
• --store / modo conectado é rejeitado
• Só sessões iniciadas pelo próprio MCP podem ser encerradas via corvex_dev_stop

Segurança

• Uma raiz de tema autorizada por sessão
• Canonicalização de caminhos; rejeição de .. e symlink para fora do tema
• Argumentos não são interpretados como shell
• Limite de leitura de arquivo (512KB)
• Sem telemetria sensível por padrão
• Sem credenciais no protocolo

Fluxo típico do agente

1. corvex_theme_info / resources de contrato
2. Implementar alterações no tema
3. corvex_check → corrigir diagnósticos
4. corvex_validate
5. corvex_build
6. corvex_dev_start → conferir URL
7. corvex_dev_stop

O MCP não “vê” a UI como um navegador. Screenshot e inspeção visual dependem do cliente.