Skip to main content

Setup Guide: KSI Vision MCP Server in Google Antigravity

This guide details the steps required to integrate and authenticate the KSI Vision Model Context Protocol (MCP) server in your development environment using Google Antigravity.

The integration allows your AI assistant to securely access KSI Vision's physical space analytics and people counting tools using OAuth authentication.

1. Prerequisites​

Before starting, make sure you have:

  • A KSI Vision account with access to create API Tokens (if you do not have access, request it at ksi.support@ksivision.com or support@ksivision.com).
  • Google Antigravity installed (either the CLI version agy or the Desktop App Antigravity 2.0).

2. Configuration in Antigravity 2.0 (Desktop App)​

To use the MCP server inside the desktop visual application, follow these steps:

Step 2.1: Access the Configuration File​

  1. Open the Antigravity 2.0 desktop app.
  2. In the left panel of the assistant, click on the ... options menu (located in the top-right corner of the panel).
  3. Select Manage MCP Servers.
  4. Click on the View raw config button. This will open the global mcp_config.json configuration file in your default editor.
note

The physical path of this file on your machine is: C:\Users\<Your-Username>\.gemini\config\mcp_config.json

Step 2.2: Add the KSI Vision Server​

Paste the following configuration block inside the "mcpServers" object of the JSON file:

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

If you already have other servers configured, simply add the "ksivision" key to the existing "mcpServers" object.

Step 2.3: Authentication​

  1. Save your changes and close the editor.
  2. In the desktop app's configuration window, you will see a new row for the ksivision server.
  3. Click the Authenticate button next to the server.
  4. A tab will open in your web browser. Log in with your KSI Vision credentials and authorize access.
  5. Once completed, the server status will change to Connected.

3. Configuration in Antigravity CLI (agy)​

If you use the terminal-based workflow via the agy command, perform the following steps:

Step 3.1: Configure the Configuration File​

Make sure to add the server in the command-line specific configuration file:

  • File path: C:\Users\<Your-Username>\.gemini\antigravity-cli\mcp_config.json
  • Content to add: 
    {
      "mcpServers": {
        "ksivision": {
          "serverUrl": "https://mcp.ksivision.com/api/mcp",
          "oauth": {}
        }
      }
    }

Step 3.2: Start and Authenticate in the Terminal​

  1. Start your Antigravity CLI session by typing agy in your terminal.
  2. To verify that the server is configured, run the following command: 
    /mcp
  3. The CLI's interactive interface will show the ksivision server and prompt you to press Enter to open the OAuth authentication in your web browser.
  4. Complete the authentication in the browser and copy the verification code back to the terminal if prompted.

4. Verification​

Once connected, you can query Antigravity directly about KSI Vision data. For example, try sending the following prompt:

"What are the current traffic and occupancy metrics in our registered stores on KSI Vision?"

The assistant will transparently use the MCP tools under your authenticated identity to retrieve information from the KSI Vision sandbox.

important

OAuth access tokens will be automatically refreshed and securely stored in your operating system's keyring, so you will not need to repeatedly authenticate in daily use.