---
title: "Gemini CLI MCP 설정: 파일 경로, 키, 예시 · DotsAgent"
description: "Google의 MCP 서버를 Gemini CLI에 추가하는 방법을 알아보세요. 설정 파일 위치, 최상위 키와 형식, 원격 OAuth 지원, 설정 예시를 확인할 수 있습니다."
url: https://dotsagent.io/ko/mcp/clients/gemini-cli
---

Google

# 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를 추가합니다.

`.gemini/settings.json`

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

`shell`

```
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 설정 만들기 →](https://dotsagent.io/ko/mcp/config#client=gemini-cli)

## 다른 클라이언트

[Claude Desktop](https://dotsagent.io/ko/mcp/clients/claude-desktop)

[Claude Code](https://dotsagent.io/ko/mcp/clients/claude-code)

[Cursor](https://dotsagent.io/ko/mcp/clients/cursor)

[VS Code (GitHub Copilot)](https://dotsagent.io/ko/mcp/clients/vscode-copilot)

[Windsurf / Devin Desktop](https://dotsagent.io/ko/mcp/clients/windsurf)

[Zed](https://dotsagent.io/ko/mcp/clients/zed)

[OpenAI Codex CLI](https://dotsagent.io/ko/mcp/clients/codex-cli)

[ChatGPT](https://dotsagent.io/ko/mcp/clients/chatgpt)

[OpenClaw](https://dotsagent.io/ko/mcp/clients/openclaw)

[Cline](https://dotsagent.io/ko/mcp/clients/cline)

[Continue](https://dotsagent.io/ko/mcp/clients/continue)

[JetBrains AI Assistant](https://dotsagent.io/ko/mcp/clients/jetbrains-ai)

## 출처

1. [geminicli.com](https://geminicli.com/docs/tools/mcp-server/)/docs/tools/mcp-server/
2. [raw.githubusercontent.com](https://raw.githubusercontent.com/google-gemini/gemini-cli/main/docs/tools/mcp-server.md)/google-gemini/gemini-cli/main/docs/tools/mcp-server.md

AI 에이전트를 만드는 개발자를 위한 독립적인 참고 자료입니다. 여기에 언급된 어떤 업체와도 제휴 관계가 없습니다.

© 2026 DotsAgent · 정보 확인일: 2026년 10월 1일