# n8n Cloud v2 종합 가이드 — 변경사항·제약·패턴

> # n8n Cloud v2 종합 가이드 ## v2.0 핵심 변경사항 ### Publish/Save 분리 (가장 중요) v2에서는 Save와 Publish가 분리됨. Save는 편집 보존, Publish를 눌러야 프로덕션 반영. MCP Server Trigger 워크플로우도 Publi

## 핵심 요약


# n8n Cloud v2 종합 가이드

## v2.0 핵심 변경사항

### Publish/Save 분리 (가장 중요)
v2에서는 Save와 Publish가 분리됨. Save는 편집 보존, Publish를 눌러야 프로덕션 반영. MCP Server Trigger 워크플로우도 Publish해야 프로덕션 URL 활성화됨.

### Sub-workflow Wait 노드 수정
v2에서 부모 워크플로우가 자식의 최종 출력을 올바르게 대기. 기존에 자식의 입력을 받던 로직은 최종 출력으로 수정 필요.

### 보안 강화
- Code 노드 환경변수 접근 차단 (기본값). Cloud에서 변경 불가. Credential 시스템 사용
- Task Runner 기본 활성화. Code 노드 60초 타임아웃
- Pyodide Python 제거. 네이티브 Task Runner Python
- Start 노드 제거. Manual Trigger 대체
- ExecuteCommand 노드 비활성화 (Cloud 재활성화 불가)

## Cloud 환경 제약사항

### Code 노드 제약
외부 npm 모듈 import 불가, fetch() 사용 불가, 파일시스템 접근 불가, HTTP 요청 직접 불가. HTTP 호출 필요 시 반드시 HTTP Request 노드 별도 사용.

사용 가능 내장 모듈: crypto, lodash, luxon, $jmespath

### 타임아웃 계층
- Code 노드 Task Runner: 60초
- MCP 실행: 5분
- Cloudflare 프록시: 100초 (524 에러)
- Starter 플랜: 월 2,500회, 동시 5개

### 환경변수
Cloud에서 임의 환경변수 설정 불가. CONFIG 노드 패턴(Set 노드) 또는 Credential 사용.

## Tool Code vs Tool Workflow

### Custom Code Tool: 인라인 JS/Python. Cloud에서 HTTP 요청 불가, 외부 모듈 불가. 단순 변환만 가능.
### Call n8n Workflow Tool (권장): Sub-workflow로 HTTP Request, 복잡 로직 처리 가능.
결론: Supabase API 호출 MCP 도구는 반드시 Call n8n Workflow Tool 사용.

## 검증 아키텍처: MCP → Workflow Tool → Sub-workflow
[MCP Server Trigger] → [Call n8n Workflow Tool] → [Sub-workflow: HTTP Request (Supabase) → Set → 반환]

## Supabase REST API 헤더 표준
apikey: SERVICE_ROLE_KEY
Authorization: Bearer SERVICE_ROLE_KEY
Content-Type: application/json
Prefer: return=representation

RLS 주의: apikey만 설정시 anonymous 평가, 빈 결과 반환. 두 헤더 모두 필수.
내장 Supabase 노드 403 버그(#17020) → HTTP Request 노드 권장.

## FAQ


---
출처: https://bizspring.ai/kb/ref/khub/common-n8n-cloud-v2-종합-가이드-변경사항-제약-패턴 · 최종 갱신 2026-08-24T11:53:44.5731+00:00