Zed MCP 서버: context_servers에 Sume 추가

Zed에 MCP 서버를 추가하려면 Settings → AI → MCP Servers를 열고 Add Server를 클릭한 뒤, Zed가 실행할 명령이면 Add Local Server를, URL이면 Add Remote Server를 고르거나 Install from Extensions를 선택하세요. 커스텀 서버는 설정 파일의 context_servers 아래에 저장됩니다. Sume 호스팅 서버라면 url이 https://mcp.sume.com/mcp인 원격 서버를 추가하세요. Authorization 헤더가 없으면 Zed가 표준 MCP OAuth 플로로 로그인하게 하고, 헤더가 있으면 대신 Sume API 키를 보냅니다.

Zed 쪽 내용은 Model Context Protocol과 도구 권한 페이지에서, Sume 쪽 내용은 MCP 빠른 시작, OAuth와 API 키, MCP 도구와 게이트, Job과 결과 (영문)에서 가져왔으며, 모두 2026-09-27에 확인했습니다. 따로 밝힌 부분은 현재 서버 코드에서 가져왔습니다. Sume에는 Zed 확장도, 전용 커넥터도 없으며, 이 방식은 일반적인 원격 MCP 연결입니다. Sume 기초 페이지는 호스팅 MCP가 여전히 동작하지만 현재 주 연동 경로는 아니라고 설명합니다.

Zed에 Sume 호스팅 MCP 서버를 어떻게 추가하나요?

Settings → AI → MCP Servers에서 MCP Servers 페이지를 열거나, agent: open settings 액션을 실행하고 MCP Servers를 선택하세요. 페이지 헤더의 Add Server를 클릭한 다음 Add Remote Server를 클릭합니다. 설정 파일을 직접 편집해도 됩니다(zed: open settings file). 최소 항목에는 이름과 URL만 있으면 됩니다.

{
  "context_servers": {
    "sume": {
      "url": "https://mcp.sume.com/mcp"
    }
  }
}

Zed는 OAuth로 로그인해야 하나요, API 키를 보내야 하나요?

Sume는 둘 다 받습니다. Authorization 헤더를 빼면 Zed가 표준 MCP OAuth 플로로 인증하라고 안내합니다. Sume 동의 페이지에서 Read는 켜진 채 고정되고 Write는 기본적으로 꺼져 있습니다. 읽기 전용 세션에는 읽기 도구만 보입니다. generate_image 같은 유료 도구는 숨겨지고, 호출하면 insufficient_scope를 반환합니다. Zed 에이전트가 미디어를 생성해야 한다면 Write를 켜세요. 현재 코드에서 Sume OAuth 토큰은 한 시간 동안 유효하고 Sume는 리프레시 토큰을 발급하지 않으므로, 그 뒤에는 다시 로그인해야 한다고 생각하세요.

API 키를 쓰려면 항목에 "headers": { "Authorization": "Bearer <SUME_API_KEY>" }를 추가하세요. Sume는 x-api-key 헤더도 받지만, Zed 문서는 Authorization 헤더가 없을 때 OAuth 안내를 띄운다고 설명하므로 여기서는 Bearer 형식을 쓰세요. API 키 세션에는 쓰기·유료 도구를 포함한 전체 호스팅 도구 세트가 보입니다. 이때 키는 Zed 설정에 저장되므로 절대 커밋하지 말고 채팅에 붙여 넣지도 마세요. 로그나 채팅 기록에 키가 나타나면 교체하세요.

연결되면 MCP Servers 페이지에서 sume 옆의 점이 초록색으로 바뀌고 “Server is active” 툴팁이 표시됩니다. Zed Agent는 서버를 직접 사용하며, Zed는 Agent Client Protocol을 통해 External Agents에도 이 서버를 전달할 수 있습니다.

Sume 유료 도구가 실행되기 전에 Zed가 묻게 하려면 어떻게 하나요?

Zed v0.224.0 이상에서는 agent.tool_permissions.default가 이를 정합니다. 기본값인 confirm은 MCP 도구 호출을 포함해 모든 도구 동작 전에 확인을 요청하고, allow는 자동으로 승인하며, deny는 모든 도구 동작을 막습니다. 도구별 규칙에서는 MCP 도구를 mcp:<server>:<tool_name> 형식으로 지정합니다. MCP 도구에는 패턴 규칙이 빈 문자열을 대상으로 매칭되므로, 도구별 default를 제어 수단으로 써야 합니다. 도구별 기본값은 전역 기본값보다 우선하므로, 아래 설정을 쓰면 나중에 전역 기본값을 allow로 바꾸더라도 유료 도구는 계속 확인을 요청합니다.

{
  "agent": {
    "tool_permissions": {
      "default": "confirm",
      "tools": {
        "mcp:sume:tools_list": { "default": "allow" },
        "mcp:sume:jobs_wait": { "default": "allow" },
        "mcp:sume:generate_video": { "default": "confirm" }
      }
    }
  }
}

영상이 렌더링되는 동안 Zed가 타임아웃되나요?

Zed MCP 페이지에는 컨텍스트 서버의 도구 호출 타임아웃이 나와 있지 않고, Sume는 대기 한 번을 짧게 유지합니다. jobs_wait는 호출 한 번을 최대 55초, 기본 50초 동안 열어 둡니다. 대기가 wait_slice_expired로 끝나면 에이전트는 같은 id로 jobs_wait를 다시 호출해야 하며, 유료 create는 절대 다시 제출하면 안 됩니다. 전체 패턴은 긴 영상 Job의 MCP 도구 호출 타임아웃에 있습니다.

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

에이전트에게 엔드포인트, 인증 출처, 안전 설정을 확인해 주는 mcp_health를 호출하게 한 뒤, 세션에 보이는 모든 도구를 나열하는 tools_list를 호출하게 하세요. Zed는 프롬프트에 서버 이름을 넣으면 모델이 그 서버의 도구를 고르는 데 도움이 될 수 있다고 설명합니다. 도구 호출이 실패하면 Zed는 에이전트 응답에 서버의 오류 메시지를 보여 줍니다. OAuth 세션에서 그 메시지가 insufficient_scope라면 Sume MCP의 insufficient_scope 해결하기에서 설명하듯 Write가 꺼져 있다는 뜻입니다.