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 같은 부분 변경을 순서대로 묶어 기존 워크플로에 적용합니다. 새 파일은 받지 않습니다. |
효과적인 순서#
레퍼런스를 건너뛰는 에이전트는 구문을 추측하다가 검증 오류를 반복합니다. 에이전트에 다음 순서를 알려 줍니다.
get_workflow_sdk_reference를 호출합니다. 작업에 맞는 형태를 찾으려면patterns섹션을 읽습니다.- 적용할 기법이 있고 인스턴스가 n8n 2.26.0 이상이면 해당 기법에 대해
get_workflow_best_practices를 호출합니다. - 워크플로에 필요한 모든 노드에 대해
search_nodes를 호출한 다음get_node_types를 호출합니다. - 파일을 작성합니다. 노드를 먼저 선언하고 워크플로는 마지막에 구성하며,
export default는 하나만 둡니다. validate_workflow를 호출합니다.hint가 안내하는 내용을 수정합니다.valid가true가 될 때까지 반복합니다.create_workflow_from_code를 호출합니다. 기존 워크플로는operations배열과 함께update_workflow를 호출합니다.- 성공을 보고하기 전에 워크플로를 한 번 실행하고
get_workflow_execution으로 실행 결과를 확인합니다.
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 ...