Warp MCP 서버: 에이전트에 Sume 호스팅 MCP 추가

Warp에 MCP 서버를 추가하려면 Settings > Agents > MCP servers를 열고 + Add를 클릭한 뒤 서버 설정을 붙여 넣으세요. Warp가 실행하는 CLI 서버라면 command를, Streamable HTTP나 SSE 서버라면 url을 씁니다. Sume 호스팅 서버의 URL은 https://mcp.sume.com/mcp입니다. 자격 증명 없이 시작하면 Warp가 브라우저 로그인(OAuth)을 열고, 아니면 headers에 Sume API 키를 Bearer 토큰으로 넣으면 됩니다.

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

Warp에 Sume MCP 서버를 어떻게 추가하나요?

아래 방법 중 하나로 MCP servers 페이지를 연 다음 + Add를 클릭하세요. Warp는 대부분의 MCP 클라이언트에서 복사한 설정을 받으며, URL 서버에는 필수인 url과 선택인 headers를 씁니다.

• Settings > Agents > MCP servers로 들어갑니다.
• Warp Drive에서 Personal > MCP Servers를 엽니다.
• 명령 팔레트에서 Open MCP Servers를 검색합니다.

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

Warp는 OAuth로 로그인해야 하나요, API 키를 써야 하나요?

OAuth를 쓰면 Sume API 키가 Warp에 들어가지 않습니다. Warp는 브라우저에서 로그인을 처리하고 자격 증명을 기기에 저장하며, 새 기기에서는 다시 로그인해야 합니다. 자격 증명은 MCP Servers 창에서 취소할 수 있습니다. Sume 동의 페이지에서 Read는 켜진 채 고정되고 Write는 기본적으로 꺼져 있습니다. Write가 꺼져 있으면 generate_image 같은 유료 도구는 숨겨지고, 호출하면 insufficient_scope를 반환합니다. Warp 에이전트가 미디어를 생성해야 한다면 Write를 켜세요. 현재 코드에서 Sume OAuth 토큰은 한 시간 동안 유효하고 Sume는 리프레시 토큰을 발급하지 않으므로, 그 뒤에는 다시 로그인해야 한다고 생각하세요.

API 키를 쓰려면 Warp의 커스텀 헤더 방식으로 Bearer 토큰을 전달합니다. 항목에 "headers": { "Authorization": "Bearer <SUME_API_KEY>" }를 추가하세요. API 키 세션에는 쓰기·유료 도구를 포함한 전체 호스팅 도구 세트가 보입니다. Warp 문서는 서버를 공유할 때 env 설정의 민감한 값은 지운다고 하지만 headers에 대해서는 아무 말도 하지 않으며, MCP 로그에 API 키가 들어 있을 수 있다고 경고합니다. 헤더에 키가 들어 있는 동안에는 서버나 그 로그를 공유하지 말고, 로그나 채팅 기록에 키가 나타나면 교체하세요.

Sume 서버를 설정 파일에 둘 수 있나요?

네. Warp는 ~/.warp/.mcp.json과 프로젝트 루트의 .warp/.mcp.json에서 파일 기반 서버를 읽으며, ~/.warp/.mcp.json의 서버는 기본적으로 자동 실행됩니다. 프로젝트 범위 서버는 절대 자동 실행되지 않습니다. MCP servers 페이지에서 서버마다 직접 켜야 하고, 재시작한 뒤에도 다시 켜야 합니다. OAuth가 필요한 파일 기반 서버는 처음 실행될 때 인증 모달을 띄우므로, Sume URL만 담은 프로젝트 파일이라면 시크릿이 저장소에 들어가지 않습니다. 내장 /agent-add-mcp 스킬이 두 파일 중 어느 쪽이든 대신 작성해 줄 수 있으며, Warp는 MCP 설정 파일을 편집할 때 여러분의 승인을 요청합니다.

Warp가 Sume를 호출하기 전에 묻게 하려면 어떻게 하나요?

Warp의 MCP 권한은 서버 단위이며 각 Agent Profile 안에 들어 있습니다. MCP 허용 목록(allowlist)에 있는 서버는 에이전트가 묻지 않고 호출하고, MCP 거부 목록(denylist)에 있는 서버는 허용 목록에도 올라 있더라도 호출 전에 승인이 필요합니다. “Agent decides”는 에이전트가 확신할 때는 자율적으로 실행하고, 확신하지 못할 때는 묻습니다. 모든 호출이 여러분을 기다리게 하려면 Sume를 거부 목록에 넣으세요. Run until completion은 현재 작업 동안 에이전트가 묻지 않고 진행하게 하므로, Sume 유료 도구를 쓸 수 있는 동안에는 꺼 두세요.

어느 쪽이든 Sume 게이트는 그대로 적용됩니다. 모든 유료 호출에는 idempotency_key가 필요하고, dry_run=true는 제출하지 않고 접수 여부와 비용을 미리 보여 주며, max_spend_usd는 값을 넘긴 경우에만 호출의 상한이 됩니다.

긴 영상 Job은 타임아웃되나요? 테스트는 어떻게 하나요?

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

설정을 테스트하려면 에이전트에게 엔드포인트, 인증 출처, 안전 설정을 확인해 주는 mcp_health를 호출한 다음 tools_list를 호출해 달라고 하세요. 호출이 실패하면 MCP servers 페이지에서 해당 서버의 View Logs 버튼으로 Warp의 MCP 로그를 볼 수 있습니다.