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

# Gemini CLI

> Connect Gemini CLI to Dreamtune MCP and install scoped workflow skills.

<img src="https://mintcdn.com/dreamtune/alDlJCy5wJhi5BBd/images/agents/gemini-cli.ico?fit=max&auto=format&n=alDlJCy5wJhi5BBd&q=85&s=051f5e59e6a2e1300dc82630746a43a2" alt="Gemini CLI official logo" width="48" height="48" data-path="images/agents/gemini-cli.ico" />

## Before you connect

Create a Dreamtune workspace API key with only the permissions you need.
Hosted HTTP setup needs no Dreamtune package installation. Local stdio setup
requires Node.js 22.20 or later and the published CLI.

## Configure

Merge this server entry into \~/.gemini/settings.json. Preserve any other servers or settings.

```json theme={null}
{
  "mcpServers": {
    "dreamtune": {
      "httpUrl": "https://mcp.dreamtunelabs.com/mcp",
      "headers": {
        "X-Dreamtune-API-Key": "${DREAMTUNE_API_KEY}"
      }
    }
  }
}
```

Set DREAMTUNE\_API\_KEY before launching Gemini CLI. httpUrl selects Streamable HTTP; url selects the legacy SSE transport and is not interchangeable. Inspect /mcp after restarting.

## Verify the connection

Restart the client after changing settings or its environment. Open its MCP
server/tool status view and check that Dreamtune tools are listed. Ask it:

> Use Dreamtune to read model request limits. Do not execute a model, tool or GPU.

Confirm model\_limits returns limits before authorizing paid work. Then inspect a
catalog schema and use one explicitly approved operation. Keep client approval
controls enabled. Never put the key in a chat message, URL or repository.

## Add workflow instructions

Install the [Dreamtune skills](/connect/skills-install) into the skills directory
supported by your client, or copy the platform skill into a user instruction
workflow. A skill guides the agent; MCP provides execution. Neither grants extra
key permissions. See [troubleshooting](/errors) for 401, missing scopes, timeouts
and key/environment problems.

Configuration verified against [the official client documentation](https://geminicli.com/docs/tools/mcp-server/).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.