Connect Gemini CLI to Taufinity Studio

Gemini CLI supports MCP servers via ~/.gemini/settings.json. The Taufinity CLI writes the right entry — note that Gemini uses httpUrl (not url) for HTTP transport.

30-second TL;DR

1. Obtain your bearer token from Studio → Settings → API Keys.
2. Add the server entry to ~/.gemini/settings.json (see Installation).
3. Start a new gemini session and ask "list my Taufinity sites".

Prerequisites

• Gemini CLI installed (gemini --version works).
• The taufinity CLI signed in.

Installation

Option 1: One-command install

taufinity mcp install --client gemini-cli

Config file location

• macOS: ~/.gemini/settings.json
• Linux: ~/.gemini/settings.json
• Windows: %USERPROFILE%\.gemini\settings.json

Option 2: Manual install — paste this snippet

{
  "mcpServers": {
    "taufinity": {
      "httpUrl": "https://studio.taufinity.io/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TAUFINITY_TOKEN>"
      }
    }
  }
}

Notes

• Gemini CLI uses "httpUrl" (not "url") for HTTP transport.

Manual config

Gemini CLI uses httpUrl (not url) for HTTP transport. Edit ~/.gemini/settings.json:

{
  "mcpServers": {
    "taufinity-studio": {
      "httpUrl": "https://studio.taufinity.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TAUFINITY_TOKEN"
      }
    }
  }
}

Get your token from Studio → Settings → API Keys or taufinity auth token.

Verify it works

Verify it works

Start a new gemini session and ask "list my Taufinity sites".

Available tools

Same ~70 tools. See Claude Code → Available tools.

Troubleshooting

Symptom	Cause	Fix
Gemini doesn't see the server	Used url instead of httpUrl	Re-run taufinity mcp install --client gemini-cli
tools/list 401	Token expired	Re-run taufinity auth login

See also

• GitHub Copilot CLI — alternative terminal MCP client