Model Context Protocol

Tu infraestructura conversa con tu asistente.

El servidor MCP oficial de Vertra ofrece a los agentes de IA herramientas reales para publicar apps, leer logs, administrar bases y restaurar snapshots, dentro de los alcances que autorices.

Tu asistente
MCP
Vertra Cloud
apps:readdatabases:writesnapshots:read
Código abiertoimplementación pública y auditable
MITlicencia simple para usar y contribuir
Local + webstdio por npx o conector remoto
Por alcancetú decides qué accede cada agente
Cómo funciona

Tu intención se convierte en una llamada autorizada a Vertra.

MCP traduce pedidos en lenguaje natural a herramientas con entradas y respuestas estructuradas. Las reglas de acceso siguen siendo las mismas de la API.

  1. Elige el acceso

    Crea una clave solo con los alcances necesarios o autoriza el conector web desde Vertra. Lectura y escritura permanecen separadas.

  2. El cliente descubre las herramientas

    Claude, Cursor, VS Code y otros clientes compatibles reciben el catálogo de Vertra y saben qué operaciones pueden llamar.

  3. El asistente ejecuta y explica

    Cada herramienta llama a la API pública, devuelve una respuesta estructurada y permite al agente continuar con el resultado real.

Herramientas

Desde la primera publicación hasta la operación diaria.

Un solo conector cubre los recursos que ya administras en Vertra.

Aplicaciones y deploys

Crea, publica, reinicia y consulta apps, logs, métricas, runtimes, dominios e historial de deploy.

Bases de datos

Crea y opera PostgreSQL, MySQL, MongoDB y Redis con estado, métricas y credenciales cuando el alcance lo permita.

Archivos y entorno

Lee y cambia archivos, sube una carpeta local y administra variables sin exponer valores secretos en los listados.

Workspaces y cuenta

Consulta uso, miembros, roles, actividades, notificaciones y recursos compartidos del equipo.

Operación

Sigue despliegues, logs y el estado de los recursos sin salir de tu flujo de trabajo.

Snapshots y operación

Crea, restaura y descarga snapshots, limpia caché y acompaña la salud de los recursos sin salir del agente.

Dos formas de conectar

En el navegador o en tu computadora.

Usa el remoto cuando quieras entrar con tu cuenta. Usa el paquete local cuando el agente también necesite trabajar con los archivos del proyecto.

Conector remoto

Añade la URL a tu cliente, entra en Vertra y confirma los alcances. Sin instalar paquetes ni copiar una clave al navegador.

https://mcp.vertracloud.app/mcp

Paquete local

Ejecuta por stdio con Node 18 o posterior y proporciona VERTRA_API_KEY al proceso. Este modo habilita operaciones con archivos locales.

Control de acceso

El agente recibe solo lo que autorices.

MCP no evita las protecciones de la plataforma. Usa la API pública y respeta la clave, los alcances y la cuenta que autorizó la conexión.

Mínimo privilegio

Empieza con lectura y añade escritura solo donde el flujo realmente la necesite.

Secretos protegidos

Listar variables muestra nombres, nunca valores. Las operaciones sensibles exigen alcances propios.

Acceso revocable

Revoca la clave o la autorización en Vertra para cortar el acceso sin reconfigurar tu infraestructura.

Código abierto

Delgado por diseño. Público por confianza.

El proyecto @vertracloud/mcp es una capa pequeña sobre la API pública de Vertra: herramientas, transporte stdio y un servidor reutilizable. Sin base de datos, caché ni credencial propia. Lee el código, abre una issue o contribuye.

Abrir repositorio
Preguntas frecuentes

Antes de conectar.

Lo esencial sobre compatibilidad, cobro y acceso.

¿MCP cuesta algo además de mi plan?

Usar el servidor MCP no crea una suscripción separada. Las acciones siguen las mismas reglas y límites del recurso de Vertra que ya utilizas.

¿Qué cliente de IA puedo usar?

Cualquier cliente compatible con Model Context Protocol. El paquete local funciona por stdio; el conector remoto usa Streamable HTTP y autorización con tu cuenta Vertra.

¿El asistente ve mis variables de entorno?

La herramienta de listado devuelve solo los nombres. Definir o eliminar una variable exige su alcance específico, y el valor enviado nunca vuelve en la respuesta.

¿Por qué algunas herramientas son solo locales?

Crear una app desde una carpeta, subir archivos y descargar snapshots necesita leer o escribir en tu computadora. Un servidor remoto en el navegador no tiene ese acceso, ni debería tenerlo.

¿Puedo usarlo con un workspace?

Sí. Las herramientas de workspace permiten consultar recursos, miembros, roles, notas y uso según los permisos de tu cuenta y los alcances concedidos.

Empieza con lectura

Dale contexto real a tu asistente.

Crea una clave con los alcances mínimos, conecta el cliente y pídele listar tus apps. Después amplía solo lo necesario.

Crear clave de API