Gemini

Use Search Scanner AI with the Gemini CLI.

Gemini CLI

Source: Gemini CLI MCP documentation. OAuth needs a browser on the same machine, so it does not work over plain SSH or in containers without a browser.

  1. Open ~/.gemini/settings.json (or .gemini/settings.json in a project) and add:
    settings.json
    {
      "mcpServers": {
        "ucartz-seo": {
          "httpUrl": "https://search-scanner.ucartz.com/mcp"
        }
      }
    }
  2. Start gemini and run /mcp auth ucartz-seo. The CLI discovers our sign-in service, registers itself and opens the browser.
  3. Check the permissions on the Ucartz page and choose Allow. Tokens are stored in ~/.gemini/mcp-oauth-tokens.json.

With a client ID and secret

Create a client in Settings, Connect AI with the redirect address http://localhost:8765/oauth/callback, then:

settings.json
{
  "mcpServers": {
    "ucartz-seo": {
      "httpUrl": "https://search-scanner.ucartz.com/mcp",
      "oauth": {
        "enabled": true,
        "clientId": "YOUR_CLIENT_ID",
        "clientSecret": "YOUR_CLIENT_SECRET",
        "authorizationUrl": "https://search-scanner.ucartz.com/oauth/authorize",
        "tokenUrl": "https://search-scanner.ucartz.com/oauth/token",
        "scopes": ["seo:read"],
        "redirectUri": "http://localhost:8765/oauth/callback"
      }
    }
  }
}

Gemini app and Google AI Studio