> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rings.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Gemini CLI

> Add the Rings MCP server to Google's Gemini CLI

## Add it from the command line

```bash theme={null}
gemini mcp add --transport http rings https://production-api.joinrings.com/mcp
```

Start `gemini` and run `/mcp` to see the server status and its tools. Gemini CLI
discovers the OAuth endpoints, opens your browser to sign in, and stores the
tokens in `~/.gemini/mcp-oauth-tokens.json`.

With an API key instead of OAuth:

```bash theme={null}
gemini mcp add --transport http --header "x-api-key: $RINGS_API_KEY" rings https://production-api.joinrings.com/mcp
```

## Or edit settings.json

Add the server to `~/.gemini/settings.json` (global) or `.gemini/settings.json`
(this project):

```json theme={null}
{
  "mcpServers": {
    "rings": {
      "httpUrl": "https://production-api.joinrings.com/mcp",
      "timeout": 30000
    }
  }
}
```

<Warning>
  Use `httpUrl` for the Rings server. The `url` key means SSE transport, and
  Rings serves Streamable HTTP.
</Warning>

To pass an API key here instead:

```json theme={null}
{
  "mcpServers": {
    "rings": {
      "httpUrl": "https://production-api.joinrings.com/mcp",
      "headers": {
        "x-api-key": "YOUR_RINGS_API_KEY"
      }
    }
  }
}
```

## Notes

* `/mcp` inside a session lists connection state and every discovered tool —
  the quickest way to confirm the connector works.
* Gemini CLI asks before each tool call. Setting `"trust": true` on the server
  skips those prompts; leave it off if the agent can perform writes.