Langflow MCP 클라이언트: Sume 호스팅 MCP 서버 추가

Langflow는 MCP Tools 컴포넌트를 통해 MCP 클라이언트로 동작합니다. Settings > MCP Servers > Add MCP Server에서 서버를 등록하고, MCP 사이드바에서 캔버스로 끌어다 놓은 뒤, Tool mode를 켜고, 컴포넌트의 Toolset 포트를 Agent의 Tools 포트에 연결하세요. Sume 호스팅 MCP 서버라면 HTTP/SSE를 고르고 https://mcp.sume.com/mcp를 입력한 다음, Bearer와 Sume API 키를 담은 Credential 전역 변수를 값으로 하는 Authorization 헤더를 추가하세요.

Langflow 쪽 내용은 Langflow 1.12.x용 페이지인 Langflow를 MCP 클라이언트로 사용하기에서, Sume 쪽 내용은 MCP OAuth와 API 키, MCP 도구와 게이트, Job과 결과 (영문)에서 가져왔으며, 모두 2026-09-28에 확인했습니다. Sume에는 Langflow 전용 연동이 없습니다. Langflow는 다른 원격 MCP 서버와 똑같이 Sume 원격 MCP 서버에 연결하며, Sume 기초 페이지는 호스팅 MCP가 여전히 동작하지만 현재 주 경로는 아니라고 설명합니다. Langflow는 자체 플로를 위한 MCP 서버 역할도 할 수 있지만, 이 글은 클라이언트 쪽을 다룹니다. 다른 비주얼 빌더는 n8n MCP Client Tool과 Sume에서 다룹니다.

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

Langflow 1.9.x부터 MCP Tools는 Agents 아래에서 끌어다 놓을 수 있는 컴포넌트가 아니므로, 서버를 먼저 등록해야 합니다. 1.12.x에서는 다음과 같이 합니다.

• 키를 저장하세요. 프로필 아이콘, Settings, Global Variables를 차례로 클릭하고 SUME_BEARER 같은 Credential 변수를 만드세요. 값에는 Bearer 접두사와 공백 하나, 그 뒤에 Sume API 키가 들어가야 합니다.
• Sume를 등록하세요. Settings > MCP Servers를 열고 Add MCP Server를 클릭하거나, 플로 편집기 왼쪽 사이드바에서 MCP를 클릭한 뒤 Add MCP Server를 클릭하세요. HTTP/SSE를 고르고 Name에는 sume, Streamable HTTP/SSE URL에는 https://mcp.sume.com/mcp를 입력한 다음, 헤더를 하나 추가하세요. 키는 Authorization, 값은 SUME_BEARER입니다. 연결에 성공하면 Langflow가 서버가 노출하는 도구 개수를 보여 줍니다.
• 새 서버를 MCP 사이드바에서 캔버스로 끌어다 놓으세요. 그러면 이 서버용 MCP Tools 컴포넌트가 추가됩니다.
• 컴포넌트의 Tool 필드에서 Sume 도구 하나를 고르거나, 모든 도구를 쓰려면 비워 두세요.
• 컴포넌트의 헤더 메뉴에서 Tool mode를 켜고, 컴포넌트의 Toolset 포트를 Agent의 Tools 포트에 연결하세요. 플로에 Chat Input과 Chat Output이 없다면 Agent에 붙이세요.
• Playground를 열고, 연결한 도구를 쓰는 프롬프트를 입력하세요.

MCP Tools 컴포넌트마다 어떤 Sume 도구를 맡겨야 하나요?

컴포넌트마다 하나씩입니다. Tool 필드를 비워 두면 서버가 제공하는 모든 도구가 에이전트에 주어지고, API 키 세션에는 유료 도구를 포함한 Sume의 전체 호스팅 도구 세트가 보입니다. Langflow의 MCP 클라이언트 페이지는 에이전트가 도구를 호출하기 전의 승인 단계를 설명하지 않으므로, 모든 도구를 가진 에이전트는 스스로 판단해 유료 Job을 시작할 수 있습니다. Langflow 문서는 도구가 더 필요하면 도구 컴포넌트를 더 추가하라고 안내합니다. 컴포넌트마다 Sume 도구를 하나씩 맡기고, 모든 Toolset을 Agent에 연결하세요.

Sume 유료 도구에는 각각 idempotency_key가 필요하고, dry_run=true는 제출하지 않고 접수 여부와 비용을 미리 보여 주며, max_spend_usd는 값을 보낸 경우에만 호출의 상한이 됩니다. 이 인수들은 에이전트가 작성하므로, 여러분의 플로가 강제하는 한도가 아닙니다. 또한 호스팅 MCP는 노트북의 파일을 읽을 수 없습니다.

긴 Sume 렌더링은 Langflow에서 타임아웃되나요?

Langflow의 MCP 클라이언트 페이지에는 도구 호출 타임아웃이 나와 있지 않으며, Sume는 렌더링 내내 호출 하나를 붙잡아 두지 않습니다. jobs_wait는 호출당 최대 55초 뒤에 반환합니다. wait_slice_expired를 받으면 에이전트는 같은 id로 다시 호출해야 하며, 유료 create는 절대 다시 제출하면 안 됩니다. 이 패턴은 긴 영상 Job의 MCP 도구 호출 타임아웃에서 다룹니다.

Sume 서버가 연결되지 않으면 어떻게 하나요?

• Langflow는 서버를 호출하기 전에 전역 변수를 값으로 바꾸고, 그 값을 검증하지 않고 넘깁니다. 그래서 잘못된 키는 Sume가 호출을 거부할 때에야 드러납니다.
• MCP Tools 컴포넌트에 설정한 헤더는 서버의 헤더보다 우선합니다. 키 헤더는 두 개가 아니라 하나만 두세요.
• verify_ssl의 기본값은 true입니다. 켜 둔 채로 두세요.
• 관리자가 MCP 서버 관리를 잠갔다면, 서버를 추가할 때 잠김 메시지가 표시됩니다.