InfoGrab DocsInfoGrab Docs

코드로 첫 워크플로 만들기

요약

이 튜토리얼에서는 Workflow SDK로 워크플로 파일을 작성하고, validate_workflow로 검증한 다음, create_workflow_from_code로 인스턴스에 저장합니다. n8n MCP 서버에 연결하고 get_workflow_sdk_reference를 호출한 다음, 아래에 설명된 워크플로에 대한 Workflow SDK 파일을 작성합니다.

이 튜토리얼에서는 Workflow SDK로 워크플로 파일을 작성하고, validate_workflow로 검증한 다음, create_workflow_from_code로 인스턴스에 저장합니다.

Note

코딩 에이전트용 프롬프트

n8n MCP 서버에 연결하고 get_workflow_sdk_reference를 호출한 다음, 아래에 설명된 워크플로에 대한 Workflow SDK 파일을 작성합니다. 전체 코드로 validate_workflow를 호출하고, hint가 가리키는 모든 오류를 수정한 다음, create_workflow_from_code를 호출해 워크플로 URL을 반환합니다.

필요한 사항#

  • MCP 접근이 활성화되어 있고 MCP 클라이언트가 연결된 n8n 인스턴스. 클라이언트 연결 예시에서 Claude Code, Claude Desktop, Cursor를 다룹니다.
  • 로컬 설치는 필요하지 않습니다. 인스턴스가 코드를 파싱합니다.

학습 내용#

  • Workflow SDK 파일의 구조.
  • 워크플로를 생성하기 전에 코드를 검증하는 방법.
  • 분기를 추가하는 방법.

워크플로 파일 작성#

다음 내용으로 github-stars.ts를 만듭니다. 수동 트리거 하나, HTTP Request node 하나, Edit Fields (Set) node 하나로 구성됩니다.

import { workflow, node, trigger, expr } from '@n8n/workflow-sdk';

const start = trigger({
  type: 'n8n-nodes-base.manualTrigger',
  version: 1,
  config: { name: 'Start' }
});

const fetchRepo = node({
  type: 'n8n-nodes-base.httpRequest',
  version: 4.3,
  config: {
    name: 'Fetch repository',
    parameters: { method: 'GET', url: 'https://api.github.com/repos/n8n-io/n8n' }
  }
});

const keepStars = node({
  type: 'n8n-nodes-base.set',
  version: 3.4,
  config: {
    name: 'Keep stars',
    parameters: {
      mode: 'manual',
      includeOtherFields: false,
      assignments: {
        assignments: [
          { id: 'stars', name: 'stars', value: expr('{{ $json.stargazers_count }}'), type: 'number' }
        ]
      }
    }
  }
});

export default workflow('github-stars', 'GitHub stars')
  .add(start)
  .to(fetchRepo)
  .to(keepStars);

기억해 둘 세 가지 규칙이 있습니다.

  • 모든 노드를 먼저 선언한 다음 마지막에 워크플로를 구성합니다.
  • 에디터가 사용하는 노드 유형 ID와 version을 사용합니다. MCP 서버의 search_nodes와 get_node_types가 이를 반환합니다.
  • 표현식은 expr()로 감쌉니다. 안에 들어가는 텍스트는 에디터에서와 동일합니다.

코드 검증#

MCP 클라이언트에 전체 파일을 code 파라미터로 하여 validate_workflow를 호출하도록 요청합니다. 유효한 파일은 다음을 반환합니다.

{ "valid": true, "nodeCount": 3 }

valid가 false이면 응답에 errors 목록이 있고 hint가 포함되는 경우가 많습니다. hint가 안내하는 내용을 수정한 다음 도구를 다시 실행합니다. 흔한 원인은 export default 누락, 잘못된 노드 version, 노드에 없는 파라미터입니다.

워크플로 생성#

동일한 code로 create_workflow_from_code를 호출합니다. 응답에는 workflowId와 url이 포함됩니다. URL을 열고, 에디터에서 워크플로를 한 번 실행한 다음, Keep stars node가 stars 필드를 출력하는지 확인합니다.

