Gemini CLI에 MCP 서버 추가

Gemini CLI는 ~/.gemini/ 또는 프로젝트의 .gemini/ 폴더에 있는 settings.json에서 mcpServers를 읽습니다.

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

참고 및 특이사항

• 필드 이름에 따라 전송 방식이 결정됩니다. Streamable HTTP에는 httpUrl, SSE에는 url, stdio에는 command를 사용합니다.
• gemini mcp add는 -s user를 지정하지 않으면 프로젝트 범위에 설정을 저장합니다.
• includeTools와 excludeTools로 모델에 표시할 도구를 필터링합니다.
• OAuth 토큰은 ~/.gemini/mcp-oauth-tokens.json에 저장됩니다.

Gemini CLI 설정 만들기 →

다른 클라이언트