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

OpenClaw

# OpenClaw에 MCP 서버 추가

OpenClaw는 ~/.openclaw/openclaw.json(JSON5 파일)의 mcp.servers에서 서버를 읽거나 openclaw mcp add로 서버를 추가합니다.

- **macOS**: `~/.openclaw/openclaw.json`
- **Windows**: `~/.openclaw/openclaw.json`
- **Linux**: `~/.openclaw/openclaw.json`
- **최상위 키**: `mcp.servers`
- **형식**: json5
- **원격 서버용 OAuth**: 

## 설정 예시

이 예시는 이 클라이언트가 요구하는 형식으로 GitHub 호스팅 서버와 로컬 서버인 Playwright를 추가합니다.

`~/.openclaw/openclaw.json`

```
{
  "mcp": {
    "servers": {
      "github": {
        "url": "https://api.githubcopilot.com/mcp/",
        "transport": "streamable-http"
      },
      "playwright": {
        "command": "npx",
        "args": [
          "@playwright/mcp@latest"
        ]
      }
    }
  }
}
```

`shell`

```
openclaw mcp add github --url https://api.githubcopilot.com/mcp/ --transport streamable-http
openclaw mcp add playwright --command npx --arg @playwright/mcp@latest
```

## 참고 및 특이사항

- 원격 항목에는 항상 transport를 설정하세요. transport가 없으면 OpenClaw는 레거시 SSE를 사용합니다.
- openclaw mcp doctor <name> --probe로 설정된 서버를 테스트합니다.
- openclaw mcp login <name>은 원격 서버에 대한 OAuth를 실행합니다.
- openclaw mcp serve를 실행하면 OpenClaw 자체를 MCP 서버로 사용할 수 있습니다.

[OpenClaw 설정 만들기 →](https://dotsagent.io/ko/mcp/config#client=openclaw)

## 다른 클라이언트

[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)

[Gemini CLI](https://dotsagent.io/ko/mcp/clients/gemini-cli)

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

[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. [docs.openclaw.ai](https://docs.openclaw.ai/tools/mcp)/tools/mcp
2. [docs.openclaw.ai](https://docs.openclaw.ai/cli/mcp)/cli/mcp
3. [docs.openclaw.ai](https://docs.openclaw.ai/cli/mcp/transports)/cli/mcp/transports
4. [docs.openclaw.ai](https://docs.openclaw.ai/gateway/config-extensions)/gateway/config-extensions

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

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