이 도구는 인스턴스에서 찾은 자격 증명을 해당 자격 증명이 필요한 노드에 할당합니다. 단, HTTP Request node는 건너뛰므로 호출하는 API에 자격 증명이 필요하다면 해당 노드에 직접 자격 증명을 설정합니다.

분기 추가#

Keep stars node를 If node로 교체해 인기 있는 리포지터리는 한 경로로, 나머지는 다른 경로로 보냅니다. 분기마다 Edit Fields node를 하나씩 추가합니다. 모든 If 조건에는 options, conditions, combinator가 필요합니다. 전체 파일은 다음과 같습니다.

import { workflow, node, trigger, ifElse, expr } from '@n8n/workflow-sdk';

const start = trigger({
  type: 'n8n-nodes-base.manualTrigger',
  version: 1,
  config: { name: 'Start' }
});

const fetchRepo = node({
  type: 'n8n-nodes-base.httpRequest',
  version: 4.3,
  config: {
    name: 'Fetch repository',
    parameters: { method: 'GET', url: 'https://api.github.com/repos/n8n-io/n8n' }
  }
});

const isPopular = ifElse({
  version: 2.2,
  config: {
    name: 'Is popular?',
    parameters: {
      conditions: {
        options: { caseSensitive: true, leftValue: '', typeValidation: 'strict' },
        conditions: [
          { leftValue: expr('{{ $json.stargazers_count }}'), operator: { type: 'number', operation: 'gt' }, rightValue: 100000 }
        ],
        combinator: 'and'
      }
    }
  }
});

const markPopular = node({
  type: 'n8n-nodes-base.set',
  version: 3.4,
  config: {
    name: 'Mark popular',
    parameters: {
      mode: 'manual',
      includeOtherFields: false,
      assignments: {
        assignments: [
          { id: 'popular', name: 'popular', value: true, type: 'boolean' },
          { id: 'stars', name: 'stars', value: expr('{{ $json.stargazers_count }}'), type: 'number' }
        ]
      }
    }
  }
});

const markNotPopular = node({
  type: 'n8n-nodes-base.set',
  version: 3.4,
  config: {
    name: 'Mark not popular',
    parameters: {
      mode: 'manual',
      includeOtherFields: false,
      assignments: {
        assignments: [
          { id: 'popular', name: 'popular', value: false, type: 'boolean' },
          { id: 'stars', name: 'stars', value: expr('{{ $json.stargazers_count }}'), type: 'number' }
        ]
      }
    }
  }
});

export default workflow('github-stars', 'GitHub stars')
  .add(start)
  .to(fetchRepo)
  .to(isPopular
    .onTrue(markPopular)
    .onFalse(markNotPopular));

각 분기는 완전한 경로입니다. .onTrue() 또는 .onFalse() 안에서 .to()로 노드를 더 연결할 수 있습니다.

생성한 워크플로를 변경하려면 두 번째 워크플로를 만들지 말고, 워크플로 ID와 addNode 또는 updateNodeParameters 같은 부분 변경의 operations 배열로 update_workflow를 호출합니다. 도구 레퍼런스에서 사용할 수 있는 작업을 확인할 수 있습니다.

다음 단계#

  • 인스턴스가 제공하는 전체 레퍼런스를 읽어 보세요. n8n MCP 서버에서 get_workflow_sdk_reference를 호출합니다. patterns 섹션에는 루프, 병렬 분기, 다중 트리거, AI 에이전트에 대한 전체 예시가 있습니다.
  • technique: "list"로 get_workflow_best_practices를 호출하면 챗봇, 스케줄링, 데이터 추출 등 가이드가 있는 사용 사례를 확인할 수 있습니다.
  • MCP 서버 없이 코드를 워크플로 JSON으로 변환하려면 SDK README를 참조하세요.
  • AI로 빌드로 코딩 에이전트를 설정하세요.

