Паветта
Как подключить MCP-сервер к Gemini CLI
Gemini CLI читает MCP-серверы из mcpServers в settings.json и управляет ими командой gemini mcp. Транспорты: stdio, SSE и Streamable HTTP, для удалённых серверов есть OAuth.
Где лежит конфиг
~/.gemini/settings.jsonДля всех проектов.gemini/settings.jsonДля проекта (по умолчанию у gemini mcp add)Как добавить сервер
1
Локальный сервер
gemini mcp add -e API_KEY=123 -e DEBUG=true my-stdio-server /path/to/server arg1 arg2.
2
Удалённый сервер
gemini mcp add --transport http --header "Authorization: Bearer abc123" secure-http https://api.example.com/mcp/.
3
Для всех проектов
Добавьте -s user: без него запись уйдёт в .gemini/settings.json текущего проекта.
4
Через файл
В mcpServers: command, args и env для stdio, httpUrl и headers для Streamable HTTP, url для SSE.
Как проверить и удалить
Проверкаgemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.
Удалениеgemini mcp remove <имя>, для пользовательского файла с -s user. Выключить без удаления: gemini mcp disable <имя>, вернуть: gemini mcp enable <имя>.
ПеременныеВ env можно ссылаться на переменные как $VAR_NAME или ${VAR_NAME}, в Windows ещё %VAR_NAME%.
Скрытие секретовПеременные вида *TOKEN*, *SECRET*, *KEY* Gemini CLI серверу не передаёт. Нужную переменную впишите в env сервера явно.
Довериеtrust: true или флаг --trust отключает подтверждения вызовов для сервера.
Выбор инструментовincludeTools и excludeTools в конфиге или --include-tools и --exclude-tools в команде. excludeTools важнее.
OAuth/mcp auth показывает серверы, которым нужен вход, /mcp auth <имя> запускает вход.
Готовые конфиги для Gemini CLI
Нажмите на сервер, чтобы раскрыть конфиг в формате Gemini CLI.
Playwright MCPДаёт агенту настоящий браузер
{
"mcpServers": {
"playwright": {
"command": "npx",
"args": ["@playwright/mcp@latest"]
}
}
}
GitHub MCPПодключает агента к GitHub
{
"mcpServers": {
"github": {
"httpUrl": "https://api.githubcopilot.com/mcp/",
"headers": {
"Authorization": "Bearer <GitHub PAT>"
}
}
}
}
Context7 MCPПодтягивает в контекст агента свежую документацию и примеры кода…
{
"mcpServers": {
"context7": {
"httpUrl": "https://mcp.context7.com/mcp",
"headers": {
"Authorization": "Bearer <ключ Context7>"
}
}
}
}
Figma MCPПодключает агента к макетам Figma
{
"mcpServers": {
"figma": {
"command": "npx",
"args": ["-y", "figma-developer-mcp", "--stdio"],
"env": {
"FIGMA_API_KEY": "<ваш токен Figma>"
}
}
}
}
Chrome DevTools MCPДаёт агенту живой Chrome с инструментами DevTools
{
"mcpServers": {
"chrome-devtools": {
"command": "npx",
"args": ["-y", "chrome-devtools-mcp@latest"]
}
}
}
Filesystem MCPОткрывает агенту доступ к файлам в папках, которые вы перечислили при…
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/Users/username/Desktop",
"/path/to/other/allowed/dir"
]
}
}
}
Fetch MCPДаёт агенту читать веб-страницы
{
"mcpServers": {
"fetch": {
"command": "uvx",
"args": ["mcp-server-fetch"]
}
}
}
Memory MCPДаёт агенту долгую память между чатами
{
"mcpServers": {
"memory": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-memory"],
"env": {
"MEMORY_FILE_PATH": "<полный путь>/memory.jsonl"
}
}
}
}
Supabase MCPПодключает агента к проектам Supabase
{
"mcpServers": {
"supabase": {
"httpUrl": "https://mcp.supabase.com/mcp"
}
}
}
Notion MCPЛокальный сервер Notion поверх Notion API
{
"mcpServers": {
"notion": {
"command": "npx",
"args": ["-y", "@notionhq/notion-mcp-server"],
"env": {
"NOTION_TOKEN": "ntn_<токен интеграции>"
}
}
}
}
Blender MCPСвязывает агента с запущенным Blender
{
"mcpServers": {
"blender": {
"command": "uvx",
"args": ["mcp-for-blender"]
}
}
}
1С MCPПоказывает агенту метаданные и содержимое базы 1С:Предприятие
{
"mcpServers": {
"1c": {
"httpUrl": "http://<веб-сервер>/<имя публикации>/hs/mcp/",
"headers": {
"Authorization": "Basic <логин и пароль пользователя 1С>"
}
}
}
}Ограничения
!
Без -s user команда gemini mcp add пишет в проектный .gemini/settings.json.
!
Не используйте подчёркивание в имени сервера: правила политик делят имя по первому _ и могут молча не сработать.
!
stdio-серверы проверяются и показываются как Connected только в доверенной папке, доверие задаёт gemini trust.
!
Тайм-аут запроса по умолчанию 600 000 мс, то есть 10 минут.
Если не работает
При запуске пишет «MCP issues detected. Run /mcp list for status.»
Выполните /mcp list в сессии или gemini mcp list в терминале: там видна ошибка каждого сервера.
stdio-сервер в списке Disconnected
Если папка не доверенная, выполните gemini trust.
Сервер не видит ключ из окружения
Gemini CLI скрывает переменные с TOKEN, SECRET, KEY в имени. Впишите ключ в env сервера.
Частые вопросы
Куда gemini mcp add записывает сервер?
По умолчанию в .gemini/settings.json текущего проекта. С -s user — в ~/.gemini/settings.json, тогда сервер виден везде.
Как подключить сервер с токеном?
gemini mcp add --transport http --header "Authorization: Bearer ваш-токен" имя адрес. В файле это поле headers рядом с httpUrl.
Почему сервер не получает API-ключ из окружения?
Gemini CLI убирает из окружения переменные с KEY, TOKEN, SECRET и похожими словами в имени. Пропишите ключ в env сервера.
Как временно отключить сервер?
gemini mcp disable <имя>. С --session выключение действует только на текущую сессию.
Источники: github.com, github.com