{
  "id": "5d3901f1-4dca-40a6-acca-424dfd76ad40",
  "slug": "ref/khub/common-n8n-cloud-v2-종합-가이드-변경사항-제약-패턴",
  "doc_type": "ref",
  "title": "n8n Cloud v2 종합 가이드 — 변경사항·제약·패턴",
  "title_en": null,
  "one_liner": "# n8n Cloud v2 종합 가이드 ## v2.0 핵심 변경사항 ### Publish/Save 분리 (가장 중요) v2에서는 Save와 Publish가 분리됨. Save는 편집 보존, Publish를 눌러야 프로덕션 반영. MCP Server Trigger 워크플로우도 Publi",
  "summary_bullets": [],
  "body_md": "# n8n Cloud v2 종합 가이드\n\n## v2.0 핵심 변경사항\n\n### Publish/Save 분리 (가장 중요)\nv2에서는 Save와 Publish가 분리됨. Save는 편집 보존, Publish를 눌러야 프로덕션 반영. MCP Server Trigger 워크플로우도 Publish해야 프로덕션 URL 활성화됨.\n\n### Sub-workflow Wait 노드 수정\nv2에서 부모 워크플로우가 자식의 최종 출력을 올바르게 대기. 기존에 자식의 입력을 받던 로직은 최종 출력으로 수정 필요.\n\n### 보안 강화\n- Code 노드 환경변수 접근 차단 (기본값). Cloud에서 변경 불가. Credential 시스템 사용\n- Task Runner 기본 활성화. Code 노드 60초 타임아웃\n- Pyodide Python 제거. 네이티브 Task Runner Python\n- Start 노드 제거. Manual Trigger 대체\n- ExecuteCommand 노드 비활성화 (Cloud 재활성화 불가)\n\n## Cloud 환경 제약사항\n\n### Code 노드 제약\n외부 npm 모듈 import 불가, fetch() 사용 불가, 파일시스템 접근 불가, HTTP 요청 직접 불가. HTTP 호출 필요 시 반드시 HTTP Request 노드 별도 사용.\n\n사용 가능 내장 모듈: crypto, lodash, luxon, $jmespath\n\n### 타임아웃 계층\n- Code 노드 Task Runner: 60초\n- MCP 실행: 5분\n- Cloudflare 프록시: 100초 (524 에러)\n- Starter 플랜: 월 2,500회, 동시 5개\n\n### 환경변수\nCloud에서 임의 환경변수 설정 불가. CONFIG 노드 패턴(Set 노드) 또는 Credential 사용.\n\n## Tool Code vs Tool Workflow\n\n### Custom Code Tool: 인라인 JS/Python. Cloud에서 HTTP 요청 불가, 외부 모듈 불가. 단순 변환만 가능.\n### Call n8n Workflow Tool (권장): Sub-workflow로 HTTP Request, 복잡 로직 처리 가능.\n결론: Supabase API 호출 MCP 도구는 반드시 Call n8n Workflow Tool 사용.\n\n## 검증 아키텍처: MCP → Workflow Tool → Sub-workflow\n[MCP Server Trigger] → [Call n8n Workflow Tool] → [Sub-workflow: HTTP Request (Supabase) → Set → 반환]\n\n## Supabase REST API 헤더 표준\napikey: SERVICE_ROLE_KEY\nAuthorization: Bearer SERVICE_ROLE_KEY\nContent-Type: application/json\nPrefer: return=representation\n\nRLS 주의: apikey만 설정시 anonymous 평가, 빈 결과 반환. 두 헤더 모두 필수.\n내장 Supabase 노드 403 버그(#17020) → HTTP Request 노드 권장.",
  "related_slugs": [],
  "faq": [],
  "jsonld": null,
  "keywords": [],
  "source_id": "978ca973-2cac-4662-8853-507c4430dc6e",
  "video_url": null,
  "duration_sec": null,
  "thumbnail_url": null,
  "image_url": null,
  "caption": null,
  "solution_slug": null,
  "captured_at": null,
  "width": null,
  "height": null,
  "created_at": "2026-08-24T11:53:44.5731+00:00",
  "updated_at": "2026-08-24T11:53:44.5731+00:00",
  "visibility": "public",
  "source_stage": "1",
  "anonymized": true,
  "source_key": "legacy-khub",
  "origin": "ingest",
  "locked": false,
  "locked_by": null,
  "locked_at": null,
  "gate_state": {
    "g1": {
      "hits": [],
      "pass": true
    },
    "g2": {
      "pass": true,
      "total": 40,
      "issues": [
        "숫자·규격 같은 검증 가능한 구체가 부족합니다",
        "핵심 요약 불릿이 3개 미만입니다",
        "Q&A 쌍이 3개 미만입니다"
      ],
      "applies": true
    },
    "g3": {
      "pass": true,
      "required": false
    },
    "stage": "1",
    "decided_at": "2026-08-24T11:53:44.334Z"
  },
  "raw_id": "43d8cfb6-9b76-4f6c-9eb0-d7f7b0173e1f",
  "search_text": "n8n Cloud v2 종합 가이드 — 변경사항·제약·패턴  # n8n Cloud v2 종합 가이드 ## v2.0 핵심 변경사항 ### Publish/Save 분리 (가장 중요) v2에서는 Save와 Publish가 분리됨. Save는 편집 보존, Publish를 눌러야 프로덕션 반영. MCP Server Trigger 워크플로우도 Publi  # n8n Cloud v2 종합 가이드\n\n## v2.0 핵심 변경사항\n\n### Publish/Save 분리 (가장 중요)\nv2에서는 Save와 Publish가 분리됨. Save는 편집 보존, Publish를 눌러야 프로덕션 반영. MCP Server Trigger 워크플로우도 Publish해야 프로덕션 URL 활성화됨.\n\n### Sub-workflow Wait 노드 수정\nv2에서 부모 워크플로우가 자식의 최종 출력을 올바르게 대기. 기존에 자식의 입력을 받던 로직은 최종 출력으로 수정 필요.\n\n### 보안 강화\n- Code 노드 환경변수 접근 차단 (기본값). Cloud에서 변경 불가. Credential 시스템 사용\n- Task Runner 기본 활성화. Code 노드 60초 타임아웃\n- Pyodide Python 제거. 네이티브 Task Runner Python\n- Start 노드 제거. Manual Trigger 대체\n- ExecuteCommand 노드 비활성화 (Cloud 재활성화 불가)\n\n## Cloud 환경 제약사항\n\n### Code 노드 제약\n외부 npm 모듈 import 불가, fetch() 사용 불가, 파일시스템 접근 불가, HTTP 요청 직접 불가. HTTP 호출 필요 시 반드시 HTTP Request 노드 별도 사용.\n\n사용 가능 내장 모듈: crypto, lodash, luxon, $jmespath\n\n### 타임아웃 계층\n- Code 노드 Task Runner: 60초\n- MCP 실행: 5분\n- Cloudflare 프록시: 100초 (524 에러)\n- Starter 플랜: 월 2,500회, 동시 5개\n\n### 환경변수\nCloud에서 임의 환경변수 설정 불가. CONFIG 노드 패턴(Set 노드) 또는 Credential 사용.\n\n## Tool Code vs Tool Workflow\n\n### Custom Code Tool: 인라인 JS/Python. Cloud에서 HTTP 요청 불가, 외부 모듈 불가. 단순 변환만 가능.\n### Call n8n Workflow Tool (권장): Sub-workflow로 HTTP Request, 복잡 로직 처리 가능.\n결론: Supabase API 호출 MCP 도구는 반드시 Call n8n Workflow Tool 사용.\n\n## 검증 아키텍처: MCP → Workflow Tool → Sub-workflow\n[MCP Server Trigger] → [Call n8n Workflow Tool] → [Sub-workflow: HTTP Request (Supabase) → Set → 반환]\n\n## Supabase REST API 헤더 표준\napikey: SERVICE_ROLE_KEY\nAuthorization: Bearer SERVICE_ROLE_KEY\nContent-Type: application/json\nPrefer: return=representation\n\nRLS 주의: apikey만 설정시 anonymous 평가, 빈 결과 반환. 두 헤더 모두 필수.\n내장 Supabase 노드 403 버그(#17020) → HTTP Request 노드 권장.",
  "embedding": null,
  "embedded_at": null,
  "embedding_hash": null,
  "backlinks": [],
  "html_url": "https://bizspring.ai/kb/ref/khub/common-n8n-cloud-v2-종합-가이드-변경사항-제약-패턴",
  "markdown_url": "https://bizspring.ai/kb/ref/khub/common-n8n-cloud-v2-종합-가이드-변경사항-제약-패턴.md"
}