코드로 첫 워크플로 만들기

n8n v2.47
원문 보기

요약

이 튜토리얼에서는 Workflow SDK로 워크플로 파일을 작성하고, validate_workflow로 검증한 다음, create_workflow_from_code로 인스턴스에 저장합니다. n8n MCP 서버에 연결하고 get_workflow_sdk_reference를 호출한 다음, 아래에 설명된 워크플로에 대한 Workflow SDK 파일을 작성합니다.

이 튜토리얼에서는 Workflow SDK로 워크플로 파일을 작성하고, validate_workflow로 검증한 다음, create_workflow_from_code로 인스턴스에 저장합니다.

Note

코딩 에이전트용 프롬프트

n8n MCP 서버에 연결하고 get_workflow_sdk_reference를 호출한 다음, 아래에 설명된 워크플로에 대한 Workflow SDK 파일을 작성합니다. 전체 코드로 validate_workflow를 호출하고, hint가 가리키는 모든 오류를 수정한 다음, create_workflow_from_code를 호출해 워크플로 URL을 반환합니다.

필요한 사항#

  • MCP 접근이 활성화되어 있고 MCP 클라이언트가 연결된 n8n 인스턴스. 클라이언트 연결 예시에서 Claude Code, Claude Desktop, Cursor를 다룹니다.
  • 로컬 설치는 필요하지 않습니다. 인스턴스가 코드를 파싱합니다.

학습 내용#

  • Workflow SDK 파일의 구조.
  • 워크플로를 생성하기 전에 코드를 검증하는 방법.
  • 분기를 추가하는 방법.

워크플로 파일 작성#

다음 내용으로 github-stars.ts를 만듭니다. 수동 트리거 하나, HTTP Request node 하나, Edit Fields (Set) node 하나로 구성됩니다.

import { workflow, node, trigger, expr } from '@n8n/workflow-sdk';

const start = trigger({
  type: 'n8n-nodes-base.manualTrigger',
  version: 1,
  config: { name: 'Start' }
});

const fetchRepo = node({
  type: 'n8n-nodes-base.httpRequest',
  version: 4.3,
  config: {
    name: 'Fetch repository',
    parameters: { method: 'GET', url: 'https://api.github.com/repos/n8n-io/n8n' }
  }
});

const keepStars = node({
  type: 'n8n-nodes-base.set',
  version: 3.4,
  config: {
    name: 'Keep stars',
    parameters: {
      mode: 'manual',
      includeOtherFields: false,
      assignments: {
        assignments: [
          { id: 'stars', name: 'stars', value: expr('{{ $json.stargazers_count }}'), type: 'number' }
        ]
      }
    }
  }
});

export default workflow('github-stars', 'GitHub stars')
  .add(start)
  .to(fetchRepo)
  .to(keepStars);

기억해 둘 세 가지 규칙이 있습니다.

  • 모든 노드를 먼저 선언한 다음 마지막에 워크플로를 구성합니다.
  • 에디터가 사용하는 노드 유형 ID와 version을 사용합니다. MCP 서버의 search_nodes와 get_node_types가 이를 반환합니다.
  • 표현식은 expr()로 감쌉니다. 안에 들어가는 텍스트는 에디터에서와 동일합니다.

코드 검증#

MCP 클라이언트에 전체 파일을 code 파라미터로 하여 validate_workflow를 호출하도록 요청합니다. 유효한 파일은 다음을 반환합니다.

{ "valid": true, "nodeCount": 3 }

valid가 false이면 응답에 errors 목록이 있고 hint가 포함되는 경우가 많습니다. hint가 안내하는 내용을 수정한 다음 도구를 다시 실행합니다. 흔한 원인은 export default 누락, 잘못된 노드 version, 노드에 없는 파라미터입니다.

워크플로 생성#

동일한 code로 create_workflow_from_code를 호출합니다. 응답에는 workflowId와 url이 포함됩니다. URL을 열고, 에디터에서 워크플로를 한 번 실행한 다음, Keep stars node가 stars 필드를 출력하는지 확인합니다.

