Para desenvolvedores

Developers — build apps on VTC

Clone VTC Cursor rules, sign in and create an app in your Space, scaffold locally, and deploy to apps.vtc.com with push-to-publish.

Veja o pacote de regras no GitHub → Abra o aplicativo →

Pacote de regras do cursor

Repositório público — apenas regras de autoria de aplicativos. Copie para o seu projeto como .cursor/rules/ (nunca crie um link simbólico; nunca confirme .cursor/ para o repositório do seu aplicativo).

HTTPS 
git clone https://github.com/vtcdotcom/vtc-app-rules.git ~/vtc-app-rules
SSH 
git clone [email protected]:vtcdotcom/vtc-app-rules.git ~/vtc-app-rules
Instale em seu aplicativo 
~/vtc-app-rules/scripts/copy-cursor-rules.sh /path/to/your-app
  • Abra o Cursor na raiz da pasta do seu aplicativo – um aplicativo por espaço de trabalho.
  • Peça ao Cursor para seguir scaffold-checklist.mdc ao fazer o scaffolding.
  • Aplicativos compartilhados isolam dados por espaço; Os aplicativos dedicados usam um banco de dados de editor.
  • Obtenha atualizações de regras periodicamente e execute novamente copy-cursor-rules.sh.

Como funciona

Você cria o aplicativo localmente com o Cursor. VTC hospeda-o, injeta autenticação e ambiente de plataforma na implantação e fornece-o a partir de seu catálogo do Space.

  1. 1

    Clonar as regras do Cursor

    Clone o repositório público vtc-app-rules (acima). Esses são os padrões que nossa IA e pipeline de construção esperam – autenticação, arquivos env, shell de aplicativo, i18n e layout de implantação.

  2. 2

    Faça login em VTC

    Use uma conta com acesso de administrador ao espaço onde o aplicativo ficará.

    https://app.vtc.com
  3. 3

    Crie o aplicativo no seu espaço

    No painel do aplicativo, abra seu Espaço → Aplicativos → Criar. Defina o nome do aplicativo, o nome abreviado, a implantação compartilhada versus dedicada e a visibilidade do catálogo (espaço, rede ou plataforma).

  4. 4

    Copie o controle remoto do Git

    Após a criação do aplicativo, abra as configurações do desenvolvedor e copie o URL do Git (SSH ou HTTPS). Esse controle remoto é onde você envia o código – a plataforma é construída e implantada a cada envio.

  5. 5

    Andaime localmente no Cursor

    Copie as regras para a pasta do seu projeto, abra essa pasta no Cursor (não um diretório pai com muitos repositórios) e faça o scaffold usando scaffold-checklist.mdc. Aponte seu repositório local para o Git remoto da etapa 4.

  6. 6

    Pressione para publicar

    Confirme e envie para o aplicativo remotamente. O serviço de build produz sua imagem ou pacote estático e o veicula no nome de host do editor — sem etapa de implantação manual.

    Padrão de URL ativo: https://myapp.apps.vtc.com

Apps Vite estáticos podem ser enviados e publicados na hora. Apps Next.js executam código de servidor, então só são implantados depois que seu Space for aprovado como desenvolvedor confiável. Para solicitar, envie um e-mail para [email protected].

MCP de Espaço no Cursor

Conecte o Cursor (ou Claude / VS Code) a um Espaço do qual você já faz parte. O MCP é limitado ao Espaço — não é um jeito de plugar um banco de dados de produto externo no VTC.

  1. 1

    Conectar

    Adicione https://mcp.vtc.com/mcp em Cursor Settings → MCP (configuração abaixo). Clique em Connect — o navegador abre para o login da VTC.

  2. 2

    Entre e escolha um Espaço

    Conclua o OTP no pop-up, escolha seu Espaço e volte ao Cursor. O cliente armazena e renova os tokens automaticamente.

  3. 3

    Pergunte sobre esse Espaço

    Inspecione dados de apps Shared (list_collections → sample/find), catálogo e manifests, ações do Guide (list_available_actions → execute_action) ou proponha/execute fluxos. Mutações e execuções reais de fluxos exigem um confirmation_token mostrado a você primeiro.

Configuração MCP do Cursor 
{
  "mcpServers": {
    "vtc-space-db": {
      "type": "http",
      "url": "https://mcp.vtc.com/mcp"
    }
  }
}

Clientes interativos usam OAuth Connect (login no navegador + seletor de Espaço). Agentes headless podem passar um JWT de admin do Developer Help como Bearer.

  • As mesmas barreiras de função e o mesmo caminho de cobrança do Guide no produto, quando aplicável.
  • CI / headless: gere um JWT de admin no Developer Help e defina Authorization: Bearer <jwt> nos cabeçalhos MCP.
  • Nunca invente outro group_id para as ferramentas de BD — o silo é só o Espaço do JWT.

O que as regras cobrem

Autenticação e espaços

JWT via ?token= do shell, bootstrap localStorage e escopo group_id para aplicativos compartilhados.

IU e i18n

Shell de aplicativo padrão, Tailwind v4, cores de destaque de tempo de execução e arquivos de localidade desde o primeiro dia.

APIs e dados

Rotas CRUD, exclusão reversível, URLs orientados por ambiente e @posif/sdk para acesso ao banco de dados de produção alugado.

Implantar

.env.production confirmado apenas para chaves de propriedade do aplicativo; plataforma injeta URLs de API, MongoDB e identidade na construção.

Livro razão VTC

EVM permitido e sem gás para registros imutáveis, provas on-chain e assinatura de carteira – integre a partir de aplicativos quando precisar de emissão à prova de adulteração.

Pronto para construir?

Clone as regras, crie o aplicativo em seu espaço e envie quando estiver pronto.

Obtenha as regras Vá para o aplicativo Serviços de plataforma