Windsurf MCP 서버: Devin Desktop에 Sume 추가

Windsurf는 이제 Devin Desktop이며, 기본 에이전트인 Devin Local은 Devin CLI 설정 파일에서 MCP 서버를 읽으므로, Sume를 추가하려면 ~/.config/devin/mcp_config.json에 "url": "https://mcp.sume.com/mcp", "transport": "http", Authorization 헤더를 담은 sume 항목을 넣으세요. 레거시 Cascade 에이전트는 Cascade 패널에서 여는 mcp_config.json으로 MCP를 따로 설정하며, 여기서는 같은 서버에 serverUrl과 headers를 씁니다.

에디터 쪽 내용은 이제 Windsurf 문서가 옮겨 간 Devin 문서의 Devin Desktop FAQ, Devin Local 에이전트, Cascade MCP 설정, Devin CLI의 MCP 설정에서 가져왔습니다. Sume 쪽 내용은 OAuth와 API 키, MCP 도구와 게이트, MCP 빠른 시작에서 가져왔으며, 모두 2026-09-27에 확인했습니다. Sume는 Windsurf나 Devin용 확장 프로그램을 배포하지 않습니다. 에이전트가 Sume 원격 MCP 서버에 직접 연결합니다. Sume 기초 페이지는 호스팅 MCP가 여전히 동작하지만 현재 주 경로는 아니라고 설명합니다.

Windsurf MCP 서버는 무엇이 바뀌었나요?

Devin FAQ에 따르면 변경 시점은 June 2, 2026입니다. Devin Desktop은 Windsurf의 새 이름이며, IDE도 기능도 그대로이고, 문서는 docs.devin.ai로 옮겨졌습니다. 새 탭은 기본적으로 Devin Local 에이전트로 시작하고 새 대화는 Cascade로 시작하지 않지만, 기존 Cascade 대화는 기록과 사이드바에서 계속 열 수 있습니다.

Devin의 Cascade 페이지는 그 페이지의 mcp_config.json 설정이 레거시 Cascade 에이전트에만 적용되고, Devin Local은 대신 Devin CLI 설정 파일에서 MCP 서버를 설정한다고 설명합니다. 그러니 실제로 쓰는 에이전트에 맞춰 Sume를 설정하세요.

Devin Local 에이전트에는 Sume를 어떻게 추가하나요?

모든 프로젝트에 적용되는 사용자 파일 ~/.config/devin/mcp_config.json(Windows에서는 %APPDATA%\devin\mcp_config.json)이나, gitignore 대상인 프로젝트의 .devin/mcp_config.local.json을 편집하세요. .devin/mcp_config.json은 쓰지 마세요. 이 파일은 커밋되어 버전 관리로 공유됩니다. Devin 문서는 정적 토큰을 받는 서버라면 그 토큰을 headers에 넣고, API 키는 절대 버전 관리에 넣지 말라고 합니다. v3000.3 이전 버전은 mcpServers를 config.json 파일에 두었으며, 새 버전은 시작할 때 그 항목을 마이그레이션합니다.

"transport": "http"는 URL 기반 서버의 기본값이자 Sume 빠른 시작 문서가 요구하는 트랜스포트인 Streamable HTTP입니다. <SUME_API_KEY>를 실제 키로 바꾸세요. Sume는 키를 x-api-key 헤더로도 받습니다. API 키 세션에는 쓰기·유료 도구를 포함한 전체 호스팅 도구 세트가 보입니다. Devin 문서는 원격 서버용 OAuth 로그인도 설명하고, Sume 문서는 인터랙티브 클라이언트에 OAuth를 권장합니다. 이 글은 양쪽 문서가 모두 설명하고 Sume가 기존 사용자와 자동화를 위해 유지하는 키 헤더 방식을 씁니다.

{
  "mcpServers": {
    "sume": {
      "url": "https://mcp.sume.com/mcp",
      "transport": "http",
      "headers": { "Authorization": "Bearer <SUME_API_KEY>" }
    }
  }
}

레거시 Cascade 에이전트는 어떻게 하나요?

Devin 문서 페이지마다 Cascade mcp_config.json의 위치가 다르게 나와 있으므로, 경로로 찾지 말고 Cascade 패널에서 여세요. 패널 오른쪽 위의 … (Actions) 메뉴를 클릭하고, MCPs 섹션의 Open MCP config file 아이콘을 클릭한 뒤, mcpServers 아래에 서버를 추가하고 저장합니다. 원격 서버에는 serverUrl이나 url과 함께 headers를 씁니다. 이 파일은 headers에서 ${env:VAR_NAME} 보간을 지원하므로 키를 환경 변수에 둘 수 있으며, 설정되지 않은 변수는 빈 문자열이 됩니다. Enterprise 사용자는 먼저 설정에서 MCP를 켜야 합니다.

{
  "mcpServers": {
    "sume": {
      "serverUrl": "https://mcp.sume.com/mcp",
      "headers": { "Authorization": "Bearer ${env:SUME_API_KEY}" }
    }
  }
}

유료 Sume 도구가 승인을 거치게 하려면 어떻게 하나요?

Cascade와 달리 Devin Local은 기본적으로 어떤 MCP 도구든 호출하기 전에 승인을 요청합니다. 고정 규칙은 권한 설정에 allow, deny, ask 목록으로 넣으며, 이 목록은 mcp__sume__generate_video나 mcp__sume__* 같은 패턴으로 도구를 지정합니다. Sume 자체 게이트도 그대로 적용됩니다. 쓰기·유료 도구에는 idempotency_key가 필요하고, dry_run=true는 아무것도 제출하지 않고 접수 여부와 비용을 미리 보여 주며, 상한이 필요하면 max_spend_usd를 쓰세요.

Sume 연결은 어떻게 확인하나요?

에이전트에게 엔드포인트, 인증 출처, 안전 설정을 확인해 주는 mcp_health를 호출하게 한 뒤, 세션에 보이는 모든 도구를 확인하도록 tools_list를 호출하게 하세요. Sume MCP 도구 목록은 도구를 읽기, 쓰기, 유료로 나눠 정리합니다. 호스팅 MCP는 노트북의 파일을 읽을 수 없으므로, 로컬 파일은 업로드 URL, 클라이언트 PUT, assets_complete를 거쳐 Sume로 전달됩니다. VS Code 내장 MCP 지원은 VS Code 원격 MCP 서버를 참고하세요.