Set up Gemini

Connect Google’s Gemini agents to the Amperity MCP server and sign in with your Amperity credentials. This page covers two clients:

Antigravity

Connect Antigravity to the Amperity MCP server by adding it as a custom remote MCP server and signing in with your Amperity credentials.

Requirements

Connecting Antigravity to the MCP server requires:

  • An active Amperity account with access to at least one tenant.

  • Antigravity installed and signed in.

Add the Amperity MCP server

Register the Amperity MCP server as a custom server in your Antigravity configuration.

  1. Open your global Antigravity MCP configuration file at ~/.gemini/config/mcp_config.json.

  2. Add the amperity server with Amperity’s OAuth client ID:

    {
      "mcpServers": {
        "amperity": {
          "serverUrl": "https://mcp.amperity.com",
          "oauth": {
            "clientId": "nwbd0MGCyh1VysmYQM05UoDXIuVPdGEs"
          }
        }
      }
    }
    

    Important

    Antigravity requires the serverUrl field for remote servers; the url and httpUrl fields are not supported. The oauth.clientId field is required so Antigravity surfaces the Authenticate button.

Authenticate

  1. Click Settings at the bottom left, then select the Customizations tab.

  2. Under Installed MCP Servers, click Authenticate next to the amperity server. A browser tab opens. Sign in with your Amperity OAuth credentials and select your tenant.

  3. Copy the authorization code from the browser, paste it back into the settings panel, and click Submit. The server reconnects automatically and its tools become available.

Start interacting with Antigravity

In an Antigravity agent session, ask:

"Tell me about my Amperity tenant."

Antigravity calls the tenant_info tool and returns details about your current Amperity tenant.

Gemini CLI

Connect Gemini CLI to the Amperity MCP server by adding it as a remote MCP server and signing in with your Amperity credentials.

Important

Gemini CLI only works for organizations on a Gemini Code Assist Standard or Enterprise license.

Requirements

Connecting Gemini CLI to the MCP server requires:

  • An active Amperity account with access to at least one tenant.

  • Gemini CLI installed and signed in.

Add the Amperity MCP server

Register the Amperity MCP server in your Gemini CLI configuration.

  1. Add the server:

    gemini mcp add --transport http --scope user amperity https://mcp.amperity.com
    
  2. Add Amperity’s OAuth client ID to the server entry. Open ~/.gemini/settings.json and add an oauth block to the amperity server so it matches the following:

    {
      "mcpServers": {
        "amperity": {
          "httpUrl": "https://mcp.amperity.com",
          "oauth": {
            "clientId": "nwbd0MGCyh1VysmYQM05UoDXIuVPdGEs",
            "authorizationUrl": "https://mcp.amperity.com/authorize",
            "tokenUrl": "https://mcp.amperity.com/oauth/token"
          }
        }
      }
    }
    

    Important

    The oauth.clientId field is required. Without it, Gemini CLI cannot authenticate to the Amperity MCP server.

Authenticate

  1. Start Gemini CLI, or restart it if it was already running, so it reloads settings.json:

    gemini
    
  2. Trigger the OAuth flow:

    /mcp auth amperity
    

    A browser tab opens. Sign in with your Amperity OAuth credentials. Gemini CLI reports a successful authentication and reloads the Amperity tools.

  3. Verify the server is connected:

    /mcp
    

    The amperity server appears with its available tools.

Start interacting with Gemini CLI

In a Gemini CLI session, ask:

"Tell me about my Amperity tenant."

Gemini CLI calls the tenant_info tool and returns details about your current Amperity tenant.