Qué es el MCP y para qué sirve
MCP (Model Context Protocol) amplía las capacidades de ARQVIS, tu Arquitecto Cloud Digital conectando Cursor o Antigravity con el Editor de Diagramas en la nube. Le das permiso para ver y modificar tus carpetas y diagramas con la misma cuenta con la que entras a la app.
Sirve para
- Pedir cambios al diagrama en lenguaje natural («añade una Lambda detrás del API Gateway»).
- Redactar o actualizar documentación, arquitectura y guías de despliegue.
- Preparar una revisión asistida basada en AWS Well-Architected.
- Guardar decisiones y resúmenes de sesión para la próxima conversación.
El resultado es un borrador técnico: revisa y aprueba cambios y evaluaciones antes de utilizarlos. MCP conecta el modelo de tu cliente con tus diagramas en la nube.
Cómo conectarlo
La conexión es remota: no necesitas instalar Python ni un servidor en tu máquina.
-
Inicia sesión Entra a Diagramas con Google y abre la aplicación (/app).
-
Genera una conexión En el panel izquierdo, abre Conexión MCP y pulsa Generar.
-
Copia tu token Copia la configuración (o el token). Guárdalo ahora: el token no se vuelve a mostrar.
-
Añádelo en Cursor Ajustes → MCP → pega la configuración del editor y activa el servidor.
-
Prueba algo simple «Abre el diagrama Motor de Notificaciones».
Otros clientes MCP remoto usan el mismo criterio: URL del servidor + token personal. La app genera ambos al crear la conexión.
Puedes tener varias conexiones (hasta el límite de tu plan) y revocarlas desde Conexión MCP si dejas de usar un equipo o sospechas que el token quedó expuesto.
Qué puedes hacer
Pide trabajo a ARQVIS en español (o el idioma que prefieras). Capacidades ampliadas mediante MCP:
Abrir un diagrama
Por nombre o por ID. Si hay homónimos, la IA te muestra candidatos.
Listar y crear
Ver carpetas y diagramas, o crear uno nuevo (AWS, Azure o GCP).
Metadatos
Documentación, arquitectura, guía de implementación y revisión Well-Architected asistida.
Explorar
Consultar layout, servicios, grupos y conexiones para razonar la arquitectura.
Editar
Añadir nodos y grupos. Auto-layout horizontal por defecto; respeta acomodo manual si lo pides.
Contexto
Resúmenes, decisiones y notas. Ideal al cerrar una sesión importante.
Estándares
Plantillas del servidor para documentación, arquitectura y revisiones homogéneas.
Flujo de trabajo recomendado
-
Conecta una vez Deja el MCP activo en Cursor.
-
Abre por nombre «Abre el diagrama X» — carga contexto y evita editar el equivocado.
-
Desambigua si hace falta Elige el correcto si hay varios con el mismo nombre.
-
Pide en lenguaje natural Arquitectura, documentación, Well-Architected, etc.
-
Guarda el contexto Al terminar, pide un resumen o las decisiones tomadas.
Tip: combina editor web y MCP. Dibuja a mano lo delicado; usa ARQVIS para preparar cambios, documentación y revisiones. El responsable humano conserva la aprobación final.
Documentación, arquitectura y revisión asistida
Cada diagrama guarda cuatro textos distintos. «Documenta el diagrama» no es lo mismo que «prepara una revisión Well-Architected». Sé específico:
Documentación técnica
El «readme»: qué hace el sistema, componentes, flujos y notas. Se guarda solo tu documento, no la plantilla del servidor.
Arquitectura
Secciones fijas definidas por el servidor: diseño, límites, integraciones y decisiones de alto nivel.
Guía de implementación
Manual paso a paso para implementar la arquitectura (orden de despliegue,
configuración por servicio, IAM/roles, verificación y rollback). El agente usa
get_implementation_guide_standard.
Revisión Well-Architected asistida
Diagnóstico orientativo pilar por pilar. Pide «revisa la arquitectura con Well-Architected». Aparece en Revisión asistida y queda pendiente de validación humana.
También puedes asociar un repositorio de código (URL y descripción breve) para que la IA sepa dónde vive la implementación.
Bloqueo MCP desde el editor web
Con el bloqueo MCP activo, la IA no puede cambiar el layout
del canvas (patch_diagram / update_diagram_layout).
Sí puede seguir editando Documentación, Arquitectura, Inventario, Secuencias, contexto y
otros metadatos.
Úsalo cuando
- El dibujo del diagrama está congelado para entrega o auditoría.
- Quieres que la IA documente o evalúe sin mover nodos ni flechas.
- Prefieres acomodar el canvas solo a mano en la web.
Para volver a permitir que la IA edite el layout, desbloquea MCP en el editor web y guarda si la app lo indica.
Preguntas frecuentes
¿La IA ve todos los diagramas de la empresa?
No. El token es personal: solo tus diagramas y los que te hayan compartido.
¿Necesito instalar algo en mi PC?
No. La conexión es remota. Solo configuras el servidor MCP en Cursor (o cliente compatible).
La IA no encuentra mi diagrama
Prueba el título exacto como aparece en la app, o pide listar tus diagramas. Si hay homónimos, elige el ID o título correcto de la lista.
Dice que no puede editar
Revisa si el diagrama tiene el bloqueo MCP activado en el editor web. Desbloquéalo y vuelve a pedir el cambio.
¿Puedo revocar el acceso?
Sí. En /app → Cursor MCP, revoca la conexión. El token deja de funcionar de inmediato.
Mejor forma de pedir cambios
Abre primero el diagrama, describe el flujo de izquierda a derecha, nombra servicios con claridad y, al final, pide guardar el contexto de la sesión.
¿Listo para conectar?
Entra a la app, genera tu conexión MCP y empieza a editar diagramas desde Cursor.