Conector para asistentes de IA (MCP)

IteraVirtus en Claude, ChatGPT y otros asistentes

Conecta tu asistente de IA al catastro vial y de aguas lluvias de tu empresa en IteraVirtus: busca obras, lee sus fichas, razona sobre la red de drenaje y la hidráulica, cita el Manual de Carreteras y el Manual de Drenaje Urbano (solo normativa chilena) y obtén el certificado de origen de cada dato. Las escrituras siempre pasan por la aprobación de una persona.

URL del servidor

http://127.0.0.1:34689/api/mcp/

Necesitas una cuenta de IteraVirtus de tu empresa. El asistente actúa con tus permisos y solo con los alcances que autorices.

Cómo conectarlo

Claude

Planes Pro, Max, Team o Enterprise (web, escritorio y móvil).

  1. Entra a claude.ai › Personalizar › Conectores y pulsa + › Agregar conector personalizado.
  2. Ponle de nombre «IteraVirtus» y pega la URL del servidor MCP. Pulsa Agregar.
  3. Pulsa Conectar: se abre IteraVirtus, inicias sesión y pulsas Autorizar.
  4. ¿Lo conectas desde la app del asistente en un teléfono Android con la app IteraVirtus instalada? Antes, mantén presionado el ícono de IteraVirtus › Información de la app › Definir como predeterminada (en otras marcas: Abrir de forma predeterminada) y desactiva Abrir vínculos admitidos (o «Abrir enlaces compatibles»). Así la autorización se abre en el navegador; al terminar puedes volver a activarlo. Si el navegador muestra «404», borra los datos de iteravirtus.cl en ese navegador y reintenta. Más simple: conéctalo desde un computador; la conexión sirve también en el teléfono.
  5. En Team o Enterprise lo agrega primero el administrador en Configuración de la organización › Conectores; después cada persona se conecta.
  6. Claude Code (terminal): claude mcp add --transport http iteravirtus http://127.0.0.1:34689/api/mcp/ y luego /mcp para iniciar sesión.

ChatGPT

Planes Plus, Pro, Business, Enterprise o Education, en la web.

  1. En chatgpt.com abre Configuración › Seguridad e inicio de sesión y activa el Modo desarrollador. En Business o Enterprise lo habilita antes el administrador.
  2. Ve a la sección de aplicaciones/conectores y pulsa + para crear una app con la URL del servidor MCP.
  3. En autenticación elige OAuth: ChatGPT se registra solo. Inicia sesión en IteraVirtus y pulsa Autorizar.
  4. En un chat, activa la app desde el botón + del cuadro de texto (Modo desarrollador).
  5. ¿Lo conectas desde la app del asistente en un teléfono Android con la app IteraVirtus instalada? Antes, mantén presionado el ícono de IteraVirtus › Información de la app › Definir como predeterminada (en otras marcas: Abrir de forma predeterminada) y desactiva Abrir vínculos admitidos (o «Abrir enlaces compatibles»). Así la autorización se abre en el navegador; al terminar puedes volver a activarlo. Si el navegador muestra «404», borra los datos de iteravirtus.cl en ese navegador y reintenta. Más simple: conéctalo desde un computador; la conexión sirve también en el teléfono.

VS Code (GitHub Copilot)

VS Code 1.101 o superior con Copilot.

  1. Abre la paleta de comandos (Ctrl+Shift+P) y ejecuta MCP: Add Server.
  2. Elige HTTP, pega la URL del servidor MCP, llámalo «iteravirtus» y elige Global (para todos tus proyectos).
  3. VS Code pide permiso para autenticarse: acepta, inicia sesión en IteraVirtus y pulsa Autorizar.
  4. Usa el chat de Copilot en modo Agente: las herramientas de IteraVirtus aparecen en el selector de herramientas.

Cursor

Cursor de escritorio.

  1. Abre el archivo ~/.cursor/mcp.json (o .cursor/mcp.json en tu proyecto) y pega esto (si ya tiene otros servidores, agrega solo la entrada «iteravirtus»):
    { "mcpServers": { "iteravirtus": { "url": "http://127.0.0.1:34689/api/mcp/" } } }
  2. En la configuración de MCP de Cursor aparece «iteravirtus» pidiendo iniciar sesión: pulsa conectar, inicia sesión en IteraVirtus y Autoriza.

Gemini

La app web de Gemini solo acepta apps propias en EE. UU. y en inglés; desde Chile usa Gemini CLI.

  1. Gemini CLI (terminal): gemini mcp add --transport http iteravirtus http://127.0.0.1:34689/api/mcp/
  2. Abre gemini y escribe /mcp auth iteravirtus: se abre el navegador, inicias sesión y pulsas Autorizar.
  3. Donde esté disponible, en gemini.google.com › Configuración › Apps conectadas › Agregar una app propia se pega la misma URL.

Qué puede hacer

Ejemplos

  • «¿Qué obras de arte del tramo 2 del proyecto Ruta 5 están en mal estado y no tienen ficha de conservación?»
  • «¿Dónde descarga la alcantarilla OAT 102 y qué obras escurren hacia ella?»
  • «¿Qué dice el Manual de Carreteras sobre el ancho mínimo de una cuneta? Cita la sección.»
  • «Dame el certificado de origen del sumidero S-100: quién lo levantó y si cumple la norma.»
  • «Registra una limpieza de drenaje hecha hoy en el sumidero S-100 (me muestras el borrador antes de guardar).»

Autorización, seguridad y privacidad

  • OAuth 2.1 con PKCE: inicias sesión en IteraVirtus y eliges qué permisos das (la lectura es obligatoria). Puedes desconectar el asistente cuando quieras desde Mi Perfil.
  • El administrador de tu empresa decide si se permiten asistentes, con qué permisos y qué herramientas; y si las escrituras quedan en una bandeja para aprobarlas.
  • Las escrituras nunca se confirman solas: el asistente prepara un borrador y una persona lo aprueba.
  • Se omiten o enmascaran datos personales (RUT, correos, teléfonos) en lo que se envía a modelos de IA, conforme a la Ley 21.719. Cada llamada queda registrada para tu empresa.
  • Detalle en la política de privacidad y los términos y condiciones.

Soporte

Escríbenos a contacto@iteravirtus.cl. Iteravirtus SpA, Santiago de Chile.