Saltar al contenido principal

Guía de Configuración: Servidor MCP de KSI Vision en Google Antigravity

Esta guía detalla los pasos necesarios para integrar y autenticar el servidor de Model Context Protocol (MCP) de KSI Vision en su entorno de desarrollo utilizando Google Antigravity.

La integración permite que su asistente de IA acceda de forma segura a las herramientas de análisis físico y conteo de personas de KSI Vision utilizando autenticación OAuth.

1. Requisitos Previos​

Antes de comenzar, asegúrese de contar con:

  • Cuenta de KSI Vision con acceso a crear API Tokens (si no tienes acceso solicítalo a ksi.soporte@ksivision.com o a support@ksivision.com).
  • Google Antigravity instalado (ya sea en su versión CLI agy o la App de Escritorio Antigravity 2.0).

2. Configuración en Antigravity 2.0 (App de Escritorio)​

Para utilizar el servidor MCP dentro de la aplicación visual de escritorio, siga estos pasos:

Paso 2.1: Acceder al archivo de configuración​

  1. Abra la aplicación de escritorio Antigravity 2.0.
  2. En el panel lateral izquierdo del asistente, haga clic en el menú de opciones ... (ubicado en la esquina superior).
  3. Seleccione Manage MCP Servers.
  4. Haga clic en el botón View raw config. Esto abrirá el archivo de configuración global mcp_config.json en su editor predeterminado.
nota

La ruta física de este archivo en su equipo es: C:\Users\<Su-Usuario>\.gemini\config\mcp_config.json

Paso 2.2: Agregar el servidor de KSI Vision​

Pegue el siguiente bloque de configuración dentro del objeto "mcpServers" del archivo JSON:

{
  "mcpServers": {
    "ksivision": {
      "serverUrl": "https://mcp.ksivision.com/api/mcp",
      "oauth": {}
    }
  }
}

Si ya tiene otros servidores configurados, simplemente agregue la clave "ksivision" al objeto "mcpServers" existente.

Paso 2.3: Autenticación​

  1. Guarde los cambios y cierre el editor.
  2. En la ventana de configuración de la app de escritorio, verá una nueva fila para el servidor ksivision.
  3. Haga clic en el botón Authenticate al lado del servidor.
  4. Se abrirá una pestaña en su navegador web. Inicie sesión con sus credenciales de KSI Vision y autorice el acceso.
  5. Una vez completado, el estado del servidor cambiará a Connected.

3. Configuración en Antigravity CLI (agy)​

Si utiliza el flujo de trabajo en la terminal a través del comando agy, realice los siguientes pasos:

Paso 3.1: Configurar el archivo de configuración​

Asegúrese de agregar el servidor en el archivo de configuración exclusivo para la línea de comandos:

  • Ruta del archivo: C:\Users\<Su-Usuario>\.gemini\antigravity-cli\mcp_config.json
  • Contenido a agregar: 
    {
      "mcpServers": {
        "ksivision": {
          "serverUrl": "https://mcp.ksivision.com/api/mcp",
          "oauth": {}
        }
      }
    }

Paso 3.2: Iniciar y autenticar en la terminal​

  1. Ejecute su sesión de Antigravity CLI escribiendo agy en su terminal.
  2. Para verificar que el servidor esté configurado, ejecute el comando: 
    /mcp
  3. La interfaz interactiva del CLI le mostrará el servidor ksivision y le pedirá presionar Enter para abrir la autenticación OAuth en su navegador web.
  4. Complete la autenticación en el navegador y copie el código de verificación de vuelta en la terminal si se le solicita.

4. Verificación de Funcionamiento​

Una vez que el estado de conexión sea exitoso, podrá consultar directamente a Antigravity sobre datos de KSI Vision. Por ejemplo, puede probar enviando el siguiente prompt al asistente en el chat:

"¿Cuáles son las métricas de tráfico y ocupación actuales en nuestras tiendas registradas en KSI Vision?"

El asistente usará de forma transparente las herramientas del MCP bajo su identidad autenticada para recuperar la información del sandbox de KSI Vision.

important

Los tokens de acceso OAuth se refrescarán automáticamente y se almacenarán de forma segura en el llavero de credenciales (keyring) de su sistema operativo, por lo que no necesitará autenticarse repetidamente en el uso diario.