Open WebUI MCP 서버: Sume 호스팅 MCP 연결하기

Open WebUI(v0.6.31 이상)는 Streamable HTTP로 MCP 서버에 연결하며, 서버는 관리자만 추가할 수 있습니다. Settings > Admin > Integrations에서 External Tool Servers 아래의 + Add Connection을 누르고, Type을 MCP (Streamable HTTP)로 고르세요. Sume 호스팅 MCP 서버라면 https://mcp.sume.com/mcp를 입력하고 인증 방식을 고르세요. OAuth 2.1은 사용자마다 자기 Sume 계정으로 로그인하게 하고, Sume API 키를 쓰는 Bearer는 연결을 공유받은 모든 사용자를 키 하나에 묶습니다.

Open WebUI 쪽 내용은 MCP 문서에서, Sume 쪽 내용은 MCP OAuth와 API 키, MCP 빠른 시작, MCP 도구와 게이트에서 가져왔으며, 모두 2026-09-27에 확인했습니다. Sume에는 Open WebUI 전용 연동이 없으며, Sume 기초 페이지는 호스팅 MCP가 여전히 동작하지만 현재 주 경로는 아니라고 설명합니다.

Open WebUI에 MCP 서버를 어떻게 추가하나요?

• 먼저 WEBUI_SECRET_KEY 환경 변수를 설정하세요. 이 값이 없으면 컨테이너를 재시작하거나 다시 만들 때마다 OAuth로 연결한 MCP 도구가 망가집니다(Error decrypting tokens).
• Settings > Admin > Integrations를 열고 External Tool Servers 아래에서 + Add Connection을 클릭하세요.
• Type은 OpenAPI가 아니라 MCP (Streamable HTTP)로 설정하세요. OpenAPI 연결에 MCP 형식의 JSON을 넣으면 UI가 크래시되거나 끝없이 로딩 상태로 남을 수 있습니다.
• Server URL에 https://mcp.sume.com/mcp를 입력하고 인증 모드를 고른 뒤 Save를 누르세요. 재시작하라는 안내가 나오면 Open WebUI를 재시작하세요.
• MCP 서버는 설계상 관리자만 추가할 수 있습니다. 사용자에게 도구를 주려면 연결을 한 번 추가하고, Access Control로 사용자나 그룹에 범위를 지정하세요.

OAuth 2.1과 Bearer 키 중 무엇을 써야 하나요?

Open WebUI 문서는 서버가 동적 클라이언트 등록(DCR)을 지원하면 OAuth 2.1로 시작하라고 하며, 현재 Sume 서버는 등록 엔드포인트를 알립니다. OAuth 2.1에서는 사용자마다 자기 계정을 연결합니다. 누군가 채팅의 Integrations 메뉴에서 도구를 처음 켜면 Open WebUI가 그 사용자를 Sume로 보내고, 부여된 권한은 그 사용자의 계정에만 저장됩니다.

Sume 동의 페이지에서는 Read가 켜진 채 고정되고 Write는 기본적으로 꺼져 있습니다. Write를 끈 채로 둔 사용자는 읽기 도구만 쓸 수 있고, generate_image 같은 유료 도구는 insufficient_scope를 반환합니다. OAuth Scopes를 사용자 지정 스코프로 바꾼다면, 현재 Sume 서버는 mcp:read와 mcp:write만 받습니다.

채팅 사용자가 Sume 도구를 호출하면 비용은 누가 내나요?

Bearer에서는 모든 호출이 Sume API 키 하나로 실행됩니다. Sume API 키와 지출은 워크스페이스 단위로 해석되고, 관리자가 추가한 연결은 범위로 지정한 사용자들과 공유되므로, 그 사용자 모두가 그 워크스페이스 하나에서 비용을 씁니다. 어느 쪽 문서도 이를 한 문장으로 말하지는 않으며, 두 문서를 함께 보면 따라 나오는 결론입니다.

OAuth 2.1에서는 사용자마다 자기 Sume 계정으로 로그인하고 동의합니다. OAuth 2.1 도구를 모델의 기본 도구로 설정하지 마세요. 로그인에는 브라우저 리다이렉트가 필요한데, 요청 도중에는 리다이렉트가 일어날 수 없습니다. 또한 Open WebUI는 첫 로그인 뒤 토큰을 자동으로 갱신하지만, 현재 Sume 서버는 한 시간짜리 액세스 토큰을 발급하고 리프레시 토큰은 발급하지 않으므로, 사용자는 한 시간 뒤에 다시 인가해야 합니다.

채팅이 쓸 수 있는 Sume 도구는 어떻게 제한하나요?

연결의 Function Name Filter List를 채우세요. 이 목록은 모델에 노출되는 도구를 제한하며, Open WebUI 문서에 따르면 비워 두면 대부분의 경우 모든 도구가 노출됩니다. mcp_health, tools_list, jobs_wait, jobs_result 같은 Sume 읽기 도구와, 사용자가 쓸 수 있게 하려는 유료 도구만 나열하세요. 유료 호출마다 idempotency_key가 필요하고, dry_run=true는 비용을 미리 보여 주며, max_spend_usd는 값을 넘긴 경우에만 호출의 상한이 됩니다.

한계는 무엇인가요?

• Open WebUI에 내장된 MCP 지원은 Streamable HTTP 전용입니다.
• Check OAuth Discovery는 디스커버리 문서를 가져와 파싱할 뿐입니다. MCP 서버에 접속하거나 도구를 나열하지는 않으므로, 결과가 초록색이어도 도구 호출이 동작한다는 증거는 아닙니다.
• 현재 Sume OAuth 서버는 일반 http 리다이렉트 주소를 localhost나 127.0.0.1에서만 받으며, https 주소는 받습니다. Open WebUI는 WEBUI_URL에 설정된 주소에서 로그인을 마무리하므로, 사용자가 그 밖의 주소로 접속한다면 HTTPS로 제공하세요.
• 호스팅 MCP는 사용자의 노트북에 있는 파일을 읽을 수 없으며, generate_image의 레퍼런스 이미지는 공개 HTTPS URL이어야 합니다.