Añadir servidores MCP a Gemini CLI

Gemini CLI lee mcpServers de settings.json en ~/.gemini/ o en la carpeta .gemini/ del proyecto.

macOS

~/.gemini/settings.json

Windows

~/.gemini/settings.json

Linux

~/.gemini/settings.json

Archivo del proyecto

.gemini/settings.json

Clave de nivel superior

mcpServers

Formato

json

OAuth para servidores remotos

●Sí

Ejemplo de configuración

Este ejemplo añade el servidor alojado de GitHub y Playwright como servidor local, con el formato que espera este cliente.

{
  "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

Notas y particularidades

• El nombre del campo determina el transporte: httpUrl para Streamable HTTP, url para SSE y command para stdio.
• gemini mcp add escribe en el ámbito del proyecto, salvo que indiques -s user.
• includeTools y excludeTools filtran las herramientas que ve el modelo.
• Los tokens de OAuth se guardan en ~/.gemini/mcp-oauth-tokens.json.

Crear una configuración para Gemini CLI →

Otros clientes