> ## Documentation Index
> Fetch the complete documentation index at: https://docs-loja.usecorvex.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
cd minha-loja
corvex mcp
```

* **stdout** — protocolo MCP apenas
* **stderr** — logs humanos

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
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

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.