InfoGrab DocsInfoGrab Docs

AI로 빌드

요약

이 페이지는 AI 코딩 에이전트가 n8n 인스턴스용 Workflow SDK 코드를 작성하는 데 필요한 리소스와 사용 순서를 정리합니다. SDK 자체는 @n8n/workflow-sdk 패키지로 n8n 안에 포함되어 있습니다.

이 페이지는 AI 코딩 에이전트가 n8n 인스턴스용 Workflow SDK 코드를 작성하는 데 필요한 리소스와 사용 순서를 정리합니다. 에이전트에 이 페이지를 알려 주거나, 표를 에이전트의 지침에 붙여 넣습니다.

연결할 대상#

리소스 위치 용도
n8n MCP 서버 사용 중인 인스턴스, n8n MCP 서버에 연결 참고 아래의 빌더 도구, 그리고 인스턴스의 워크플로·실행·자격 증명 관리
GitBook docs MCP 서버 https://docs.n8n.io/~gitbook/mcp n8n 문서 검색 및 읽기, n8n docs MCP 서버에 연결 참고
Kapa.ai docs MCP 서버 https://n8n.mcp.kapa.ai 문서만으로 답하기 어려운 질문(포럼 스레드, 블로그 게시물)
Markdown 형식 문서 문서 URL 끝에 .md를 붙이거나, 색인인 https://docs.n8n.io/llms.txt를 가져옵니다 HTML 없이 페이지 읽기
n8n CLI 스킬 n8n-cli skill install --global, n8n CLI 참고 MCP 서버 없이 터미널에서 JSON으로 워크플로 관리

SDK 자체는 @n8n/workflow-sdk 패키지로 n8n 안에 포함되어 있습니다. 에이전트가 설치할 필요는 없습니다.

빌더 도구#

n8n MCP 서버의 다음 도구가 Workflow SDK 코드를 읽고 씁니다. 파라미터와 출력은 MCP 서버 도구 레퍼런스에 있습니다. 표에서 따로 밝히지 않은 도구는 n8n 2.12.0부터 사용할 수 있습니다.

도구 반환하는 내용
get_workflow_sdk_reference SDK 레퍼런스: import 문, 패턴, 표현식, 함수, 규칙, 가이드라인, 설계 지침. 가장 먼저 호출합니다.
get_workflow_best_practices chatbot, data_extraction 같은 워크플로 기법 하나에 대한 가이드. list를 전달하면 기법 목록을 확인할 수 있습니다. n8n 2.26.0부터 사용할 수 있습니다.
search_nodes 서비스 이름이나 작업을 기준으로 한 노드 ID, 그리고 노드에 필요한 리소스 또는 작업 값.
get_node_types 사용하려는 노드의 TypeScript 타입 정의와 파라미터.
explore_node_resources Slack 자격 증명이 볼 수 있는 채널 등 노드의 실시간 옵션. n8n 2.27.0부터 사용할 수 있습니다.
validate_node_config 노드 구성 하나를 스키마에 대해 검사합니다. n8n 2.25.1부터 사용할 수 있습니다.
validate_workflow 파일 전체를 검사합니다. 코드가 올바르지 않으면 오류와 힌트를 반환합니다.
create_workflow_from_code 검증된 코드를 새 워크플로로 저장하고 해당 URL을 반환합니다.
update_workflow addNode, updateNodeParameters, addConnection 같은 부분 변경을 순서대로 묶어 기존 워크플로에 적용합니다. 새 파일은 받지 않습니다.

효과적인 순서#

레퍼런스를 건너뛰는 에이전트는 구문을 추측하다가 검증 오류를 반복합니다. 에이전트에 다음 순서를 알려 줍니다.

  1. get_workflow_sdk_reference를 호출합니다. 작업에 맞는 형태를 찾으려면 patterns 섹션을 읽습니다.
  2. 적용할 기법이 있고 인스턴스가 n8n 2.26.0 이상이면 해당 기법에 대해 get_workflow_best_practices를 호출합니다.
  3. 워크플로에 필요한 모든 노드에 대해 search_nodes를 호출한 다음 get_node_types를 호출합니다.
  4. 파일을 작성합니다. 노드를 먼저 선언하고 워크플로는 마지막에 구성하며, export default는 하나만 둡니다.
  5. validate_workflow를 호출합니다. hint가 안내하는 내용을 수정합니다. valid가 true가 될 때까지 반복합니다.
  6. create_workflow_from_code를 호출합니다. 기존 워크플로는 operations 배열과 함께 update_workflow를 호출합니다.
  7. 성공을 보고하기 전에 워크플로를 한 번 실행하고 get_workflow_execution으로 실행 결과를 확인합니다.
Warning

create_workflow_from_code는 워크플로를 저장하지만 게시하지는 않습니다. 트리거가 동작하려면 에디터에서 워크플로를 게시하거나 publish_workflow를 호출합니다.

시작용 프롬프트#

다음 내용을 에이전트에 붙여 넣고 마지막 문장을 바꿉니다.

You build n8n workflows as Workflow SDK code through the n8n MCP server.
Before writing code, call get_workflow_sdk_reference and read the patterns section.
For each node, call search_nodes and get_node_types to get the exact type id, version, and parameter names.
Write one file with export default workflow(...). Call validate_workflow and fix every error until valid is true.
Then call create_workflow_from_code and return the workflow URL.
Task: build a workflow that ...

관련 리소스#

