Gemini CLI

SSE: поддерживается напрямую, мост не нужен.

Транспорт в Gemini CLI выбирается именем ключа: command → stdio, url → SSE, httpUrl → Streamable HTTP. Отдельного поля type нет.

Графического интерфейса нет — всё делается одной командой.

Способ 1 (рекомендуемый) — команда в терминале

# без токена
gemini mcp add --transport sse ozon http://localhost:8000/sse

# с токеном
gemini mcp add --transport sse --header "Authorization: Bearer <MCP_AUTH_TOKEN>" \
  ozon http://localhost:8000/sse

Флаги gemini mcp add: -t, --transport stdio|sse|http (по умолчанию stdio, поэтому --transport sse обязателен), -H, --header "Name: value" (можно повторять), -e, --env KEY=value, --timeout <ms>, -s, --scope user|project (по умолчанию project — для доступа из всех проектов берите -s user), --trust.

Способ 2 — правка файла конфигурации

Область	Путь
Пользователь (macOS, Linux)	`~/.gemini/settings.json`
Пользователь (Windows)	`%USERPROFILE%\.gemini\settings.json`
Проект	`<проект>/.gemini/settings.json`

Без токена:

{
  "mcpServers": {
    "ozon": {
      "url": "http://localhost:8000/sse",
      "timeout": 30000
    }
  }
}

С MCP_AUTH_TOKEN:

{
  "mcpServers": {
    "ozon": {
      "url": "http://localhost:8000/sse",
      "headers": {
        "Authorization": "Bearer <MCP_AUTH_TOKEN>"
      },
      "timeout": 30000
    }
  }
}

Проверка

Команда /mcp внутри Gemini CLI — статус подключения, список инструментов (должно быть 151), состояние discovery. Снаружи: gemini mcp list.

Оговорки

Нельзя задавать url и httpUrl одновременно для одного сервера.
Если сервер ответит 401, Gemini CLI попытается запустить OAuth-флоу (детект по коду ответа). Наш сервер OAuth не умеет — кладите токен сразу в headers, чтобы до 401 не доходило.
Таймаута по умолчанию может не хватить на холодный старт — задайте timeout.
OAuth-токены, если они всё-таки появятся, лежат в ~/.gemini/mcp-oauth-tokens.json.

Источники: gemini-cli MCP docs, docs site (проверено 19.08.2026).

FilesExpand file tree

install-gemini-cli.md

Latest commit

History