Windsurf에 MCP 서버 추가하는 방법 (mcp_config.json)

Windsurf의 Cascade 에이전트용 로컬·원격 MCP 서버를 mcp_config.json에서 설정하는 방법: 파일 위치, 원격 서버용 serverUrl, 도구 끄기.

1. mcp_config.json 열기

Cascade 패널 오른쪽 위의 …(Actions) 메뉴를 누르고 MCPs 섹션에서 Open MCP config file을 선택하세요. 현재 문서에 따르면 파일은 macOS와 Linux에서는 ~/.config/devin/mcp_config.json, Windows에서는 %APPDATA%\devin\mcp_config.json에 있습니다(Windsurf는 이제 Devin Desktop의 일부이며, 이전 Windsurf 버전은 ~/.codeium/windsurf/mcp_config.json을 사용했습니다). 메뉴로 열면 항상 올바른 파일이 열립니다.

2. 로컬(stdio) 서버 추가

mcpServers 아래에 항목을 추가하세요. Claude Desktop, Cursor와 같은 형식입니다.

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

3. 원격 서버 추가

원격 HTTP 서버는 명령 대신 serverUrl(또는 url)을 씁니다. 무료 Socketlist 서버 예시:

{
  "mcpServers": {
    "socketlist": {
      "serverUrl": "https://socketlist.pages.dev/mcp"
    }
  }
}

서버에 API 키가 필요하면 headers 객체를 추가하세요.

4. 비밀 값은 파일에 적지 않기

설정 파일은 command, args, env, serverUrl, url, headers에서 ${env:VAR_NAME}과 ${file:/path/to/file}을 지원합니다.

5. 서버와 도구 켜고 끄기

Actions 메뉴의 MCPs 섹션에서 서버마다 토글로 켜고 끌 수 있습니다. 특정 도구를 숨기려면 서버 항목에 "disabledTools": ["tool_name"]을 추가하세요. Cascade는 한 번에 최대 100개의 도구를 사용할 수 있습니다.

참고

이 내용은 Cascade 에이전트에 해당합니다. 새로운 Devin Local 에이전트는 MCP 서버를 Devin CLI 설정에 저장합니다. 출처: Cascade 공식 MCP 문서.