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

Cognition

# Windsurf / Devin Desktop에 MCP 서버 추가

Windsurf는 이제 Devin Desktop입니다. mcp_config.json을 읽지만, 파일 위치에 관해서는 공식 문서마다 안내가 다릅니다.

- **macOS**: `~/.config/devin/mcp_config.json (current Cascade doc); legacy ~/.codeium/windsurf/mcp_config.json; FAQ says ~/.codeium/mcp_config.json`
- **Windows**: `%APPDATA%\devin\mcp_config.json (current Cascade doc)`
- **Linux**: `~/.config/devin/mcp_config.json (or $XDG_CONFIG_HOME/devin/mcp_config.json)`
- **프로젝트 파일**: `.devin/mcp_config.json (Devin CLI / Devin Local project scope)`
- **최상위 키**: `mcpServers`
- **형식**: json
- **원격 서버용 OAuth**: 

## 설정 예시

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

`.devin/mcp_config.json`

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

`shell`

```
devin mcp add github https://api.githubcopilot.com/mcp/
devin mcp add playwright -- npx @playwright/mcp@latest
```

## 참고 및 특이사항

- Windsurf는 2026-06-02에 Devin Desktop으로 이름이 바뀌었으며, 이제 Devin Local이 기본 에이전트입니다.
- Cascade 문서에는 ~/.config/devin/mcp_config.json이, FAQ에는 ~/.codeium/mcp_config.json이 안내되어 있고, 이전 경로는 ~/.codeium/windsurf/mcp_config.json입니다. 사용 중인 빌드가 어느 경로를 읽는지 확인하세요.
- Devin Local에서는 .devin/mcp_config.json 및 .devin/mcp_config.local.json에 프로젝트 범위를 추가할 수 있습니다.
- 원격 항목에는 url, http 또는 sse 전송 방식, headers, oauthClientId, oauthClientSecret 및 oauthResource를 지정합니다. Cascade에서는 serverUrl도 사용할 수 있습니다.
- 값에는 ${env:VAR} 및 ${file:path}를 사용할 수 있으며, Cascade에서는 도구를 최대 100개까지 사용할 수 있습니다.

[Windsurf / Devin Desktop 설정 만들기 →](https://dotsagent.io/ko/mcp/config#client=windsurf)

## 다른 클라이언트

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

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

[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. [docs.windsurf.com](https://docs.windsurf.com/windsurf/cascade/mcp)/windsurf/cascade/mcp
2. [docs.devin.ai](https://docs.devin.ai/desktop/devin-desktop-faq)/desktop/devin-desktop-faq
3. [docs.devin.ai](https://docs.devin.ai/cli/extensibility/mcp/configuration.md)/cli/extensibility/mcp/configuration.md
4. [code.visualstudio.com](https://code.visualstudio.com/docs/copilot/customization/mcp-servers)/docs/copilot/customization/mcp-servers

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

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