dotsagent.io
언어:한국어
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 설정 만들기 →

다른 클라이언트

출처

  1. docs.windsurf.com/windsurf/cascade/mcp
  2. docs.devin.ai/desktop/devin-desktop-faq
  3. docs.devin.ai/cli/extensibility/mcp/configuration.md
  4. code.visualstudio.com/docs/copilot/customization/mcp-servers