Kilo Code MCP 서버: kilo.jsonc에 Sume 추가하기

Kilo Code에 MCP 서버를 추가하려면 Kilo 설정 파일의 최상위 mcp 키 아래에 넣으세요. 프로젝트의 kilo.jsonc나, 모든 프로젝트에 적용되는 ~/.config/kilo/kilo.jsonc가 그런 파일이며, 확장 프로그램의 MCP 설정도 같은 파일에 기록됩니다. Sume 호스팅 MCP 서버라면 항목은 "type": "remote"와 "url": "https://mcp.sume.com/mcp"로 이루어지고, 여기에 Sume API 키를 담은 Authorization: Bearer 헤더를 더하거나, 헤더 없이 OAuth 로그인을 씁니다. OAuth를 지원하는 서버라면 Kilo가 로그인을 자동으로 시작합니다.

Kilo 쪽 내용은 VS Code 탭과 CLI 탭의 내용이 가끔 다른 Kilo Code에서 MCP 사용하기 페이지에서, Sume 쪽 내용은 MCP OAuth와 API 키, MCP 도구와 게이트, Job과 결과 (영문)에서 가져왔으며, 모두 2026-09-28에 확인했습니다. Sume에는 Kilo Code 전용 커넥터가 없습니다. Kilo는 다른 원격 MCP 서버와 똑같이 Sume 원격 MCP 서버에 연결하며, Sume 기초 페이지는 호스팅 MCP가 여전히 동작하지만 현재 주 경로는 아니라고 설명합니다. 형제 확장 프로그램은 각각 Roo Code와 Cline 글에서 다룹니다.

Kilo Code의 MCP 설정은 어디에 두나요?

VS Code 확장 프로그램에서 MCP 서버는 Kilo 메인 설정 파일에 두 단계로 들어가며, 프로젝트 단계가 전역 단계에 우선합니다. 확장 프로그램에서 Settings → MCP를 열고 Add Server를 클릭한 뒤 Remote (HTTP)를 선택하고, URL과 선택 사항인 헤더를 입력해도 됩니다.

• 전역: ~/.config/kilo/kilo.jsonc. 모든 프로젝트에 적용됩니다.
• 프로젝트: 프로젝트 루트의 kilo.jsonc, 또는 .kilo/kilo.jsonc입니다.
• CLI는 같은 위치에 kilo.json을 두라고 권장하며, kilo.jsonc도 읽습니다.
• {env:SUME_API_KEY}는 환경 변수를 읽으므로, 커밋할 수도 있는 파일에 키가 들어가지 않습니다.

{
  "mcp": {
    "sume": {
      "type": "remote",
      "url": "https://mcp.sume.com/mcp",
      "headers": {
        "Authorization": "Bearer {env:SUME_API_KEY}"
      },
      "enabled": true,
      "timeout": 60000
    }
  }
}

Kilo에서는 API 키와 OAuth 중 무엇을 써야 하나요?

Sume 호스팅 MCP는 둘 다 받지만, 동작은 서로 다릅니다.

• API 키: Sume는 Authorization: Bearer나 x-api-key를 받습니다. 키 세션에는 유료 도구를 포함한 Sume의 전체 호스팅 도구 세트가 보이며, 지출은 그 키의 워크스페이스로 귀속됩니다.
• OAuth: headers를 빼세요. 확장 프로그램에서는 상태가 needs_auth가 되면 로그인을 시작하는 알림이 뜨고, CLI에는 kilo mcp auth가 있습니다. "oauth": false로 두면 OAuth가 꺼집니다.
• Sume 동의 페이지에서 Write는 기본적으로 꺼져 있으며, Write가 없으면 generate_image 같은 유료 도구는 insufficient_scope를 반환합니다. 현재 코드에서 Sume 토큰은 한 시간 동안 유효하고 리프레시 토큰은 발급되지 않으므로, 다시 로그인해야 한다고 예상해 두세요.

Kilo가 묻지 않고 유료 Sume 도구를 실행하지 않게 하려면 어떻게 하나요?

Kilo는 MCP 도구 호출을 자체 권한 시스템을 거쳐 실행합니다. 각 도구의 권한 키는 {server}_{tool}이므로, 이름이 sume인 서버에 있는 Sume의 generate_video는 sume_generate_video입니다. 도구가 호출되면 Permission Dock이 승인을 요청하고, Approve Always를 누르면 허용 규칙이 저장되며, 설정 파일의 permission 키에는 도구 이름이나 와일드카드 패턴을 넣을 수 있습니다. Sume 인증 문서는 쓰기나 유료 생성 전에 명시적 확인을 요구하라고 안내하므로, 읽기 도구만 허용하세요.

• sume_*는 허용하지 마세요. 이 와일드카드를 쓰면 유료 도구까지 자동 승인됩니다.
• 유료 도구에는 idempotency_key가 필요합니다. dry_run=true는 제출하지 않고 비용을 미리 보여 주며, max_spend_usd는 값을 보낸 경우에만 호출의 상한이 됩니다.

{
  "permission": {
    "sume_mcp_health": "allow",
    "sume_tools_list": "allow",
    "sume_tools_schema": "allow",
    "sume_jobs_wait": "allow",
    "sume_jobs_result": "allow"
  }
}

원격 항목의 각 필드는 어떤 역할을 하나요?

timeout은 왜 설정하나요? 그 밖에 무엇을 알아야 하나요?

• Sume jobs_wait 호출 한 번은 최대 55초, timeout_seconds를 생략하면 50초 동안 대기합니다. Kilo의 CLI 탭은 timeout을 도구를 가져오는 데 쓰는 타임아웃이라고 설명하지만, 이 값이 도구 호출에도 적용되는지는 페이지에 나와 있지 않습니다. 그래서 예제는 Sume 대기 한 번을 온전히 넘는 값을 설정합니다.
• wait_slice_expired를 받으면 에이전트는 같은 id로 jobs_wait를 다시 호출해야 하며, 유료 create는 절대 다시 제출하면 안 됩니다. 이 패턴은 긴 영상 Job의 MCP 도구 호출 타임아웃에서 다룹니다.
• enabled: false로 두면 항목을 지우지 않고도 Sume 서버를 끌 수 있습니다.
• 호스팅 MCP는 노트북의 파일을 읽을 수 없습니다.