Gemini CLI

Use a Stepwik API key that is separate from your Gemini auth.

Steps

1. 1

   Create an API key

   Create a Stepwik API key in Studio.

2. 2

   Edit settings.json

   Add the mcpServers block to ~/.gemini/settings.json (or project .gemini/settings.json).

3. 3

   Use httpUrl

   Gemini CLI uses httpUrl for Streamable HTTP MCP servers.

4. 4

   Restart and verify

   Restart the CLI and verify with /mcp list.

Config path

~/.gemini/settings.json
.gemini/settings.json

Config

{
  "mcpServers": {
    "stepwik": {
      "httpUrl": "https://mcp.stepwik.com/mcp",
      "headers": {
        "stepwik-api-key": "stepwik_<id>_<secret>"
      }
    }
  }
}

Related