n8n MCP Client Tool과 Sume: 설정과 SSE 주의점

n8n은 MCP Client Tool 필드를 SSE Endpoint라 부르지만 Sume는 streamable HTTP를 문서화합니다. 설정하고 연결을 테스트한 뒤 유료 호출은 승인받게 하세요.

읽는 시간 5분Sume
전체 글

Sume API 키를 담은 Bearer Auth 자격 증명으로 n8n MCP Client Tool이 Sume 호스팅 엔드포인트 https://mcp.sume.com/mcp를 가리키게 할 수는 있지만, 이 조합이 연결된다고 문서화한 쪽은 없습니다. n8n 문서는 노드의 URL 필드를 SSE Endpoint라고 부르고, Sume는 엔드포인트를 streamable HTTP 클라이언트용으로 문서화합니다. 노드를 AI Agent에 연결하고 Tools to Include를 Selected로 설정한 뒤, 이 연결 위에 무언가를 만들기 전에 에이전트가 Sume mcp_health 도구를 호출하게 하세요.

n8n 쪽 내용은 MCP Client Tool, Tools Agent, 도구용 Human-in-the-loop 페이지를 비롯해 출처에 나열한 문서에서, Sume 쪽 내용은 OAuth와 API 키, MCP 빠른 시작, MCP 도구와 게이트, Job과 결과 (영문)에서 가져왔으며, 모두 2026-09-27에 확인했습니다. Sume에는 n8n 노드가 없습니다. MCP Client Tool을 쓴다면 Sume 원격 MCP 서버와 직접 통신하게 됩니다. Sume 기초 페이지는 호스팅 MCP가 여전히 동작하지만 현재 주 경로는 아니라고 설명합니다. 연결에 실패하거나 워크플로에 에이전트가 필요 없다면, n8n AI 영상 워크플로: Sume 웹훅으로 Wait 노드 재개하기가 대신 Sume HTTP API를 호출하는 방법을 다룹니다.

Sume용 MCP Client Tool은 어떻게 설정하나요?

AI Agent 노드에는 도구 서브 노드가 하나 이상 필요합니다. MCP Client Tool을 이 노드의 Tool 커넥터에 연결하세요. n8n은 자격 증명을 안전하게 저장하고, 저장할 때마다 자격 증명을 테스트합니다. 그다음 필드 세 개를 설정합니다.

  • 엔드포인트: n8n 페이지에서 SSE Endpoint라고 부르는 필드에 https://mcp.sume.com/mcp를 넣습니다. n8n은 MCP 도구를 일반 워크플로 단계로 실행하는 독립형 MCP Client 노드에는 Server Transport 설정을 문서화했지만 도구 노드 페이지에는 이 설정이 없으므로, 사용하는 노드에 어떤 트랜스포트 옵션이 보이는지 확인하세요.
  • Authentication: Bearer Auth를 고르고 Sume API 키를 토큰으로 넣습니다. n8n의 Bearer auth는 이름이 Authorization이고 값이 Bearer <token>인 헤더 인증이며, Sume가 키를 받는 방식과 같습니다. 이름이 x-api-key인 일반 Header Auth 자격 증명도 쓸 수 있습니다.
  • Tools to Include: Selected를 고른 뒤 도구를 선택합니다. 대신 All Except를 고르면 선택하지 않은 모든 도구가 노출됩니다.

에이전트에게는 어떤 Sume 도구를 보여 줘야 하나요?

API 키 세션에는 쓰기·유료 도구를 포함한 전체 호스팅 도구 세트가 보이므로, Tools to Include가 첫 번째 필터입니다. n8n 릴리스 노트에 따르면 MCP Client Tool 노드는 에이전트에게 보이는 도구 이름마다 정리(sanitize)한 노드 이름을 접두사로 붙이며(예: MCP_Client_get_weather), 서버는 여전히 원래 이름을 받습니다. n8n의 다른 MCP 서버용 가이드는 시스템 메시지에 짧은 도구 이름을 적으면 모델이 일치하지 않는 이름을 호출한다고 경고하므로, 도구 이름을 적는 대신 단계를 설명하세요.

Sume MCP 도구와 게이트와 n8n MCP Client Tool 페이지 기준, 2026-09-27 확인.
Sume 도구Sume 문서n8n에서 둘 위치
mcp_health, tools_list, tools_schema탐색 도구읽기 노드, Selected
balance_get, generation_admission_preview계정과 카탈로그 도구읽기 노드, Selected
jobs_wait, jobs_resultJob 읽기 도구읽기 노드, Selected
generate_video, generate_image유료. idempotency_key 필요유료 노드, 사람 검토 단계 뒤
jobs_cancel쓰기. idempotency_key 필요에이전트가 취소해도 될 때만 포함

유료 Sume 호출 전에 승인을 받게 하려면 어떻게 하나요?

n8n의 도구용 사람 검토(human review)를 쓰세요. AI Agent 노드의 도구 커넥터를 클릭하고, Human review 섹션을 찾아 Chat, Slack, Telegram 같은 승인 채널을 고른 뒤, 승인이 필요한 도구를 검토 단계에 연결합니다. 에이전트가 그 도구를 호출하면 워크플로가 일시 중지되고, 검토자는 도구와 파라미터를 봅니다. 승인하면 에이전트가 넣은 입력으로 도구가 실행되고, 거부하면 호출이 취소되며 에이전트에게 그 사실이 전달됩니다.

검토는 검토 단계에 연결한 도구 노드에만 적용되므로, Sume를 MCP Client Tool 노드 두 개로 나누세요. 하나는 읽기 도구를 담아 에이전트에 연결하고, 다른 하나는 유료 도구만 담아 검토 단계 뒤에 둡니다. n8n은 시스템 메시지에 검토 설정을 설명해 두라고 합니다. 검토자는 파라미터에서 Sume 게이트를 확인해야 합니다. 모든 유료 호출에 idempotency_key가 있는지, 아무것도 제출하지 않는 프리뷰라면 dry_run=true가 있는지, 상한이 필요하면 max_spend_usd가 있는지 보세요.

에이전트는 렌더를 얼마나 오래 기다릴 수 있나요?

jobs_wait 호출 한 번은 최대 55초 동안 대기하며, wait_slice_expired를 받으면 에이전트는 같은 id로 다시 기다려야 하고 유료 create는 절대 다시 제출하면 안 됩니다. 나머지는 긴 영상 Job의 MCP 도구 호출 타임아웃에서 다룹니다. 대기는 에이전트 반복 횟수도 소모합니다. 다른 비동기 MCP 서버에 관한 n8n 가이드에 따르면 폴링 한 번에 반복 한 번, 즉 도구 호출과 다시 폴링할지 정하는 모델 턴이 듭니다. Tools Agent의 Max Iterations 옵션은 기본값이 10이므로, 여러 번 기다려야 하는 렌더라면 값을 늘리세요.

일찍 멈춰도 Sume 쪽에서는 아무것도 취소되지 않습니다. 클라이언트 쪽 타임아웃은 Job을 취소하지 않으며, Job은 계속 실행되고 계속 청구됩니다. 몇 분씩 걸리는 렌더라면, 앞서 링크한 글의 Wait 노드 패턴을 쓰면 에이전트 루프를 열어 둔 채 기다리지 않아도 됩니다.

출처

관련 글

연동 카테고리의 다른 글

연동 글 전체 보기

작성자 Sume