Aplicações e deploys
Crie, publique, reinicie e acompanhe apps, logs, métricas, runtimes, domínios e histórico de deploy.
Model Context Protocol
Sua infraestrutura conversa com o seu assistente.
O servidor MCP oficial da Vertra dá a agentes de IA ferramentas reais para publicar apps, ler logs, administrar bancos e restaurar snapshots — dentro dos escopos que você liberar.
Seu assistente
MCP
Vertra Cloud
apps:readdatabases:writesnapshots:read
Código abertoimplementação pública e auditável
MITlicença simples para usar e contribuir
Local + webstdio por npx ou conector remoto
Por escopovocê decide o que cada agente acessa
Como funciona
A sua intenção vira uma chamada autorizada à Vertra.
O MCP traduz pedidos em linguagem natural para ferramentas com entrada e resposta estruturadas. A regra de acesso continua sendo a mesma da API.
Você escolhe o acesso
Crie uma chave com só os escopos necessários ou autorize o conector web pela tela da Vertra. Leitura e escrita permanecem separadas.
O cliente descobre as ferramentas
Claude, Cursor, VS Code e outros clientes compatíveis recebem o catálogo da Vertra e sabem quais operações podem chamar.
O assistente executa e explica
Cada ferramenta chama a API pública, devolve uma resposta estruturada e permite que o agente continue o trabalho com o resultado real.
Ferramentas
Da primeira publicação à operação diária.
Um único conector cobre os recursos que você já administra na Vertra.
Bancos de dados
Crie e opere PostgreSQL, MySQL, MongoDB e Redis, com estado, métricas e credenciais quando o escopo permitir.
Arquivos e ambiente
Leia e altere arquivos, envie uma pasta local e gerencie variáveis sem devolver o valor secreto na listagem.
Workspaces e conta
Consulte uso, membros, papéis, atividades, notificações e os recursos compartilhados do time.
Operação
Acompanhe deploys, logs e o estado dos recursos sem sair do seu fluxo de trabalho.
Snapshots e operação
Crie, restaure e baixe snapshots, limpe cache e acompanhe a saúde dos recursos sem sair do seu agente.
Duas formas de conectar
No navegador ou no seu computador.
Use o remoto quando quiser entrar com a sua conta. Use o pacote local quando o agente também precisar trabalhar nos arquivos do seu projeto.
Conector remoto
Adicione a URL no seu cliente, entre na Vertra e confirme os escopos. Sem instalar pacote nem copiar chave para o navegador.
https://mcp.vertracloud.app/mcpPacote local
Rode por stdio com Node 18 ou mais novo e forneça VERTRA_API_KEY ao processo. É o modo que habilita operações com arquivos locais.
Controle de acesso
O agente recebe só o que você liberar.
MCP não contorna as proteções da plataforma. Ele usa a API pública e respeita a chave, os escopos e a conta que autorizou a conexão.
Menor privilégio
Comece com leitura e adicione escrita apenas onde o fluxo realmente precisa.
Segredos protegidos
Listar variáveis mostra nomes, nunca valores. Operações sensíveis exigem escopos próprios.
Acesso revogável
Revogue a chave ou a autorização na Vertra para cortar o acesso sem reconfigurar a infraestrutura.
Código aberto
Fino por desenho. Público por confiança.
O projeto @vertracloud/mcp é uma camada pequena sobre a API pública da Vertra: ferramentas, transporte stdio e um servidor reutilizável. Sem banco, cache ou credencial própria. Leia o código, abra uma issue ou contribua.
Abrir repositórioPerguntas frequentes
Antes de conectar.
O essencial sobre compatibilidade, cobrança e acesso.
O MCP custa alguma coisa além do meu plano?
Usar o servidor MCP não cria uma assinatura separada. As ações seguem as mesmas regras e limites do recurso que você já usa na Vertra.
Qual cliente de IA eu posso usar?
Qualquer cliente compatível com Model Context Protocol. O pacote local funciona por stdio; o conector remoto usa Streamable HTTP e autorização pela sua conta Vertra.
O assistente vê minhas variáveis de ambiente?
A ferramenta de listagem devolve apenas os nomes. Definir ou remover uma variável exige o escopo específico, e o valor enviado não volta na resposta.
Por que algumas ferramentas só existem no modo local?
Criar um app a partir de uma pasta, enviar arquivos e baixar snapshots precisam ler ou gravar no seu computador. Um servidor remoto no navegador não tem esse acesso — nem deveria ter.
Posso usar em um workspace?
Sim. As ferramentas de workspace permitem consultar recursos, membros, papéis, notas e uso conforme as permissões da sua conta e os escopos concedidos.
Comece com leitura
Dê contexto real ao seu assistente.
Crie uma chave com os escopos mínimos, conecte o cliente e peça para listar seus apps. Depois, amplie só o que fizer sentido.
Criar chave de API