AI로 빌드

n8n v2.47
원문 보기

요약

이 페이지는 AI 코딩 에이전트가 n8n 인스턴스용 Workflow SDK 코드를 작성하는 데 필요한 리소스와 사용 순서를 정리합니다. SDK 자체는 @n8n/workflow-sdk 패키지로 n8n 안에 포함되어 있습니다.

이 페이지는 AI 코딩 에이전트가 n8n 인스턴스용 Workflow SDK 코드를 작성하는 데 필요한 리소스와 사용 순서를 정리합니다. 에이전트에 이 페이지를 알려 주거나, 표를 에이전트의 지침에 붙여 넣습니다.

연결할 대상#

리소스 위치 용도
n8n MCP 서버 사용 중인 인스턴스, n8n MCP 서버에 연결 참고 아래의 빌더 도구, 그리고 인스턴스의 워크플로·실행·자격 증명 관리
GitBook docs MCP 서버 https://docs.n8n.io/~gitbook/mcp n8n 문서 검색 및 읽기, n8n docs MCP 서버에 연결 참고
Kapa.ai docs MCP 서버 https://n8n.mcp.kapa.ai 문서만으로 답하기 어려운 질문(포럼 스레드, 블로그 게시물)
Markdown 형식 문서 문서 URL 끝에 .md를 붙이거나, 색인인 https://docs.n8n.io/llms.txt를 가져옵니다 HTML 없이 페이지 읽기
n8n CLI 스킬 n8n-cli skill install --global, n8n CLI 참고 MCP 서버 없이 터미널에서 JSON으로 워크플로 관리

SDK 자체는 @n8n/workflow-sdk 패키지로 n8n 안에 포함되어 있습니다. 에이전트가 설치할 필요는 없습니다.

빌더 도구#

n8n MCP 서버의 다음 도구가 Workflow SDK 코드를 읽고 씁니다. 파라미터와 출력은 MCP 서버 도구 레퍼런스에 있습니다. 표에서 따로 밝히지 않은 도구는 n8n 2.12.0부터 사용할 수 있습니다.

도구 반환하는 내용
get_workflow_sdk_reference SDK 레퍼런스: import 문, 패턴, 표현식, 함수, 규칙, 가이드라인, 설계 지침. 가장 먼저 호출합니다.
get_workflow_best_practices chatbot, data_extraction 같은 워크플로 기법 하나에 대한 가이드. list를 전달하면 기법 목록을 확인할 수 있습니다. n8n 2.26.0부터 사용할 수 있습니다.
search_nodes 서비스 이름이나 작업을 기준으로 한 노드 ID, 그리고 노드에 필요한 리소스 또는 작업 값.
get_node_types 사용하려는 노드의 TypeScript 타입 정의와 파라미터.
explore_node_resources Slack 자격 증명이 볼 수 있는 채널 등 노드의 실시간 옵션. n8n 2.27.0부터 사용할 수 있습니다.
validate_node_config 노드 구성 하나를 스키마에 대해 검사합니다. n8n 2.25.1부터 사용할 수 있습니다.
validate_workflow 파일 전체를 검사합니다. 코드가 올바르지 않으면 오류와 힌트를 반환합니다.
create_workflow_from_code 검증된 코드를 새 워크플로로 저장하고 해당 URL을 반환합니다.
update_workflow addNode, updateNodeParameters, addConnection 같은 부분 변경을 순서대로 묶어 기존 워크플로에 적용합니다. 새 파일은 받지 않습니다.

효과적인 순서#

레퍼런스를 건너뛰는 에이전트는 구문을 추측하다가 검증 오류를 반복합니다. 에이전트에 다음 순서를 알려 줍니다.

  1. get_workflow_sdk_reference를 호출합니다. 작업에 맞는 형태를 찾으려면 patterns 섹션을 읽습니다.
  2. 적용할 기법이 있고 인스턴스가 n8n 2.26.0 이상이면 해당 기법에 대해 get_workflow_best_practices를 호출합니다.
  3. 워크플로에 필요한 모든 노드에 대해 search_nodes를 호출한 다음 get_node_types를 호출합니다.
  4. 파일을 작성합니다. 노드를 먼저 선언하고 워크플로는 마지막에 구성하며, export default는 하나만 둡니다.
  5. validate_workflow를 호출합니다. hint가 안내하는 내용을 수정합니다. valid가 true가 될 때까지 반복합니다.
  6. create_workflow_from_code를 호출합니다. 기존 워크플로는 operations 배열과 함께 update_workflow를 호출합니다.
  7. 성공을 보고하기 전에 워크플로를 한 번 실행하고 get_workflow_execution으로 실행 결과를 확인합니다.
Warning

create_workflow_from_code는 워크플로를 저장하지만 게시하지는 않습니다. 트리거가 동작하려면 에디터에서 워크플로를 게시하거나 publish_workflow를 호출합니다.

시작용 프롬프트#

다음 내용을 에이전트에 붙여 넣고 마지막 문장을 바꿉니다.

You build n8n workflows as Workflow SDK code through the n8n MCP server.
Before writing code, call get_workflow_sdk_reference and read the patterns section.
For each node, call search_nodes and get_node_types to get the exact type id, version, and parameter names.
Write one file with export default workflow(...). Call validate_workflow and fix every error until valid is true.
Then call create_workflow_from_code and return the workflow URL.
Task: build a workflow that ...

관련 리소스#