Добавление MCP-серверов в Gemini CLI

Gemini CLI считывает mcpServers из settings.json в ~/.gemini/ или из папки .gemini/ проекта.

macOS

~/.gemini/settings.json

Windows

~/.gemini/settings.json

Linux

~/.gemini/settings.json

Файл проекта

.gemini/settings.json

Ключ верхнего уровня

mcpServers

Формат

json

OAuth для удалённых серверов

●Да

Пример конфигурации

В этом примере добавлены размещённый сервер GitHub и Playwright в качестве локального сервера — в формате, который ожидает этот клиент.

{
  "mcpServers": {
    "github": {
      "httpUrl": "https://api.githubcopilot.com/mcp/"
    },
    "playwright": {
      "command": "npx",
      "args": [
        "@playwright/mcp@latest"
      ]
    }
  }
}

gemini mcp add -s project -t http github https://api.githubcopilot.com/mcp/
gemini mcp add -s project playwright npx @playwright/mcp@latest

Примечания и особенности

• Имя поля определяет транспорт: httpUrl для Streamable HTTP, url для SSE, command для stdio.
• Команда gemini mcp add добавляет сервер в настройки проекта, если не указать -s user.
• includeTools и excludeTools определяют, какие инструменты доступны модели.
• Токены OAuth сохраняются в ~/.gemini/mcp-oauth-tokens.json.

Создать конфигурацию Gemini CLI →

Другие клиенты