Google Clients¶

Gemini adds the Qualytics MCP server as a custom app. Custom apps can only be added in the Gemini web app, and once added they also appear in the Gemini mobile app.

1. Open Gemini in your browser at gemini.google.com.
2. Go to Settings > Connected Apps.
3. At the bottom of the list, select Add a custom app.
4. Paste your Qualytics MCP URL: https://your-qualytics-instance.qualytics.io/api/mcp/, then select Next. Leave any client ID and client secret empty, so Gemini registers its own client with Qualytics.
5. Review the security and privacy warning and accept it.
6. When Gemini opens the Qualytics authorization page, paste your Qualytics API token and approve the access.
7. Confirm that the Qualytics tools are listed, then save the app.

You can disconnect Qualytics at any time from Settings > Connected Apps.

1. Register the server for all your projects:

   gemini mcp add --transport http --scope user qualytics https://your-qualytics-instance.qualytics.io/api/mcp/
   

   Without --scope user, the server is saved only for the current project. You can also add it by hand to ~/.gemini/settings.json, using the httpUrl key:

   {
     "mcpServers": {
       "qualytics": {
         "httpUrl": "https://your-qualytics-instance.qualytics.io/api/mcp/"
       }
     }
   }
   

2. Start Gemini CLI. When it connects to Qualytics for the first time, it finds the authorization details, registers itself, and opens your browser. You can also start the sign-in with /mcp auth qualytics.

3. On the Qualytics authorization page, paste your Qualytics API token and approve the access.
4. Run /mcp list to confirm the server shows as CONNECTED with its tools.

Leave out the oauth and headers properties. Gemini CLI registers its own client with Qualytics, and Qualytics does not accept an API token in a header.

The browser sign-in does not work in a session without a browser, such as a remote SSH session or a container. Sign in from a machine that can open one.