이 도구는 인스턴스에서 찾은 자격 증명을 해당 자격 증명이 필요한 노드에 할당합니다. 단, HTTP Request node는 건너뛰므로 호출하는 API에 자격 증명이 필요하다면 해당 노드에 직접 자격 증명을 설정합니다.

분기 추가#

Keep stars node를 If node로 교체해 인기 있는 리포지터리는 한 경로로, 나머지는 다른 경로로 보냅니다. 분기마다 Edit Fields node를 하나씩 추가합니다. 모든 If 조건에는 options, conditions, combinator가 필요합니다. 전체 파일은 다음과 같습니다.

import { workflow, node, trigger, ifElse, expr } from '@n8n/workflow-sdk';

const start = trigger({
  type: 'n8n-nodes-base.manualTrigger',
  version: 1,
  config: { name: 'Start' }
});

const fetchRepo = node({
  type: 'n8n-nodes-base.httpRequest',
  version: 4.3,
  config: {
    name: 'Fetch repository',
    parameters: { method: 'GET', url: 'https://api.github.com/repos/n8n-io/n8n' }
  }
});

const isPopular = ifElse({
  version: 2.2,
  config: {
    name: 'Is popular?',
    parameters: {
      conditions: {
        options: { caseSensitive: true, leftValue: '', typeValidation: 'strict' },
        conditions: [
          { leftValue: expr('{{ $json.stargazers_count }}'), operator: { type: 'number', operation: 'gt' }, rightValue: 100000 }
        ],
        combinator: 'and'
      }
    }
  }
});

const markPopular = node({
  type: 'n8n-nodes-base.set',
  version: 3.4,
  config: {
    name: 'Mark popular',
    parameters: {
      mode: 'manual',
      includeOtherFields: false,
      assignments: {
        assignments: [
          { id: 'popular', name: 'popular', value: true, type: 'boolean' },
          { id: 'stars', name: 'stars', value: expr('{{ $json.stargazers_count }}'), type: 'number' }
        ]
      }
    }
  }
});

const markNotPopular = node({
  type: 'n8n-nodes-base.set',
  version: 3.4,
  config: {
    name: 'Mark not popular',
    parameters: {
      mode: 'manual',
      includeOtherFields: false,
      assignments: {
        assignments: [
          { id: 'popular', name: 'popular', value: false, type: 'boolean' },
          { id: 'stars', name: 'stars', value: expr('{{ $json.stargazers_count }}'), type: 'number' }
        ]
      }
    }
  }
});

export default workflow('github-stars', 'GitHub stars')
  .add(start)
  .to(fetchRepo)
  .to(isPopular
    .onTrue(markPopular)
    .onFalse(markNotPopular));

각 분기는 완전한 경로입니다. .onTrue() 또는 .onFalse() 안에서 .to()로 노드를 더 연결할 수 있습니다.

생성한 워크플로를 변경하려면 두 번째 워크플로를 만들지 말고, 워크플로 ID와 addNode 또는 updateNodeParameters 같은 부분 변경의 operations 배열로 update_workflow를 호출합니다. 도구 레퍼런스에서 사용할 수 있는 작업을 확인할 수 있습니다.

다음 단계#

  • 인스턴스가 제공하는 전체 레퍼런스를 읽어 보세요. n8n MCP 서버에서 get_workflow_sdk_reference를 호출합니다. patterns 섹션에는 루프, 병렬 분기, 다중 트리거, AI 에이전트에 대한 전체 예시가 있습니다.
  • technique: "list"로 get_workflow_best_practices를 호출하면 챗봇, 스케줄링, 데이터 추출 등 가이드가 있는 사용 사례를 확인할 수 있습니다.
  • MCP 서버 없이 코드를 워크플로 JSON으로 변환하려면 SDK README를 참조하세요.
  • AI로 빌드로 코딩 에이전트를 설정하세요.