---
title: "MCP 클라이언트 설정: 앱 13개의 파일과 키 · DotsAgent"
description: "Claude Code부터 Zed까지 13개 MCP 클라이언트의 서버 설정 위치를 알아보세요. 설정 경로와 최상위 키, 형식, 원격 OAuth 지원 및 설정을 망가뜨리는 주의 사항을 확인할 수 있습니다."
url: https://dotsagent.io/ko/mcp/clients
---

연결 · 클라이언트 13개

# MCP 클라이언트 설정 레퍼런스

MCP 클라이언트마다 서버를 읽는 위치와 사용하는 키가 다르며, 설정 형식도 다를 수 있습니다. 이 표에서 각 클라이언트가 설정을 찾는 위치와 필요한 형식, 원격 서버의 OAuth를 지원하는지 확인하세요.

| 클라이언트 | 설정 파일 | 최상위 키 | 형식 | 원격 OAuth | CLI로 추가 |
| --- | --- | --- | --- | --- | --- |
| [Claude Desktop](https://dotsagent.io/ko/mcp/clients/claude-desktop)Anthropic | `~/Library/Application Support/Claude/claude_desktop_config.json` | `mcpServers` | json | — | — |
| [Claude Code](https://dotsagent.io/ko/mcp/clients/claude-code)Anthropic | `.mcp.json` | `mcpServers` | json | — | — |
| [Cursor](https://dotsagent.io/ko/mcp/clients/cursor)Anysphere | `.cursor/mcp.json` | `mcpServers` | json | — | — |
| [VS Code (GitHub Copilot)](https://dotsagent.io/ko/mcp/clients/vscode-copilot)Microsoft | `.vscode/mcp.json (key 'servers') or portable .mcp.json (key 'mcpServers')` | `servers` | json | — | — |
| [Windsurf / Devin Desktop](https://dotsagent.io/ko/mcp/clients/windsurf)Cognition | `.devin/mcp_config.json (Devin CLI / Devin Local project scope)` | `mcpServers` | json | — | — |
| [Zed](https://dotsagent.io/ko/mcp/clients/zed)Zed Industries | `~/.config/zed/settings.json` | `context_servers` | json | — | — |
| [OpenAI Codex CLI](https://dotsagent.io/ko/mcp/clients/codex-cli)OpenAI | `.codex/config.toml (trusted projects only)` | `mcp_servers` | toml | — | — |
| [Gemini CLI](https://dotsagent.io/ko/mcp/clients/gemini-cli)Google | `.gemini/settings.json` | `mcpServers` | json | — | — |
| [ChatGPT](https://dotsagent.io/ko/mcp/clients/chatgpt)OpenAI | 설정 화면에서만 가능 | — | — | — | — |
| [OpenClaw](https://dotsagent.io/ko/mcp/clients/openclaw)OpenClaw | `~/.openclaw/openclaw.json` | `mcp.servers` | json5 | — | — |
| [Cline](https://dotsagent.io/ko/mcp/clients/cline)Cline Bot Inc. | `~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json` | `mcpServers` | json | — | — |
| [Continue](https://dotsagent.io/ko/mcp/clients/continue)Continue Dev | `.continue/mcpServers/<name>.yaml (or drop a Claude/Cursor/Cline-style mcp.json into .continue/mcpServers/)` | `mcpServers` | yaml | — | — |
| [JetBrains AI Assistant](https://dotsagent.io/ko/mcp/clients/jetbrains-ai)JetBrains | 설정 화면에서만 가능 | `mcpServers` | json (pasted in UI) | — | — |

## 설정을 망가뜨리는 차이점

### VS Code는 servers를 사용합니다

.vscode/mcp.json은 항목을 mcpServers가 아닌 servers 아래에 지정하므로 Cursor 또는 Claude 설정을 그대로 붙여 넣으면 로드되지 않습니다. 최신 포터블 설정 파일인 .mcp.json과 ~/.copilot/mcp-config.json은 mcpServers를 사용합니다.

### Gemini CLI에서는 url이 아니라 httpUrl을 사용합니다

Gemini CLI는 필드 이름으로 전송 방식을 결정합니다. httpUrl은 Streamable HTTP, url은 이전 SSE 전송 방식, command는 stdio를 뜻합니다. 최신 원격 서버에는 httpUrl을 사용하세요.

### OpenClaw와 Cline은 기본적으로 SSE를 사용합니다

원격 항목에서 전송 방식을 지정하지 않으면 두 클라이언트 모두 이전 SSE로 대체됩니다. OpenClaw에서는 transport를 streamable-http로, Cline에서는 type을 streamableHttp로 설정하세요.

### Claude Code에는 type이 필요합니다

.mcp.json에서 url은 있지만 type이 없는 원격 항목은 오류입니다. url 옆에 type http를 추가하세요. stdio 항목에는 type stdio를 사용합니다.

### Codex는 TOML이며 서버마다 테이블 하나를 사용합니다

Codex에는 JSON 파일이 없습니다. 각 서버는 config.toml의 자체 [mcp_servers.<name>] 테이블에 정의합니다. args는 TOML 배열이며, env_vars를 사용하면 이름으로 셸의 secret을 전달할 수 있습니다.

### Continue에는 YAML 목록이 필요합니다

Continue에서 mcpServers는 이름을 키로 사용하는 맵이 아니라, 각 항목에 name이 있는 목록입니다. 각 블록 파일의 맨 위에도 name, version, schema: v1이 있어야 합니다.

[설정 생성 →](https://dotsagent.io/ko/mcp/config)

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

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