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

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 도구 | Sume 문서 | n8n에서 둘 위치 |
|---|---|---|
mcp_health, tools_list, tools_schema | 탐색 도구 | 읽기 노드, Selected |
balance_get, generation_admission_preview | 계정과 카탈로그 도구 | 읽기 노드, Selected |
jobs_wait, jobs_result | Job 읽기 도구 | 읽기 노드, 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 노드 패턴을 쓰면 에이전트 루프를 열어 둔 채 기다리지 않아도 됩니다.
출처
- MCP OAuth와 API 키
- MCP 도구와 게이트
- MCP 빠른 시작
- Job과 결과 (영문)
- Sume 기초
- n8n 문서: MCP Client Tool 노드 (2026-09-27 확인)
- n8n 문서: MCP Client 노드 (2026-09-27 확인)
- n8n 문서: AI Agent 노드 (2026-09-27 확인)
- n8n 문서: Tools Agent (2026-09-27 확인)
- n8n 문서: 도구용 Human-in-the-loop (2026-09-27 확인)
- n8n 문서: HTTP Request 자격 증명 (2026-09-27 확인)
- n8n 문서: 자격 증명 만들기와 편집 (2026-09-27 확인)
- n8n 문서: 릴리스 노트 (2026-09-27 확인)
- n8n 문서: Databricks Genie MCP 서버 (2026-09-27 확인)
관련 글
연동 카테고리의 다른 글
- OpenAI Agents SDK MCP 서버: Sume와 5초 타임아웃
API 키로 OpenAI Agents SDK를 Sume 호스팅 MCP 서버에 연결하고, 기본 5초인 클라이언트 타임아웃을 jobs_wait의 55초보다 길게 늘리세요.
- OpenAI Responses API MCP 도구로 Sume 호출
Sume 호스팅 MCP 서버를 Responses API에 mcp 도구로 추가하고, Sume API 키는 headers로 보내고, 유료 도구 호출은 실행 전에 승인하세요.
- PHP 웹훅 서명 검증: 순수 PHP와 Laravel
PHP에서 Sume 웹훅 검증하기: timestamp.raw_body에 hash_hmac sha256을 적용하고, sume-v1 항목을 나눠 각각 hash_equals로 비교하세요.
- Pipedream에서 Sume 영상 실행의 웹훅 콜백 기다리기
Sume 영상 실행을 시작하는 단계에서 $.flow.suspend()를 호출하고 resume_url을 webhook_url로 넘기면, Sume가 결과를 POST할 때 Pipedream이 재개합니다.
작성자 Sume