InfoGrab DocsInfoGrab Docs

n8n MCP 서버 도구 참조

요약

이 페이지는 인스턴스 수준 MCP 서버가 노출하는 모든 도구를 설명합니다. 선택적 필터를 사용하여 워크플로를 검색합니다. 트리거 세부 정보를 포함하여 특정 워크플로에 대한 상세 정보를 가져옵니다. ID로 워크플로를 실행합니다.

이 페이지는 인스턴스 수준 MCP 서버가 노출하는 모든 도구를 설명합니다.

워크플로 관리#

search_workflows#

선택적 필터를 사용하여 워크플로를 검색합니다. 각 워크플로의 미리보기를 반환합니다.

매개변수#

Name Type Required Default Description
query string 아니요 이름 또는 설명으로 필터링
projectId string 아니요 프로젝트 ID로 필터링
tags string[] 아니요 태그 이름으로 필터링합니다. AND 의미론을 사용하므로 워크플로가 일치하려면 나열된 모든 태그를 가지고 있어야 합니다.
limit integer 아니요 200 결과 수 제한(최대 200)
sortBy string 아니요 "updatedAt:desc" 결과 정렬 순서. 다음 중 하나: "updatedAt:desc", "updatedAt:asc", "createdAt:desc", "createdAt:asc", "name:asc", "name:desc"

출력#

Field Type Description
data array 워크플로 미리보기 목록
data[].id string 워크플로의 고유 식별자
data[].name `string null`
data[].description `string null`
data[].active `boolean null`
data[].createdAt `string null`
data[].updatedAt `string null`
data[].triggerCount `number null`
data[].scopes string[] 이 워크플로에 대한 사용자 권한
data[].canExecute boolean 사용자가 이 워크플로를 실행할 권한이 있는지 여부
data[].availableInMCP boolean 워크플로가 MCP 도구에 노출되는지 여부
data[].tags array 워크플로에 할당된 태그. 각각 id와 name을 가짐
count integer 필터와 일치하는 워크플로의 총 개수

참고#

  • 최대 결과 제한은 200개입니다.
  • 기본적으로 결과는 최근에 업데이트된 워크플로부터 정렬됩니다.
  • 각 워크플로에 대한 사용자 권한 범위를 포함하여 MCP 클라이언트가 워크플로에서 사용 가능한 작업을 확인할 수 있습니다.
  • tags로 필터링하는 기능과 결과의 tags 필드는 n8n v2.27.0부터 사용할 수 있습니다. 사용 가능한 태그 이름을 확인하려면 list_tags를 사용하세요.
  • 중요: 이 도구는 Available in MCP 설정과 관계없이 사용자가 접근 권한을 가진 모든 워크플로를 나열할 수 있습니다.

get_workflow_details#

트리거 세부 정보를 포함하여 특정 워크플로에 대한 상세 정보를 가져옵니다.

매개변수#

Name Type Required Description
workflowId string 예 조회할 워크플로의 ID

출력#

Field Type Description
workflow object MCP에서 사용하기에 안전하게 정제된 워크플로 데이터
workflow.id string 워크플로 ID
workflow.name `string null`
workflow.active boolean 워크플로에 게시된 활성 버전이 있는지 여부
workflow.isArchived boolean 워크플로가 보관(archive)되었는지 여부
workflow.versionId string 현재 워크플로 버전 ID
workflow.activeVersionId `string null`
workflow.triggerCount number 트리거 수
workflow.createdAt `string null`
workflow.updatedAt `string null`
workflow.settings `object null`
workflow.connections object 워크플로 연결 그래프
workflow.nodes array 워크플로 노드 목록. 자격 증명 참조는 제거됨
workflow.activeVersion `object null`
workflow.activeVersion.nodes array 활성 워크플로 버전의 노드. 자격 증명 참조는 제거됨
workflow.activeVersion.connections object 활성 워크플로 버전의 연결
workflow.tags array id와 name을 가진 태그
workflow.meta `object null`
workflow.parentFolderId `string null`
workflow.description string 설정된 경우 워크플로 설명
workflow.scopes string[] 이 워크플로에 대한 사용자 권한
workflow.canExecute boolean 사용자가 이 워크플로를 실행할 권한이 있는지 여부
triggerInfo string 워크플로를 트리거하는 방법을 설명하는 사람이 읽을 수 있는 안내

참고#

  • 반환된 노드에서 민감한 자격 증명 데이터는 제거됩니다.
  • 워크플로가 게시된 경우 활성 버전 세부 정보를 포함합니다.
  • 사용자 권한 범위와 현재 사용자가 워크플로를 실행할 수 있는지 여부를 포함합니다.
  • 지원되는 트리거 노드를 호출하는 방법을 이해하려면 triggerInfo를 사용하세요.

execute_workflow#

ID로 워크플로를 실행합니다. 완료를 기다리지 않고 즉시 실행 ID를 반환합니다.

매개변수#

Name Type Required Default Description
workflowId string 예 실행할 워크플로의 ID
executionMode `"manual" "production"` 아니요 "production"
inputs object 아니요 워크플로에 제공할 입력(판별 유니언, 아래 참조)

inputs variants(type로 구분됨):

Type Fields Description
chat chatInput: string 채팅 기반 워크플로에 대한 입력
form formData: Record<string, unknown> 폼 기반 워크플로에 대한 입력 데이터
webhook webhookData: { method?, query?, body?, headers? } 웹훅 기반 워크플로에 대한 입력 데이터

webhookData fields:

Field Type Required Default Description
method `"GET" "POST" "PUT" "DELETE"
query Record<string, string> 아니요 쿼리 문자열 매개변수
body Record<string, unknown> 아니요 요청 본문 데이터
headers Record<string, string> 아니요 HTTP 헤더

출력#

Field Type Description
executionId `string null`
status `"started" "error"`
error string 실행을 시작할 수 없는 경우의 오류 메시지

참고#

  • 이 도구는 워크플로를 시작하고 즉시 반환합니다. 최종 실행 상태를 확인하거나 실행 데이터를 가져오려면 반환된 executionId와 함께 get_execution을 사용하세요.
  • 프로덕션 모드는 Webhook, Chat Trigger, Form Trigger, Schedule Trigger 노드가 있는 워크플로를 지원합니다.
  • 수동 모드는 Manual Trigger 노드도 지원합니다.
  • executionMode가 "production"인 경우 워크플로에 게시된(활성) 버전이 있어야 합니다.
  • 워크플로에 지원되는 트리거가 여러 개 있는 경우, 워크플로 실행 도구를 사용할 때 MCP 클라이언트는 그중 하나(첫 번째)만 사용하여 워크플로를 트리거할 수 있습니다.
  • 다단계 폼이나 사람이 개입하는(human-in-the-loop) 형태의 상호작용이 있는 워크플로 실행은 지원되지 않습니다.

test_workflow#

Note

n8n v2.15.0부터 사용 가능

핀 데이터를 사용하여 외부 서비스를 우회하면서 워크플로를 테스트합니다. 트리거 노드, 자격 증명이 있는 노드, HTTP Request 노드는 고정(핀)되어(시뮬레이션 데이터 사용) 실행됩니다. Set, If, Code 등 다른 노드는 Execute Command나 파일 읽기/쓰기 노드 같은 자격 증명이 필요 없는 I/O 노드를 포함하여 정상적으로 실행됩니다.

매개변수#

Name Type Required Description
workflowId string 예 테스트할 워크플로의 ID
pinData Record<string, array> 예 모든 워크플로 노드에 대한 핀 데이터.
triggerNodeName string 아니요 실행을 시작할 트리거 노드의 선택적 이름. 기본값은 첫 번째 트리거 노드입니다.

출력#

Field Type Description
executionId `string null`
status string 테스트 실행 상태. 다음 중 하나: "success", "error", "running", "waiting", "canceled", "crashed", "new", "unknown"
error string 실행이 실패한 경우의 오류 메시지

참고#

  • 자격 증명을 설정하거나 외부 서비스를 호출하지 않고도 워크플로 로직을 테스트하는 데 사용할 수 있습니다.
  • 이 도구는 워크플로를 동기적으로 실행합니다(실행이 끝날 때까지 대기).
  • 강제 적용되는 MCP 실행 제한 시간(5분)이 있습니다.

prepare_test_pin_data#

Note

n8n v2.15.0부터 사용 가능

워크플로에 대한 테스트 핀 데이터를 준비합니다. 트리거 노드, 자격 증명이 있는 노드, HTTP Request 노드는 핀 데이터가 필요합니다. 로직 노드(Set, If, Code 등)와 자격 증명이 필요 없는 I/O 노드(Execute Command, 파일 읽기/쓰기)는 핀 데이터 없이 정상적으로 실행됩니다. 핀 데이터가 필요한 각 노드에 대해 예상되는 출력 형태를 설명하는 JSON 스키마를 반환합니다.

매개변수#

Name Type Required Description
workflowId string 예 테스트 핀 데이터를 생성할 워크플로의 ID

출력#

Field Type Description
nodeSchemasToGenerate Record<string, JsonSchema> 핀 데이터가 필요한 노드. 키는 노드 이름이고, 값은 예상 출력 형태를 설명하는 JSON 스키마 객체입니다.
nodesWithoutSchema string[] 핀 데이터가 필요하지만 출력 스키마가 없는 노드 이름. 각각에 빈 기본값 [{"json": {}}]을 사용하세요.
nodesSkipped string[] 핀 데이터가 필요하지 않고 테스트 중 정상적으로 실행될 노드.
coverage object 커버리지 통계
coverage.withSchemaFromExecution number 마지막으로 성공한 실행 출력에서 추론된 스키마를 가진 노드
coverage.withSchemaFromDefinition number 노드 타입 정의에서 얻은 스키마를 가진 노드
coverage.withoutSchema number 데이터나 스키마가 없는 노드
coverage.skipped number 정상적으로 실행될 노드(핀 데이터 불필요)
coverage.total number 활성화된 노드의 총 개수

참고#

  • 스키마는 test_workflow에 사용할 현실적인 샘플 데이터를 생성하는 데 사용해야 합니다.

publish_workflow#

Note

n8n v2.12.0부터 사용 가능

워크플로를 게시(활성화)하여 프로덕션 실행에 사용할 수 있도록 합니다. 이렇게 하면 현재 초안(draft)으로부터 활성 버전이 생성됩니다.

매개변수#

Name Type Required Description
workflowId string 예 게시할 워크플로의 ID
versionId string 아니요 게시할 버전 ID(선택 사항). 제공하지 않으면 현재 초안 버전을 게시합니다.

출력#

Field Type Description
success boolean 게시 성공 여부
workflowId string 워크플로 ID
activeVersionId `string null`
error string 게시가 실패한 경우의 오류 메시지

unpublish_workflow#

Note

n8n v2.12.0부터 사용 가능

워크플로를 게시 취소(비활성화)하여 프로덕션 실행에 사용할 수 없도록 합니다.

매개변수#

Name Type Required Description
workflowId string 예 게시 취소할 워크플로의 ID

출력#

Field Type Description
success boolean 게시 취소 성공 여부
workflowId string 워크플로 ID
error string 게시 취소가 실패한 경우의 오류 메시지

search_projects#

Note

n8n v2.14.0부터 사용 가능

현재 사용자가 접근할 수 있는 프로젝트를 검색합니다. 특정 프로젝트에서 워크플로나 데이터 테이블을 생성하기 전에 프로젝트 ID를 확인하는 데 사용하세요.

매개변수#

Name Type Required Description
query string 아니요 이름으로 프로젝트를 필터링합니다. 결과는 대소문자를 구분하지 않는 완전 일치가 먼저, 부분 일치가 그다음 순으로 정렬됩니다.
type `"personal" "team"` 아니요
limit integer 아니요 결과 수 제한(최대 100)

출력#

Field Type Description
data array 일치하는 프로젝트 목록. 대소문자를 구분하지 않는 완전 일치가 먼저 정렬됨
data[].id string 프로젝트의 고유 식별자
data[].name string 프로젝트 이름
data[].type `"personal" "team"`
data[].matchType `"exact" "partial"`
count integer 일치하는 프로젝트의 총 개수
teamProjectsEnabled boolean 이 인스턴스에서 팀 프로젝트가 라이선스로 활성화되어 있는지 여부. false인 경우, 사용자가 반환된 접근 가능 프로젝트 중 하나를 명시적으로 선택하지 않는 한 create_workflow_from_code에서 projectId가 기본적으로 생략되어 워크플로가 호출자의 개인 프로젝트에 생성됩니다. 오류 응답에서는 생략됩니다. n8n v2.26.0부터 사용 가능합니다.
hint string 결과 선택에 대한 안내. 일치 항목이 모호한 경우(예: 완전 일치는 없지만 부분 일치가 여러 개인 경우) 또는 이 인스턴스에서 팀 프로젝트가 라이선스로 활성화되어 있지 않은 경우에 존재

참고#

  • 최대 결과 제한은 100개입니다.
  • 사용자가 프로젝트 이름을 지정한 경우, 먼저 이 도구를 호출하고 확인된 프로젝트 ID를 create_workflow_from_code, update_workflow 또는 데이터 테이블 도구에 전달하세요.
  • hint가 존재하는 경우 작업을 수행하기 전에 이를 따르세요. 예를 들어, 여러 부분 일치 중에서 추측하는 대신 사용자에게 명확히 확인을 요청하세요.

search_folders#

Note

n8n v2.14.0부터 사용 가능

프로젝트 내의 폴더를 검색합니다.

매개변수#

Name Type Required Description
projectId string 예 폴더를 검색할 프로젝트의 ID
query string 아니요 이름으로 폴더 필터링(대소문자를 구분하지 않는 부분 일치)
limit integer 아니요 결과 수 제한(최대 100)

출력#

Field Type Description
data array 일치하는 폴더 목록
data[].id string 폴더의 고유 식별자
data[].name string 폴더 이름
data[].parentFolderId `string null`
count integer 일치하는 폴더의 총 개수

참고#

  • 최대 결과 제한은 100개입니다.
  • 이 도구를 사용하면 MCP 클라이언트가 특정 폴더에 워크플로를 생성할 수 있습니다.

list_tags#

Note

n8n v2.27.0부터 사용 가능

인스턴스의 모든 워크플로 태그를 나열합니다. 태그는 전역적이며(프로젝트 범위가 아님) search_workflows와 함께 결과를 필터링하는 데 사용할 수 있습니다.

매개변수#

Name Type Required Default Description
limit integer 아니요 500 결과 수 제한(최대 500)

출력#

Field Type Description
data array 인스턴스에서 사용 가능한 워크플로 태그
data[].id string 태그의 고유 식별자
data[].name string 태그의 표시 이름
data[].usageCount integer 이 태그를 사용하는 보관되지 않은 워크플로 수
data[].createdAt string 태그가 생성된 시점의 ISO 타임스탬프
data[].updatedAt string 태그가 마지막으로 업데이트된 시점의 ISO 타임스탬프
count integer 반환된 태그 수
totalCount integer 제한을 적용하기 전 태그의 총 개수

참고#

  • 최대 결과 제한은 500개입니다.
  • 태그는 전역적이며 프로젝트 범위로 지정되지 않습니다.
  • usageCount는 보관되지 않은 워크플로만 계산합니다.
  • tag:list 전역 권한이 필요합니다.
  • 인스턴스에서 워크플로 태그가 활성화된 경우에만 사용할 수 있습니다. 인스턴스 설정에서 태그가 비활성화된 경우 이 도구는 노출되지 않습니다.

실행 관리#

get_execution#

Note

n8n v2.12.0부터 사용 가능

실행 ID와 워크플로 ID로 실행 세부 정보를 가져옵니다. 기본적으로 메타데이터만 반환합니다.

매개변수#

Name Type Required Description
workflowId string 예 실행이 속한 워크플로의 ID
executionId string 예 조회할 실행의 ID
includeData boolean 아니요 전체 실행 결과 데이터를 포함할지 여부. 기본값은 false(메타데이터만)입니다.
nodeNames string[] 아니요 includeData가 true인 경우 이 노드들에 대한 데이터만 반환합니다. 생략하면 모든 노드의 데이터가 포함됩니다.
truncateData integer 아니요 includeData가 true인 경우 노드 출력당 반환되는 데이터 항목 수를 제한합니다.

출력#

Field Type Description
execution `object null`
execution.id string 실행 ID
execution.workflowId string 워크플로 ID
execution.mode string 실행 모드
execution.status string 실행 상태
execution.startedAt `string null`
execution.stoppedAt `string null`
execution.retryOf `string null`
execution.retrySuccessId `string null`
execution.waitTill `string null`
data unknown 실행 결과 데이터(includeData가 true인 경우에만 존재)
error string 요청이 실패한 경우의 오류 메시지

참고#

  • 전체 실행 데이터가 필요하지 않은 경우 가벼운 메타데이터 조회(기본값)를 사용하세요.
  • nodeNames로 필터링하고 truncateData로 잘라내면 대규모 결과 세트를 관리하는 데 도움이 됩니다.

search_executions#

Note

n8n v2.20.0부터 사용 가능

선택적 필터를 사용하여 워크플로 실행을 검색합니다. 상태, 타이밍, 워크플로 ID를 포함한 실행 메타데이터를 반환합니다.

매개변수#

Name Type Required Description
workflowId string 아니요 워크플로 ID로 실행 필터링
status string[] 아니요 실행 상태로 필터링. 값: "canceled", "crashed", "error", "new", "running", "success", "unknown", "waiting"
startedAfter string 아니요 ISO 8601 타임스탬프. 이 시간 이후에 시작된 실행만 반환합니다.
startedBefore string 아니요 ISO 8601 타임스탬프. 이 시간 이전에 시작된 실행만 반환합니다.
limit integer 아니요 결과 수 제한(최대 200)
lastId string 아니요 페이지네이션을 위한 커서. 이전 페이지의 마지막 실행 ID를 전달하세요.

출력#

Field Type Description
data array 쿼리와 일치하는 실행 목록
data[].id string 실행의 고유 식별자
data[].workflowId string 이 실행이 속한 워크플로
data[].status string 실행 상태
data[].mode string 실행이 트리거된 방식. 다음 중 하나: "cli", "error", "integrated", "internal", "manual", "retry", "trigger", "webhook", "evaluation", "chat"
data[].startedAt `string null`
data[].stoppedAt `string null`
data[].waitTill `string null`
count integer 일치하는 실행의 총 개수. 개수를 사용할 수 없는 경우 -1
estimated boolean 대규모 데이터 세트에 대한 추정치인지 여부
error string 쿼리가 실패한 경우의 오류 메시지

자격 증명 관리#

list_credentials#

Note

n8n v2.21.0부터 사용 가능

현재 사용자가 접근할 수 있는 자격 증명을 나열합니다. 워크플로 노드에서 참조하기 전에 자격 증명 ID를 찾는 데 사용하세요. 자격 증명 비밀 데이터는 절대 반환하지 않습니다.

매개변수#

Name Type Required Description
limit integer 아니요 결과 수 제한(최대 200)
query string 아니요 이름으로 자격 증명 필터링(부분 일치)
type string 아니요 자격 증명 타입으로 필터링. 예: "slackApi" 또는 "httpHeaderAuth"(부분 일치)
projectId string 아니요 결과를 이 프로젝트에 속한 자격 증명으로 제한
onlySharedWithMe boolean 아니요 현재 사용자와 직접 공유된 자격 증명만 반환합니다. 기본값은 false입니다.

출력#

Field Type Description
data array 현재 사용자가 접근할 수 있는 자격 증명 목록
data[].id string 자격 증명의 고유 식별자
data[].name string 자격 증명 이름
data[].type string 자격 증명 타입. 예: "slackApi"
data[].scopes string[] 이 자격 증명에 대한 사용자 권한. 예: "credential:read"
data[].isManaged boolean 자격 증명이 n8n에 의해 관리되어 사용자가 편집할 수 없는지 여부
data[].isGlobal boolean 자격 증명이 모든 사용자에게 제공되는지 여부
data[].homeProject `object null`
data[].homeProject.id string 프로젝트의 고유 식별자
data[].homeProject.name string 프로젝트 이름
data[].homeProject.type string 프로젝트 타입. "personal"은 사용자의 개인 프로젝트이고, "team"은 여러 사용자가 접근할 수 있는 공유 프로젝트입니다.
count integer 반환된 자격 증명 수
error string 요청이 실패한 경우의 오류 메시지

참고#

  • 최대 결과 제한은 200개입니다.
  • 자격 증명 비밀 데이터는 절대 반환되지 않습니다.
  • 기본적으로 전역 자격 증명이 포함됩니다. 전역 자격 증명을 제외하고 현재 사용자와 직접 공유된 자격 증명만 반환하려면 onlySharedWithMe를 true로 설정하세요.

워크플로 빌더#

get_sdk_reference#

Note

n8n v2.12.0부터 사용 가능

패턴, 표현식 구문, 함수, 규칙, import 구문, 가이드라인, 설계 지침을 포함한 n8n Workflow SDK 참조 문서를 가져옵니다.

매개변수#

Name Type Required Default Description
section string 아니요 "all" 조회할 문서 섹션. 다음 중 하나: "patterns", "patterns_detailed", "expressions", "functions", "rules", "import", "guidelines", "design", "all"

출력#

Field Type Description
reference string 요청한 섹션에 대한 SDK 참조 문서 내용

참고#

  • 워크플로를 만들기 전에 먼저 호출해야 합니다.
  • 전체 참조를 조회하려면 section을 생략하거나 "all"로 설정하세요.
  • 확장된 워크플로 패턴 예제는 "patterns_detailed"를 사용하세요.

search_nodes#

Note

n8n v2.12.0부터 사용 가능

서비스 이름, 트리거 타입, 또는 유틸리티 기능으로 n8n 노드를 검색합니다. get_node_types 도구에 필요한 노드 ID, 판별자(resource/operation/mode), 관련 노드를 반환합니다.

매개변수#

Name Type Required Description
queries string[] 예 (최소 1개) 검색 쿼리 -- 서비스 이름(예: "gmail", "slack"), 트리거 타입(예: "schedule trigger", "webhook"), 또는 유틸리티 노드(예: "set", "if", "merge", "code")

출력#

Field Type Description
results string 일치하는 노드 ID, 판별자, 관련 노드가 포함된 검색 결과

get_node_types#

Note

n8n v2.12.0부터 사용 가능

n8n 노드에 대한 TypeScript 타입 정의를 가져옵니다. 정확한 매개변수 이름과 구조를 반환합니다.

매개변수#

Name Type Required Description
nodeIds array 예 (최소 1개) 노드 타입 요청 객체의 배열. 단일 노드인 경우에도 항상 객체로 전달합니다. 예: { "nodeId": "n8n-nodes-base.gmail" }. 사용 가능한 경우 search_nodes 결과의 판별자를 포함하세요.

Node ID object format:

Field Type Required Description
nodeId string 예 노드 타입 ID(예: "n8n-nodes-base.gmail")
version string 아니요 특정 버전(예: "2.1")
resource string 아니요 리소스 판별자(예: "message")
operation string 아니요 작업 판별자(예: "send")
mode string 아니요 모드 판별자

출력#

Field Type Description
definitions string 요청한 노드에 대한 TypeScript 타입 정의

참고#

  • 올바른 노드 구성에 필수적입니다. MCP 클라이언트는 워크플로 코드를 작성하기 전에 항상 이 도구를 호출해야 합니다.
  • n8n v2.27.0부터 모든 nodeIds 항목은 객체여야 합니다. 일반 문자열 노드 ID는 더 이상 허용되지 않으므로 { "nodeId": "..." }로 감싸야 합니다.
  • 다중 변형 노드에는 resource, operation, mode 판별자를 사용하세요.

get_workflow_best_practices#

Note

n8n v2.26.0부터 사용 가능

워크플로 기법에 대한 모범 사례 지침을 가져옵니다. 노드를 검색하거나 워크플로 코드를 작성하기 전에 유용합니다.

매개변수#

Name Type Required Description
technique string 예 지침을 가져올 워크플로 기법 키. 사용 가능한 모든 기법을 확인하려면 "list"를 전달하세요. 값에는 다음이 포함됩니다: "scheduling", "chatbot", "form_input", "scraping_and_research", "monitoring", "enrichment", "triage", "content_generation", "document_processing", "data_extraction", "data_analysis", "data_transformation", "data_persistence", "notification", "knowledge_base", "human_in_the_loop", "web_app"

출력#

Field Type Description
technique string 요청한 기법 키. 사용 가능한 모든 기법을 나열하는 경우 "list"
message string 응답에 대한 사람이 읽을 수 있는 요약
documentation string 사용 가능한 경우 요청한 기법에 대한 모범 사례 문서
availableTechniques array technique가 "list"인 경우 반환되는 사용 가능한 기법 목록
availableTechniques[].technique string 기법 키
availableTechniques[].description string 기법 설명
availableTechniques[].hasDocumentation boolean 이 기법에 대한 상세한 모범 사례 문서가 있는지 여부

참고#

  • technique: "list"로 호출하면 사용 가능한 모든 기법을 나열합니다
  • 일부 알려진 기법은 아직 상세 문서가 없을 수 있습니다. 이 경우 도구는 documentation 없이 메시지를 반환합니다.
  • 이 도구는 이전의 get_suggested_nodes 워크플로 계획 지침을 대체합니다.

explore_node_resources#

Note

n8n v2.27.0부터 사용 가능

노드의 리소스 로케이터 또는 로드 옵션 드롭다운(예: Slack 채널, Google Sheets 탭, 사용 가능한 AI 모델) 뒤에 있는 실제 값을 확인합니다. 원하는 서비스에 대한 자격 증명이 설정되어 있어야 합니다.

매개변수#

Name Type Required Description
nodeType string 예 search_nodes / get_node_types에서 얻은 완전한 노드 타입 ID. 예: "n8n-nodes-base.slack"
version number 예 노드 버전(예: 4.7). search_nodes가 반환한 버전과 일치해야 합니다.
methodName string 예 타입 정의의 노드 @searchListMethod 또는 @loadOptionsMethod 주석에서 얻은 정확한 메서드 이름. 실제 메서드 이름을 읽으려면 먼저 get_node_types를 호출하세요. 추측하지 마세요.
methodType `"listSearch" "loadOptions"` 예
credentialType string 예 노드에 대한 자격 증명 타입 키. 예: "slackApi" 또는 "googleSheetsOAuth2Api"
credentialId string 예 list_credentials에서 얻은, 사용자가 접근할 수 있는 자격 증명의 ID
filter string 아니요 결과를 좁히기 위한 선택적 검색/필터 텍스트
paginationToken string 아니요 다음 페이지를 가져오기 위한 이전 호출의 페이지네이션 토큰(listSearch만 해당)
currentNodeParameters object 아니요 종속적인 조회를 위한 현재 노드 매개변수. 일부 메서드는 사전 선택이 필요합니다. 예를 들어, 스프레드시트 내 시트 목록을 조회하려면 { documentId: { __rl: true, mode: "id", value: "<spreadsheetId>" } }가 필요합니다. 메서드가 의존하는 매개변수를 확인하려면 타입 정의의 displayOptions를 확인하세요.

출력#

Field Type Description
results array 노드 메서드가 반환한 리소스
results[].name string 리소스의 표시 레이블
results[].value `string number
results[].url string 사용 가능한 경우 리소스 URL
results[].description string 사용 가능한 경우 리소스 설명
paginationToken string 다음 페이지를 가져오려면 paginationToken으로 다시 전달하세요. 더 이상 결과가 없으면 존재하지 않습니다.
builderHint string 존재하는 경우 노드의 @builderHint 주석에서 얻은 선택 지침

참고#

  • list_credentials에서 얻은 credentialId가 필요합니다. 조회는 해당 자격 증명을 사용하여 현재 사용자로 실행됩니다.
  • listSearch 메서드는 filter와 paginationToken을 통한 페이지네이션을 지원하지만, loadOptions 메서드는 지원하지 않습니다.
  • 이 도구는 대부분의 다른 읽기 전용 도구와 달리 외부 서비스에 접근합니다.

validate_workflow#

Note

n8n v2.12.0부터 사용 가능

n8n Workflow SDK 코드를 검증합니다. 코드를 워크플로로 파싱하고 오류를 확인합니다. 워크플로를 생성하거나 업데이트하기 전에 항상 검증하세요.

매개변수#

Name Type Required Description
code string 예 n8n Workflow SDK를 사용하는 전체 TypeScript/JavaScript 워크플로 코드. 워크플로 export를 포함해야 합니다.

출력#

Field Type Description
valid boolean 워크플로 코드가 유효한지 여부
nodeCount number 워크플로의 노드 수. 유효한 경우에만 존재
warnings array 검증 경고(있는 경우)
warnings[].code string 경고 유형을 식별하는 경고 코드
warnings[].message string 경고 메시지
warnings[].nodeName string 해당하는 경우 경고를 유발한 노드
warnings[].parameterPath string 해당하는 경우 경고를 유발한 매개변수 경로
errors string[] 검증 오류. 유효하지 않은 경우에만 존재
hint string 사용 가능한 경우 실행 가능한 복구 힌트

참고#

  • create_workflow_from_code 또는 update_workflow보다 먼저 호출해야 합니다.
  • 코드가 유효한 경우에도 경고가 있을 수 있습니다.
  • valid가 false이고 hint가 존재하는 경우, 다시 시도하기 전에 힌트를 따르세요.

validate_node_config#

Note

n8n v2.25.1부터 사용 가능

하나 이상의 노드 구성을 생성된 노드 스키마에 대해 독립적으로 검증합니다. 워크플로 코드를 조립하거나 update_workflow를 호출하기 전, 노드를 구성하는 동안 유용합니다.

매개변수#

Name Type Required Description
nodes array 예 (최소 1개, 최대 50개) 독립적으로 검증할 하나 이상의 노드 구성
nodes[].name string 아니요 선택적 노드 이름. 응답을 연관시키는 데 도움이 되도록 결과에 반환됨
nodes[].type string 예 전체 노드 타입. 예: "n8n-nodes-base.set" 또는 "@n8n/n8n-nodes-langchain.agent"
nodes[].typeVersion number 아니요 노드 타입 버전. 기본값은 1
nodes[].parameters object 아니요 워크플로 JSON과 동일한 형태를 사용하는 노드 매개변수 객체. 기본값은 {}
nodes[].subnodes unknown 아니요 AI 부모 노드에 대한 선택적 서브노드 구성. 예: LangChain 에이전트 모델, 메모리, 또는 도구 참조
nodes[].isToolNode boolean 아니요 ai_tool 연결을 통해 AI 도구 서브노드로 연결된 노드를 검증할 때 true로 설정

출력#

Field Type Description
valid boolean 모든 노드 구성이 유효한지 여부
results array 입력 순서대로 노드별 검증 결과
results[].index number 입력 배열에서 이 노드의 위치
results[].name string 제공된 경우 입력 노드 이름의 에코
results[].type string 입력 노드 타입의 에코
results[].valid boolean 이 노드 구성이 유효한지 여부
results[].errors array 이 노드에 대한 검증 오류. 노드가 유효한 경우 생략됨
results[].errors[].path string 오류의 매개변수 경로
results[].errors[].message string 사람이 읽을 수 있는 오류 메시지
error string 검증을 실행할 수 없는 경우의 최상위 오류 메시지

참고#

  • 이 도구는 노드 매개변수 스키마만 검증합니다.
  • 연결, 필수 입력, 트리거, 연결이 끊긴 노드, 자격 증명 존재 여부와 같은 워크플로 수준의 문제는 확인하지 않습니다.
  • LangChain 또는 AI 도구 서브노드의 경우, 스키마가 올바른 표시 옵션 분기를 평가하도록 isToolNode를 true로 설정하세요.

create_workflow_from_code#

Note

n8n v2.12.0부터 사용 가능

검증된 SDK 코드로부터 n8n에서 워크플로를 생성합니다. 코드를 워크플로로 파싱하여 저장합니다.

매개변수#

Name Type Required Description
code string 예 n8n Workflow SDK를 사용하는 전체 TypeScript/JavaScript 워크플로 코드. 먼저 validate_workflow로 검증해야 합니다.
skillsUsed string[] 아니요 이 워크플로를 만드는 데 MCP 클라이언트가 사용한 n8n 스킬 이름. 값은 서버 측에서 정규화됩니다.
name string 아니요 선택적 워크플로 이름(최대 128자). 제공하지 않으면 코드의 이름을 사용합니다.
description string 아니요 워크플로 설명. 255자를 초과하는 텍스트는 저장하기 전에 255자로 줄여집니다.
projectId string 아니요 워크플로를 생성할 프로젝트 ID. 기본값은 사용자의 개인 프로젝트입니다. 사용자가 프로젝트 이름을 지정한 경우 먼저 search_projects를 사용하세요.
folderId string 아니요 워크플로를 생성할 폴더 ID. projectId가 설정되어 있어야 합니다. 프로젝트 내에서 이름으로 폴더를 찾으려면 search_folders를 사용하세요.

출력#

Field Type Description
workflowId string 생성된 워크플로의 ID
name string 생성된 워크플로의 이름
nodeCount number 워크플로의 노드 수
url string n8n에서 워크플로를 여는 URL
autoAssignedCredentials array 노드에 자동으로 할당된 자격 증명 목록
autoAssignedCredentials[].nodeName string 자격 증명이 자동으로 할당된 노드의 이름
autoAssignedCredentials[].credentialName string 자동으로 할당된 자격 증명의 이름
autoAssignedCredentials[].credentialType string 자동으로 할당된 자격 증명 타입
targetProject object 워크플로가 생성된 프로젝트
targetProject.id string 프로젝트의 ID
targetProject.name string 프로젝트의 표시 이름
targetProject.type `"personal" "team"`
note string 워크플로 생성에 대한 추가 참고 사항. 예: 자격 증명 자동 할당 중 건너뛴 노드나 255자로 줄여진 설명
hint string 오류 발생 후 사용 가능한 경우 실행 가능한 복구 힌트

참고#

  • 사용 가능한 자격 증명을 노드에 자동으로 할당합니다.
  • HTTP Request 노드는 자격 증명 자동 할당 중 건너뛰며 수동으로 구성해야 합니다.
  • 생성된 워크플로에 availableInMCP 플래그를 true로 설정합니다.
  • 워크플로에 aiBuilderAssisted 메타데이터와 builderVariant: mcp를 표시합니다.
  • 웹훅 노드 ID를 자동으로 확인합니다.
  • folderId를 사용하려면 projectId도 함께 제공해야 합니다.
  • 사용자가 대상 프로젝트 이름을 지정한 경우, 먼저 search_projects를 호출하고 확인된 projectId를 전달하세요. 추측하지 마세요.
  • 생성 후, targetProject 필드를 사용하여 워크플로가 생성된 프로젝트를 사용자에게 알려주세요.
  • n8n v2.27.0부터 255자를 초과하는 description은 거부되지 않고 잘립니다. 이 경우 응답의 note에 명시됩니다.

update_workflow#

Note

n8n v2.12.0부터 사용 가능합니다. v2.20.0부터 이 도구는 업데이트할 때마다 전체 워크플로를 다시 작성하는 대신 부분 업데이트를 수행하도록 전환되었습니다.

대상이 지정된 부분 업데이트의 순서화된 배치를 적용하여 n8n의 기존 워크플로를 업데이트합니다. 배치는 원자적(atomic)입니다. 작업 중 하나라도 실패하면 변경 사항이 저장되지 않습니다.

매개변수#

Name Type Required Description
workflowId string 예 업데이트할 워크플로의 ID
skillsUsed string[] 아니요 이 워크플로 업데이트를 만드는 데 MCP 클라이언트가 사용한 n8n 스킬 이름. 값은 서버 측에서 정규화됩니다.
operations array 예 적용할 작업의 순서화된 목록. 1~100개의 작업을 포함해야 합니다.

지원되는 작업#

Operation Required fields Optional fields Description
updateNodeParameters nodeName, parameters replace 기존 노드의 매개변수에 parameters를 딥 머지합니다. replace가 true인 경우 전체 매개변수 객체를 교체합니다.
setNodeParameter nodeName, path, value RFC 6901 JSON 포인터 경로를 사용하여 매개변수 하나를 설정합니다. 예: /jsonSchema 또는 /options/systemMessage. 필요한 경우 중간 객체를 생성합니다. 배열 인덱스는 지원되지 않으므로 배열 전체를 설정하세요.
addNode node.name, node.type, node.typeVersion node.id, node.parameters, node.position, node.credentials, node.disabled, node.notes 노드를 추가합니다. position은 [x, y]입니다. id를 생략하면 자동 생성됩니다. 노드 이름은 고유해야 합니다.
removeNode nodeName 노드와 모든 인바운드 및 아웃바운드 연결을 제거합니다. 연결된 서브노드는 워크플로에 남지만 연결이 끊깁니다.
renameNode oldName, newName 노드 이름을 변경하고 연결 참조를 다시 작성합니다. 새 이름은 고유해야 합니다.
addConnection source, target sourceIndex, targetIndex, connectionType 연결을 추가합니다. sourceIndex와 targetIndex의 기본값은 0이고, connectionType의 기본값은 main입니다. 동일한 기존 연결은 중복 생성되지 않습니다.
removeConnection source, target sourceIndex, targetIndex, connectionType 일치하는 연결을 제거합니다. sourceIndex와 targetIndex의 기본값은 0이고, connectionType의 기본값은 main입니다.
setNodeCredential nodeName, credentialKey, credentialId, credentialName 노드 자격 증명 참조를 설정하거나 교체합니다. 자격 증명은 접근 가능해야 하며 노드 타입이 허용하는 자격 증명 키와 일치해야 합니다.
setNodePosition nodeName, position 노드의 캔버스 위치를 [x, y]로 업데이트합니다.
setNodeDisabled nodeName, disabled 노드를 활성화하거나 비활성화합니다.
setNodeSettings nodeName, settings 노드 수준의 실행 설정을 업데이트합니다. settings에는 지원되는 설정이 하나 이상 포함되어야 합니다.
setWorkflowMetadata name, description 워크플로 메타데이터를 업데이트합니다. name의 최대 길이는 128자이고, description의 최대 길이는 255자입니다.

setNodeSettings 필드#

Field Type Required Description
onError `"stopWorkflow" "continueRegularOutput" "continueErrorOutput"`
retryOnFail boolean 아니요 노드가 실패했을 때 재시도할지 여부
maxTries integer 아니요 retryOnFail이 true일 때의 시도 횟수. 2~5여야 함
waitBetweenTries integer 아니요 재시도 사이에 대기할 밀리초. 0~5000이어야 함
alwaysOutputData boolean 아니요 노드가 항상 데이터를 출력해야 하는지 여부
executeOnce boolean 아니요 노드가 한 번만 실행되어야 하는지 여부

출력#

Field Type Description
workflowId string 업데이트된 워크플로의 ID
name string 업데이트된 워크플로의 이름
nodeCount number 워크플로의 노드 수
url string n8n에서 워크플로를 여는 URL
appliedOperations number 적용된 작업 수
autoAssignedCredentials array 이번 업데이트에서 추가된 노드에 자동으로 할당된 자격 증명
autoAssignedCredentials[].nodeName string 자격 증명이 자동으로 할당된 노드
autoAssignedCredentials[].credentialName string 자동으로 할당된 자격 증명
autoAssignedCredentials[].credentialType string 자동으로 할당된 자격 증명 타입
validationWarnings array 결과 워크플로에 대한 그래프 및 JSON 검증 경고. 이 경고는 저장을 막지 않습니다
validationWarnings[].code string 경고 코드
validationWarnings[].message string 경고 메시지
validationWarnings[].nodeName string 경고와 연관된 선택적 노드
note string 워크플로 업데이트에 대한 추가 참고 사항. 예: 자격 증명 자동 할당 중 건너뛴 HTTP Request 노드
error string 업데이트가 실패한 경우의 오류 메시지

참고#

  • 작업은 순서대로 적용되고 원자적으로 저장됩니다.
  • 기존 자격 증명은 명시적으로 변경하지 않는 한 유지됩니다.
  • 자격 증명 자동 할당은 현재 호출에서 추가된 노드에만 실행됩니다.
  • HTTP Request 노드는 자격 증명 자동 할당 중 건너뛰며 수동으로 구성해야 합니다.
  • 결과 워크플로는 저장하기 전에 검증됩니다. 검증 경고는 validationWarnings에 반환됩니다.
  • 워크플로에 aiBuilderAssisted 메타데이터와 builderVariant: mcp를 표시합니다.

archive_workflow#

Note

n8n v2.12.0부터 사용 가능

ID로 n8n의 워크플로를 보관(archive)합니다.

매개변수#

Name Type Required Description
workflowId string 예 보관할 워크플로의 ID

출력#

Field Type Description
archived boolean 워크플로가 보관되었는지 여부
workflowId string 보관된 워크플로의 ID
name string 보관된 워크플로의 이름

참고#

  • 멱등적(idempotent)입니다. 이미 보관된 워크플로는 건너뜁니다.

데이터 테이블#

search_data_tables#

Note

n8n v2.16.0부터 사용 가능

현재 사용자가 접근할 수 있는 데이터 테이블을 검색합니다. 데이터를 수정하거나 추가하기 전에 데이터 테이블 ID를 찾는 데 사용하세요.

매개변수#

Name Type Required Description
query string 아니요 이름으로 데이터 테이블 필터링(대소문자를 구분하지 않는 부분 일치)
projectId string 아니요 프로젝트 ID로 필터링
limit integer 아니요 결과 수 제한(최대 100)

출력#

Field Type Description
data array 쿼리와 일치하는 데이터 테이블 목록
data[].id string 데이터 테이블의 고유 식별자
data[].name string 데이터 테이블 이름
data[].projectId string 이 데이터 테이블이 속한 프로젝트
data[].createdAt string 데이터 테이블이 생성된 시점의 ISO 타임스탬프
data[].updatedAt string 데이터 테이블이 마지막으로 업데이트된 시점의 ISO 타임스탬프
data[].columns array 이 데이터 테이블에 정의된 열
data[].columns[].id string 열의 고유 식별자
data[].columns[].name string 열 이름
data[].columns[].type string 열 데이터 타입. 다음 중 하나: "string", "number", "boolean", "date"
data[].columns[].index integer 테이블 내 열의 위치
count integer 일치하는 데이터 테이블의 총 개수

참고#

  • 최대 결과 제한은 100개입니다.

create_data_table#

Note

n8n v2.16.0부터 사용 가능

지정된 열로 새 데이터 테이블을 생성합니다.

매개변수#

Name Type Required Description
projectId string 예 데이터 테이블이 생성될 프로젝트 ID
name string 예 데이터 테이블 이름(최소 1자, 최대 128자, 프로젝트 내에서 고유해야 함)
columns array 예 (최소 1개) 데이터 테이블에 생성할 열
columns[].name string 예 열 이름. 문자로 시작해야 하며, 문자, 숫자, 밑줄만 포함할 수 있습니다(최대 63자).
columns[].type string 예 열의 데이터 타입. 다음 중 하나: "string", "number", "boolean", "date"

출력#

Field Type Description
id string 생성된 데이터 테이블의 고유 식별자
name string 생성된 데이터 테이블의 이름
projectId string 생성된 데이터 테이블의 프로젝트 ID

참고#

  • 열이 하나 이상 필요합니다.
  • 테이블 이름은 프로젝트 내에서 고유해야 합니다.
  • 열 이름은 다음 패턴과 일치해야 합니다: ^[a-zA-Z][a-zA-Z0-9_]*$ (최대 63자).

add_data_table_column#

Note

n8n v2.16.0부터 사용 가능

기존 데이터 테이블에 새 열을 추가합니다.

매개변수#

Name Type Required Description
dataTableId string 예 열을 추가할 데이터 테이블의 ID
projectId string 예 데이터 테이블이 속한 프로젝트 ID
name string 예 열 이름. 문자로 시작해야 하며, 문자, 숫자, 밑줄만 포함할 수 있습니다(최대 63자).
type string 예 새 열의 데이터 타입. 다음 중 하나: "string", "number", "boolean", "date"

출력#

Field Type Description
success boolean 작업 성공 여부
message string 결과 설명
column object 생성된 열
column.id string 열의 고유 식별자
column.name string 열 이름
column.type string 열 데이터 타입

참고#

  • 열 이름은 다음 패턴과 일치해야 합니다: ^[a-zA-Z][a-zA-Z0-9_]*$ (최대 63자).
  • 생성 후 열 타입은 (MCP를 통해서는) 변경할 수 없습니다.

rename_data_table_column#

Note

n8n v2.16.0부터 사용 가능

데이터 테이블의 열 이름을 변경합니다.

매개변수#

Name Type Required Description
dataTableId string 예 열을 포함하는 데이터 테이블의 ID
projectId string 예 데이터 테이블이 속한 프로젝트 ID
columnId string 예 이름을 변경할 열의 ID
name string 예 새 열 이름. 열 이름 규칙을 따라야 합니다.

출력#

Field Type Description
success boolean 작업 성공 여부
message string 결과 설명
column object 이름이 변경된 열
column.id string 열의 고유 식별자
column.name string 새 열 이름
column.type string 열 데이터 타입

참고#

  • 새 이름은 다음 열 이름 규칙을 따라야 합니다: ^[a-zA-Z][a-zA-Z0-9_]*$ (최대 63자).

delete_data_table_column#

Note

n8n v2.16.0부터 사용 가능

데이터 테이블에서 열을 삭제합니다. 이렇게 하면 열과 모든 데이터가 영구적으로 제거됩니다.

매개변수#

Name Type Required Description
dataTableId string 예 열을 포함하는 데이터 테이블의 ID
projectId string 예 데이터 테이블이 속한 프로젝트 ID
columnId string 예 삭제할 열의 ID

출력#

Field Type Description
success boolean 작업 성공 여부
message string 결과 설명

참고#

  • MCP를 통한 열 삭제는 취소할 수 없습니다.

rename_data_table#

Note

n8n v2.16.0부터 사용 가능

기존 데이터 테이블의 이름을 변경합니다.

매개변수#

Name Type Required Description
dataTableId string 예 이름을 변경할 데이터 테이블의 ID
projectId string 예 데이터 테이블이 속한 프로젝트 ID
name string 예 데이터 테이블의 새 이름(최소 1자, 최대 128자)

출력#

Field Type Description
success boolean 작업 성공 여부
message string 결과 설명

참고#

  • 이름은 프로젝트 내에서 고유해야 합니다.

add_data_table_rows#

Note

n8n v2.16.0부터 사용 가능

기존 데이터 테이블에 행을 삽입합니다. 각 행은 열 이름을 값에 매핑하는 객체입니다.

매개변수#

Name Type Required Description
dataTableId string 예 행을 삽입할 데이터 테이블의 ID
projectId string 예 데이터 테이블이 속한 프로젝트 ID
rows array 예 (최소 1개, 최대 1000개) 행 객체의 배열. 각 객체는 열 이름을 값(string, number, boolean, 또는 null)에 매핑합니다.

출력#

Field Type Description
success boolean 삽입 작업 성공 여부
insertedCount integer 성공적으로 삽입된 행 수

참고#

  • 호출당 최대 1000개 행.
  • 행 값은 string, number, boolean, 또는 null이어야 합니다.
  • 행 객체의 열 이름은 데이터 테이블에 있는 기존 열 이름과 일치해야 합니다.

n8n MCP 서버 도구 참조

n8n v2.29
원문 보기
요약

이 페이지는 인스턴스 수준 MCP 서버가 노출하는 모든 도구를 설명합니다. 선택적 필터를 사용하여 워크플로를 검색합니다. 트리거 세부 정보를 포함하여 특정 워크플로에 대한 상세 정보를 가져옵니다. ID로 워크플로를 실행합니다.

이 페이지는 인스턴스 수준 MCP 서버가 노출하는 모든 도구를 설명합니다.

워크플로 관리#

search_workflows#

선택적 필터를 사용하여 워크플로를 검색합니다. 각 워크플로의 미리보기를 반환합니다.

매개변수#

Name Type Required Default Description
query string 아니요 이름 또는 설명으로 필터링
projectId string 아니요 프로젝트 ID로 필터링
tags string[] 아니요 태그 이름으로 필터링합니다. AND 의미론을 사용하므로 워크플로가 일치하려면 나열된 모든 태그를 가지고 있어야 합니다.
limit integer 아니요 200 결과 수 제한(최대 200)
sortBy string 아니요 "updatedAt:desc" 결과 정렬 순서. 다음 중 하나: "updatedAt:desc", "updatedAt:asc", "createdAt:desc", "createdAt:asc", "name:asc", "name:desc"

출력#

Field Type Description
data array 워크플로 미리보기 목록
data[].id string 워크플로의 고유 식별자
data[].name `string null`
data[].description `string null`
data[].active `boolean null`
data[].createdAt `string null`
data[].updatedAt `string null`
data[].triggerCount `number null`
data[].scopes string[] 이 워크플로에 대한 사용자 권한
data[].canExecute boolean 사용자가 이 워크플로를 실행할 권한이 있는지 여부
data[].availableInMCP boolean 워크플로가 MCP 도구에 노출되는지 여부
data[].tags array 워크플로에 할당된 태그. 각각 id와 name을 가짐
count integer 필터와 일치하는 워크플로의 총 개수

참고#

  • 최대 결과 제한은 200개입니다.
  • 기본적으로 결과는 최근에 업데이트된 워크플로부터 정렬됩니다.
  • 각 워크플로에 대한 사용자 권한 범위를 포함하여 MCP 클라이언트가 워크플로에서 사용 가능한 작업을 확인할 수 있습니다.
  • tags로 필터링하는 기능과 결과의 tags 필드는 n8n v2.27.0부터 사용할 수 있습니다. 사용 가능한 태그 이름을 확인하려면 list_tags를 사용하세요.
  • 중요: 이 도구는 Available in MCP 설정과 관계없이 사용자가 접근 권한을 가진 모든 워크플로를 나열할 수 있습니다.

get_workflow_details#

트리거 세부 정보를 포함하여 특정 워크플로에 대한 상세 정보를 가져옵니다.

매개변수#

Name Type Required Description
workflowId string 예 조회할 워크플로의 ID

출력#

Field Type Description
workflow object MCP에서 사용하기에 안전하게 정제된 워크플로 데이터
workflow.id string 워크플로 ID
workflow.name `string null`
workflow.active boolean 워크플로에 게시된 활성 버전이 있는지 여부
workflow.isArchived boolean 워크플로가 보관(archive)되었는지 여부
workflow.versionId string 현재 워크플로 버전 ID
workflow.activeVersionId `string null`
workflow.triggerCount number 트리거 수
workflow.createdAt `string null`
workflow.updatedAt `string null`
workflow.settings `object null`
workflow.connections object 워크플로 연결 그래프
workflow.nodes array 워크플로 노드 목록. 자격 증명 참조는 제거됨
workflow.activeVersion `object null`
workflow.activeVersion.nodes array 활성 워크플로 버전의 노드. 자격 증명 참조는 제거됨
workflow.activeVersion.connections object 활성 워크플로 버전의 연결
workflow.tags array id와 name을 가진 태그
workflow.meta `object null`
workflow.parentFolderId `string null`
workflow.description string 설정된 경우 워크플로 설명
workflow.scopes string[] 이 워크플로에 대한 사용자 권한
workflow.canExecute boolean 사용자가 이 워크플로를 실행할 권한이 있는지 여부
triggerInfo string 워크플로를 트리거하는 방법을 설명하는 사람이 읽을 수 있는 안내

참고#

  • 반환된 노드에서 민감한 자격 증명 데이터는 제거됩니다.
  • 워크플로가 게시된 경우 활성 버전 세부 정보를 포함합니다.
  • 사용자 권한 범위와 현재 사용자가 워크플로를 실행할 수 있는지 여부를 포함합니다.
  • 지원되는 트리거 노드를 호출하는 방법을 이해하려면 triggerInfo를 사용하세요.

execute_workflow#

ID로 워크플로를 실행합니다. 완료를 기다리지 않고 즉시 실행 ID를 반환합니다.

매개변수#

Name Type Required Default Description
workflowId string 예 실행할 워크플로의 ID
executionMode `"manual" "production"` 아니요 "production"
inputs object 아니요 워크플로에 제공할 입력(판별 유니언, 아래 참조)

inputs variants(type로 구분됨):

Type Fields Description
chat chatInput: string 채팅 기반 워크플로에 대한 입력
form formData: Record<string, unknown> 폼 기반 워크플로에 대한 입력 데이터
webhook webhookData: { method?, query?, body?, headers? } 웹훅 기반 워크플로에 대한 입력 데이터

webhookData fields:

Field Type Required Default Description
method `"GET" "POST" "PUT" "DELETE"
query Record<string, string> 아니요 쿼리 문자열 매개변수
body Record<string, unknown> 아니요 요청 본문 데이터
headers Record<string, string> 아니요 HTTP 헤더

출력#

Field Type Description
executionId `string null`
status `"started" "error"`
error string 실행을 시작할 수 없는 경우의 오류 메시지

참고#

  • 이 도구는 워크플로를 시작하고 즉시 반환합니다. 최종 실행 상태를 확인하거나 실행 데이터를 가져오려면 반환된 executionId와 함께 get_execution을 사용하세요.
  • 프로덕션 모드는 Webhook, Chat Trigger, Form Trigger, Schedule Trigger 노드가 있는 워크플로를 지원합니다.
  • 수동 모드는 Manual Trigger 노드도 지원합니다.
  • executionMode가 "production"인 경우 워크플로에 게시된(활성) 버전이 있어야 합니다.
  • 워크플로에 지원되는 트리거가 여러 개 있는 경우, 워크플로 실행 도구를 사용할 때 MCP 클라이언트는 그중 하나(첫 번째)만 사용하여 워크플로를 트리거할 수 있습니다.
  • 다단계 폼이나 사람이 개입하는(human-in-the-loop) 형태의 상호작용이 있는 워크플로 실행은 지원되지 않습니다.

test_workflow#

Note

n8n v2.15.0부터 사용 가능

핀 데이터를 사용하여 외부 서비스를 우회하면서 워크플로를 테스트합니다. 트리거 노드, 자격 증명이 있는 노드, HTTP Request 노드는 고정(핀)되어(시뮬레이션 데이터 사용) 실행됩니다. Set, If, Code 등 다른 노드는 Execute Command나 파일 읽기/쓰기 노드 같은 자격 증명이 필요 없는 I/O 노드를 포함하여 정상적으로 실행됩니다.

매개변수#

Name Type Required Description
workflowId string 예 테스트할 워크플로의 ID
pinData Record<string, array> 예 모든 워크플로 노드에 대한 핀 데이터.
triggerNodeName string 아니요 실행을 시작할 트리거 노드의 선택적 이름. 기본값은 첫 번째 트리거 노드입니다.

출력#

Field Type Description
executionId `string null`
status string 테스트 실행 상태. 다음 중 하나: "success", "error", "running", "waiting", "canceled", "crashed", "new", "unknown"
error string 실행이 실패한 경우의 오류 메시지

참고#

  • 자격 증명을 설정하거나 외부 서비스를 호출하지 않고도 워크플로 로직을 테스트하는 데 사용할 수 있습니다.
  • 이 도구는 워크플로를 동기적으로 실행합니다(실행이 끝날 때까지 대기).
  • 강제 적용되는 MCP 실행 제한 시간(5분)이 있습니다.

prepare_test_pin_data#

Note

n8n v2.15.0부터 사용 가능

워크플로에 대한 테스트 핀 데이터를 준비합니다. 트리거 노드, 자격 증명이 있는 노드, HTTP Request 노드는 핀 데이터가 필요합니다. 로직 노드(Set, If, Code 등)와 자격 증명이 필요 없는 I/O 노드(Execute Command, 파일 읽기/쓰기)는 핀 데이터 없이 정상적으로 실행됩니다. 핀 데이터가 필요한 각 노드에 대해 예상되는 출력 형태를 설명하는 JSON 스키마를 반환합니다.

매개변수#

Name Type Required Description
workflowId string 예 테스트 핀 데이터를 생성할 워크플로의 ID

출력#

Field Type Description
nodeSchemasToGenerate Record<string, JsonSchema> 핀 데이터가 필요한 노드. 키는 노드 이름이고, 값은 예상 출력 형태를 설명하는 JSON 스키마 객체입니다.
nodesWithoutSchema string[] 핀 데이터가 필요하지만 출력 스키마가 없는 노드 이름. 각각에 빈 기본값 [{"json": {}}]을 사용하세요.
nodesSkipped string[] 핀 데이터가 필요하지 않고 테스트 중 정상적으로 실행될 노드.
coverage object 커버리지 통계
coverage.withSchemaFromExecution number 마지막으로 성공한 실행 출력에서 추론된 스키마를 가진 노드
coverage.withSchemaFromDefinition number 노드 타입 정의에서 얻은 스키마를 가진 노드
coverage.withoutSchema number 데이터나 스키마가 없는 노드
coverage.skipped number 정상적으로 실행될 노드(핀 데이터 불필요)
coverage.total number 활성화된 노드의 총 개수

참고#

  • 스키마는 test_workflow에 사용할 현실적인 샘플 데이터를 생성하는 데 사용해야 합니다.

publish_workflow#

Note

n8n v2.12.0부터 사용 가능

워크플로를 게시(활성화)하여 프로덕션 실행에 사용할 수 있도록 합니다. 이렇게 하면 현재 초안(draft)으로부터 활성 버전이 생성됩니다.

매개변수#

Name Type Required Description
workflowId string 예 게시할 워크플로의 ID
versionId string 아니요 게시할 버전 ID(선택 사항). 제공하지 않으면 현재 초안 버전을 게시합니다.

출력#

Field Type Description
success boolean 게시 성공 여부
workflowId string 워크플로 ID
activeVersionId `string null`
error string 게시가 실패한 경우의 오류 메시지

unpublish_workflow#

Note

n8n v2.12.0부터 사용 가능

워크플로를 게시 취소(비활성화)하여 프로덕션 실행에 사용할 수 없도록 합니다.

매개변수#

Name Type Required Description
workflowId string 예 게시 취소할 워크플로의 ID

출력#

Field Type Description
success boolean 게시 취소 성공 여부
workflowId string 워크플로 ID
error string 게시 취소가 실패한 경우의 오류 메시지

search_projects#

Note

n8n v2.14.0부터 사용 가능

현재 사용자가 접근할 수 있는 프로젝트를 검색합니다. 특정 프로젝트에서 워크플로나 데이터 테이블을 생성하기 전에 프로젝트 ID를 확인하는 데 사용하세요.

매개변수#

Name Type Required Description
query string 아니요 이름으로 프로젝트를 필터링합니다. 결과는 대소문자를 구분하지 않는 완전 일치가 먼저, 부분 일치가 그다음 순으로 정렬됩니다.
type `"personal" "team"` 아니요
limit integer 아니요 결과 수 제한(최대 100)

출력#

Field Type Description
data array 일치하는 프로젝트 목록. 대소문자를 구분하지 않는 완전 일치가 먼저 정렬됨
data[].id string 프로젝트의 고유 식별자
data[].name string 프로젝트 이름
data[].type `"personal" "team"`
data[].matchType `"exact" "partial"`
count integer 일치하는 프로젝트의 총 개수
teamProjectsEnabled boolean 이 인스턴스에서 팀 프로젝트가 라이선스로 활성화되어 있는지 여부. false인 경우, 사용자가 반환된 접근 가능 프로젝트 중 하나를 명시적으로 선택하지 않는 한 create_workflow_from_code에서 projectId가 기본적으로 생략되어 워크플로가 호출자의 개인 프로젝트에 생성됩니다. 오류 응답에서는 생략됩니다. n8n v2.26.0부터 사용 가능합니다.
hint string 결과 선택에 대한 안내. 일치 항목이 모호한 경우(예: 완전 일치는 없지만 부분 일치가 여러 개인 경우) 또는 이 인스턴스에서 팀 프로젝트가 라이선스로 활성화되어 있지 않은 경우에 존재

참고#

  • 최대 결과 제한은 100개입니다.
  • 사용자가 프로젝트 이름을 지정한 경우, 먼저 이 도구를 호출하고 확인된 프로젝트 ID를 create_workflow_from_code, update_workflow 또는 데이터 테이블 도구에 전달하세요.
  • hint가 존재하는 경우 작업을 수행하기 전에 이를 따르세요. 예를 들어, 여러 부분 일치 중에서 추측하는 대신 사용자에게 명확히 확인을 요청하세요.

search_folders#

Note

n8n v2.14.0부터 사용 가능

프로젝트 내의 폴더를 검색합니다.

매개변수#

Name Type Required Description
projectId string 예 폴더를 검색할 프로젝트의 ID
query string 아니요 이름으로 폴더 필터링(대소문자를 구분하지 않는 부분 일치)
limit integer 아니요 결과 수 제한(최대 100)

출력#

Field Type Description
data array 일치하는 폴더 목록
data[].id string 폴더의 고유 식별자
data[].name string 폴더 이름
data[].parentFolderId `string null`
count integer 일치하는 폴더의 총 개수

참고#

  • 최대 결과 제한은 100개입니다.
  • 이 도구를 사용하면 MCP 클라이언트가 특정 폴더에 워크플로를 생성할 수 있습니다.

list_tags#

Note

n8n v2.27.0부터 사용 가능

인스턴스의 모든 워크플로 태그를 나열합니다. 태그는 전역적이며(프로젝트 범위가 아님) search_workflows와 함께 결과를 필터링하는 데 사용할 수 있습니다.

매개변수#

Name Type Required Default Description
limit integer 아니요 500 결과 수 제한(최대 500)

출력#

Field Type Description
data array 인스턴스에서 사용 가능한 워크플로 태그
data[].id string 태그의 고유 식별자
data[].name string 태그의 표시 이름
data[].usageCount integer 이 태그를 사용하는 보관되지 않은 워크플로 수
data[].createdAt string 태그가 생성된 시점의 ISO 타임스탬프
data[].updatedAt string 태그가 마지막으로 업데이트된 시점의 ISO 타임스탬프
count integer 반환된 태그 수
totalCount integer 제한을 적용하기 전 태그의 총 개수

참고#

  • 최대 결과 제한은 500개입니다.
  • 태그는 전역적이며 프로젝트 범위로 지정되지 않습니다.
  • usageCount는 보관되지 않은 워크플로만 계산합니다.
  • tag:list 전역 권한이 필요합니다.
  • 인스턴스에서 워크플로 태그가 활성화된 경우에만 사용할 수 있습니다. 인스턴스 설정에서 태그가 비활성화된 경우 이 도구는 노출되지 않습니다.

실행 관리#

get_execution#

Note

n8n v2.12.0부터 사용 가능

실행 ID와 워크플로 ID로 실행 세부 정보를 가져옵니다. 기본적으로 메타데이터만 반환합니다.

매개변수#

Name Type Required Description
workflowId string 예 실행이 속한 워크플로의 ID
executionId string 예 조회할 실행의 ID
includeData boolean 아니요 전체 실행 결과 데이터를 포함할지 여부. 기본값은 false(메타데이터만)입니다.
nodeNames string[] 아니요 includeData가 true인 경우 이 노드들에 대한 데이터만 반환합니다. 생략하면 모든 노드의 데이터가 포함됩니다.
truncateData integer 아니요 includeData가 true인 경우 노드 출력당 반환되는 데이터 항목 수를 제한합니다.

출력#

Field Type Description
execution `object null`
execution.id string 실행 ID
execution.workflowId string 워크플로 ID
execution.mode string 실행 모드
execution.status string 실행 상태
execution.startedAt `string null`
execution.stoppedAt `string null`
execution.retryOf `string null`
execution.retrySuccessId `string null`
execution.waitTill `string null`
data unknown 실행 결과 데이터(includeData가 true인 경우에만 존재)
error string 요청이 실패한 경우의 오류 메시지

참고#

  • 전체 실행 데이터가 필요하지 않은 경우 가벼운 메타데이터 조회(기본값)를 사용하세요.
  • nodeNames로 필터링하고 truncateData로 잘라내면 대규모 결과 세트를 관리하는 데 도움이 됩니다.

search_executions#

Note

n8n v2.20.0부터 사용 가능

선택적 필터를 사용하여 워크플로 실행을 검색합니다. 상태, 타이밍, 워크플로 ID를 포함한 실행 메타데이터를 반환합니다.

매개변수#

Name Type Required Description
workflowId string 아니요 워크플로 ID로 실행 필터링
status string[] 아니요 실행 상태로 필터링. 값: "canceled", "crashed", "error", "new", "running", "success", "unknown", "waiting"
startedAfter string 아니요 ISO 8601 타임스탬프. 이 시간 이후에 시작된 실행만 반환합니다.
startedBefore string 아니요 ISO 8601 타임스탬프. 이 시간 이전에 시작된 실행만 반환합니다.
limit integer 아니요 결과 수 제한(최대 200)
lastId string 아니요 페이지네이션을 위한 커서. 이전 페이지의 마지막 실행 ID를 전달하세요.

출력#

Field Type Description
data array 쿼리와 일치하는 실행 목록
data[].id string 실행의 고유 식별자
data[].workflowId string 이 실행이 속한 워크플로
data[].status string 실행 상태
data[].mode string 실행이 트리거된 방식. 다음 중 하나: "cli", "error", "integrated", "internal", "manual", "retry", "trigger", "webhook", "evaluation", "chat"
data[].startedAt `string null`
data[].stoppedAt `string null`
data[].waitTill `string null`
count integer 일치하는 실행의 총 개수. 개수를 사용할 수 없는 경우 -1
estimated boolean 대규모 데이터 세트에 대한 추정치인지 여부
error string 쿼리가 실패한 경우의 오류 메시지

자격 증명 관리#

list_credentials#

Note

n8n v2.21.0부터 사용 가능

현재 사용자가 접근할 수 있는 자격 증명을 나열합니다. 워크플로 노드에서 참조하기 전에 자격 증명 ID를 찾는 데 사용하세요. 자격 증명 비밀 데이터는 절대 반환하지 않습니다.

매개변수#

Name Type Required Description
limit integer 아니요 결과 수 제한(최대 200)
query string 아니요 이름으로 자격 증명 필터링(부분 일치)
type string 아니요 자격 증명 타입으로 필터링. 예: "slackApi" 또는 "httpHeaderAuth"(부분 일치)
projectId string 아니요 결과를 이 프로젝트에 속한 자격 증명으로 제한
onlySharedWithMe boolean 아니요 현재 사용자와 직접 공유된 자격 증명만 반환합니다. 기본값은 false입니다.

출력#

Field Type Description
data array 현재 사용자가 접근할 수 있는 자격 증명 목록
data[].id string 자격 증명의 고유 식별자
data[].name string 자격 증명 이름
data[].type string 자격 증명 타입. 예: "slackApi"
data[].scopes string[] 이 자격 증명에 대한 사용자 권한. 예: "credential:read"
data[].isManaged boolean 자격 증명이 n8n에 의해 관리되어 사용자가 편집할 수 없는지 여부
data[].isGlobal boolean 자격 증명이 모든 사용자에게 제공되는지 여부
data[].homeProject `object null`
data[].homeProject.id string 프로젝트의 고유 식별자
data[].homeProject.name string 프로젝트 이름
data[].homeProject.type string 프로젝트 타입. "personal"은 사용자의 개인 프로젝트이고, "team"은 여러 사용자가 접근할 수 있는 공유 프로젝트입니다.
count integer 반환된 자격 증명 수
error string 요청이 실패한 경우의 오류 메시지

참고#

  • 최대 결과 제한은 200개입니다.
  • 자격 증명 비밀 데이터는 절대 반환되지 않습니다.
  • 기본적으로 전역 자격 증명이 포함됩니다. 전역 자격 증명을 제외하고 현재 사용자와 직접 공유된 자격 증명만 반환하려면 onlySharedWithMe를 true로 설정하세요.

워크플로 빌더#

get_sdk_reference#

Note

n8n v2.12.0부터 사용 가능

패턴, 표현식 구문, 함수, 규칙, import 구문, 가이드라인, 설계 지침을 포함한 n8n Workflow SDK 참조 문서를 가져옵니다.

매개변수#

Name Type Required Default Description
section string 아니요 "all" 조회할 문서 섹션. 다음 중 하나: "patterns", "patterns_detailed", "expressions", "functions", "rules", "import", "guidelines", "design", "all"

출력#

Field Type Description
reference string 요청한 섹션에 대한 SDK 참조 문서 내용

참고#

  • 워크플로를 만들기 전에 먼저 호출해야 합니다.
  • 전체 참조를 조회하려면 section을 생략하거나 "all"로 설정하세요.
  • 확장된 워크플로 패턴 예제는 "patterns_detailed"를 사용하세요.

search_nodes#

Note

n8n v2.12.0부터 사용 가능

서비스 이름, 트리거 타입, 또는 유틸리티 기능으로 n8n 노드를 검색합니다. get_node_types 도구에 필요한 노드 ID, 판별자(resource/operation/mode), 관련 노드를 반환합니다.

매개변수#

Name Type Required Description
queries string[] 예 (최소 1개) 검색 쿼리 -- 서비스 이름(예: "gmail", "slack"), 트리거 타입(예: "schedule trigger", "webhook"), 또는 유틸리티 노드(예: "set", "if", "merge", "code")

출력#

Field Type Description
results string 일치하는 노드 ID, 판별자, 관련 노드가 포함된 검색 결과

get_node_types#

Note

n8n v2.12.0부터 사용 가능

n8n 노드에 대한 TypeScript 타입 정의를 가져옵니다. 정확한 매개변수 이름과 구조를 반환합니다.

매개변수#

Name Type Required Description
nodeIds array 예 (최소 1개) 노드 타입 요청 객체의 배열. 단일 노드인 경우에도 항상 객체로 전달합니다. 예: { "nodeId": "n8n-nodes-base.gmail" }. 사용 가능한 경우 search_nodes 결과의 판별자를 포함하세요.

Node ID object format:

Field Type Required Description
nodeId string 예 노드 타입 ID(예: "n8n-nodes-base.gmail")
version string 아니요 특정 버전(예: "2.1")
resource string 아니요 리소스 판별자(예: "message")
operation string 아니요 작업 판별자(예: "send")
mode string 아니요 모드 판별자

출력#

Field Type Description
definitions string 요청한 노드에 대한 TypeScript 타입 정의

참고#

  • 올바른 노드 구성에 필수적입니다. MCP 클라이언트는 워크플로 코드를 작성하기 전에 항상 이 도구를 호출해야 합니다.
  • n8n v2.27.0부터 모든 nodeIds 항목은 객체여야 합니다. 일반 문자열 노드 ID는 더 이상 허용되지 않으므로 { "nodeId": "..." }로 감싸야 합니다.
  • 다중 변형 노드에는 resource, operation, mode 판별자를 사용하세요.

get_workflow_best_practices#

Note

n8n v2.26.0부터 사용 가능

워크플로 기법에 대한 모범 사례 지침을 가져옵니다. 노드를 검색하거나 워크플로 코드를 작성하기 전에 유용합니다.

매개변수#

Name Type Required Description
technique string 예 지침을 가져올 워크플로 기법 키. 사용 가능한 모든 기법을 확인하려면 "list"를 전달하세요. 값에는 다음이 포함됩니다: "scheduling", "chatbot", "form_input", "scraping_and_research", "monitoring", "enrichment", "triage", "content_generation", "document_processing", "data_extraction", "data_analysis", "data_transformation", "data_persistence", "notification", "knowledge_base", "human_in_the_loop", "web_app"

출력#

Field Type Description
technique string 요청한 기법 키. 사용 가능한 모든 기법을 나열하는 경우 "list"
message string 응답에 대한 사람이 읽을 수 있는 요약
documentation string 사용 가능한 경우 요청한 기법에 대한 모범 사례 문서
availableTechniques array technique가 "list"인 경우 반환되는 사용 가능한 기법 목록
availableTechniques[].technique string 기법 키
availableTechniques[].description string 기법 설명
availableTechniques[].hasDocumentation boolean 이 기법에 대한 상세한 모범 사례 문서가 있는지 여부

참고#

  • technique: "list"로 호출하면 사용 가능한 모든 기법을 나열합니다
  • 일부 알려진 기법은 아직 상세 문서가 없을 수 있습니다. 이 경우 도구는 documentation 없이 메시지를 반환합니다.
  • 이 도구는 이전의 get_suggested_nodes 워크플로 계획 지침을 대체합니다.

explore_node_resources#

Note

n8n v2.27.0부터 사용 가능

노드의 리소스 로케이터 또는 로드 옵션 드롭다운(예: Slack 채널, Google Sheets 탭, 사용 가능한 AI 모델) 뒤에 있는 실제 값을 확인합니다. 원하는 서비스에 대한 자격 증명이 설정되어 있어야 합니다.

매개변수#

Name Type Required Description
nodeType string 예 search_nodes / get_node_types에서 얻은 완전한 노드 타입 ID. 예: "n8n-nodes-base.slack"
version number 예 노드 버전(예: 4.7). search_nodes가 반환한 버전과 일치해야 합니다.
methodName string 예 타입 정의의 노드 @searchListMethod 또는 @loadOptionsMethod 주석에서 얻은 정확한 메서드 이름. 실제 메서드 이름을 읽으려면 먼저 get_node_types를 호출하세요. 추측하지 마세요.
methodType `"listSearch" "loadOptions"` 예
credentialType string 예 노드에 대한 자격 증명 타입 키. 예: "slackApi" 또는 "googleSheetsOAuth2Api"
credentialId string 예 list_credentials에서 얻은, 사용자가 접근할 수 있는 자격 증명의 ID
filter string 아니요 결과를 좁히기 위한 선택적 검색/필터 텍스트
paginationToken string 아니요 다음 페이지를 가져오기 위한 이전 호출의 페이지네이션 토큰(listSearch만 해당)
currentNodeParameters object 아니요 종속적인 조회를 위한 현재 노드 매개변수. 일부 메서드는 사전 선택이 필요합니다. 예를 들어, 스프레드시트 내 시트 목록을 조회하려면 { documentId: { __rl: true, mode: "id", value: "<spreadsheetId>" } }가 필요합니다. 메서드가 의존하는 매개변수를 확인하려면 타입 정의의 displayOptions를 확인하세요.

출력#

Field Type Description
results array 노드 메서드가 반환한 리소스
results[].name string 리소스의 표시 레이블
results[].value `string number
results[].url string 사용 가능한 경우 리소스 URL
results[].description string 사용 가능한 경우 리소스 설명
paginationToken string 다음 페이지를 가져오려면 paginationToken으로 다시 전달하세요. 더 이상 결과가 없으면 존재하지 않습니다.
builderHint string 존재하는 경우 노드의 @builderHint 주석에서 얻은 선택 지침

참고#

  • list_credentials에서 얻은 credentialId가 필요합니다. 조회는 해당 자격 증명을 사용하여 현재 사용자로 실행됩니다.
  • listSearch 메서드는 filter와 paginationToken을 통한 페이지네이션을 지원하지만, loadOptions 메서드는 지원하지 않습니다.
  • 이 도구는 대부분의 다른 읽기 전용 도구와 달리 외부 서비스에 접근합니다.

validate_workflow#

Note

n8n v2.12.0부터 사용 가능

n8n Workflow SDK 코드를 검증합니다. 코드를 워크플로로 파싱하고 오류를 확인합니다. 워크플로를 생성하거나 업데이트하기 전에 항상 검증하세요.

매개변수#

Name Type Required Description
code string 예 n8n Workflow SDK를 사용하는 전체 TypeScript/JavaScript 워크플로 코드. 워크플로 export를 포함해야 합니다.

출력#

Field Type Description
valid boolean 워크플로 코드가 유효한지 여부
nodeCount number 워크플로의 노드 수. 유효한 경우에만 존재
warnings array 검증 경고(있는 경우)
warnings[].code string 경고 유형을 식별하는 경고 코드
warnings[].message string 경고 메시지
warnings[].nodeName string 해당하는 경우 경고를 유발한 노드
warnings[].parameterPath string 해당하는 경우 경고를 유발한 매개변수 경로
errors string[] 검증 오류. 유효하지 않은 경우에만 존재
hint string 사용 가능한 경우 실행 가능한 복구 힌트

참고#

  • create_workflow_from_code 또는 update_workflow보다 먼저 호출해야 합니다.
  • 코드가 유효한 경우에도 경고가 있을 수 있습니다.
  • valid가 false이고 hint가 존재하는 경우, 다시 시도하기 전에 힌트를 따르세요.

validate_node_config#

Note

n8n v2.25.1부터 사용 가능

하나 이상의 노드 구성을 생성된 노드 스키마에 대해 독립적으로 검증합니다. 워크플로 코드를 조립하거나 update_workflow를 호출하기 전, 노드를 구성하는 동안 유용합니다.

매개변수#

Name Type Required Description
nodes array 예 (최소 1개, 최대 50개) 독립적으로 검증할 하나 이상의 노드 구성
nodes[].name string 아니요 선택적 노드 이름. 응답을 연관시키는 데 도움이 되도록 결과에 반환됨
nodes[].type string 예 전체 노드 타입. 예: "n8n-nodes-base.set" 또는 "@n8n/n8n-nodes-langchain.agent"
nodes[].typeVersion number 아니요 노드 타입 버전. 기본값은 1
nodes[].parameters object 아니요 워크플로 JSON과 동일한 형태를 사용하는 노드 매개변수 객체. 기본값은 {}
nodes[].subnodes unknown 아니요 AI 부모 노드에 대한 선택적 서브노드 구성. 예: LangChain 에이전트 모델, 메모리, 또는 도구 참조
nodes[].isToolNode boolean 아니요 ai_tool 연결을 통해 AI 도구 서브노드로 연결된 노드를 검증할 때 true로 설정

출력#

Field Type Description
valid boolean 모든 노드 구성이 유효한지 여부
results array 입력 순서대로 노드별 검증 결과
results[].index number 입력 배열에서 이 노드의 위치
results[].name string 제공된 경우 입력 노드 이름의 에코
results[].type string 입력 노드 타입의 에코
results[].valid boolean 이 노드 구성이 유효한지 여부
results[].errors array 이 노드에 대한 검증 오류. 노드가 유효한 경우 생략됨
results[].errors[].path string 오류의 매개변수 경로
results[].errors[].message string 사람이 읽을 수 있는 오류 메시지
error string 검증을 실행할 수 없는 경우의 최상위 오류 메시지

참고#

  • 이 도구는 노드 매개변수 스키마만 검증합니다.
  • 연결, 필수 입력, 트리거, 연결이 끊긴 노드, 자격 증명 존재 여부와 같은 워크플로 수준의 문제는 확인하지 않습니다.
  • LangChain 또는 AI 도구 서브노드의 경우, 스키마가 올바른 표시 옵션 분기를 평가하도록 isToolNode를 true로 설정하세요.

create_workflow_from_code#

Note

n8n v2.12.0부터 사용 가능

검증된 SDK 코드로부터 n8n에서 워크플로를 생성합니다. 코드를 워크플로로 파싱하여 저장합니다.

매개변수#

Name Type Required Description
code string 예 n8n Workflow SDK를 사용하는 전체 TypeScript/JavaScript 워크플로 코드. 먼저 validate_workflow로 검증해야 합니다.
skillsUsed string[] 아니요 이 워크플로를 만드는 데 MCP 클라이언트가 사용한 n8n 스킬 이름. 값은 서버 측에서 정규화됩니다.
name string 아니요 선택적 워크플로 이름(최대 128자). 제공하지 않으면 코드의 이름을 사용합니다.
description string 아니요 워크플로 설명. 255자를 초과하는 텍스트는 저장하기 전에 255자로 줄여집니다.
projectId string 아니요 워크플로를 생성할 프로젝트 ID. 기본값은 사용자의 개인 프로젝트입니다. 사용자가 프로젝트 이름을 지정한 경우 먼저 search_projects를 사용하세요.
folderId string 아니요 워크플로를 생성할 폴더 ID. projectId가 설정되어 있어야 합니다. 프로젝트 내에서 이름으로 폴더를 찾으려면 search_folders를 사용하세요.

출력#

Field Type Description
workflowId string 생성된 워크플로의 ID
name string 생성된 워크플로의 이름
nodeCount number 워크플로의 노드 수
url string n8n에서 워크플로를 여는 URL
autoAssignedCredentials array 노드에 자동으로 할당된 자격 증명 목록
autoAssignedCredentials[].nodeName string 자격 증명이 자동으로 할당된 노드의 이름
autoAssignedCredentials[].credentialName string 자동으로 할당된 자격 증명의 이름
autoAssignedCredentials[].credentialType string 자동으로 할당된 자격 증명 타입
targetProject object 워크플로가 생성된 프로젝트
targetProject.id string 프로젝트의 ID
targetProject.name string 프로젝트의 표시 이름
targetProject.type `"personal" "team"`
note string 워크플로 생성에 대한 추가 참고 사항. 예: 자격 증명 자동 할당 중 건너뛴 노드나 255자로 줄여진 설명
hint string 오류 발생 후 사용 가능한 경우 실행 가능한 복구 힌트

참고#

  • 사용 가능한 자격 증명을 노드에 자동으로 할당합니다.
  • HTTP Request 노드는 자격 증명 자동 할당 중 건너뛰며 수동으로 구성해야 합니다.
  • 생성된 워크플로에 availableInMCP 플래그를 true로 설정합니다.
  • 워크플로에 aiBuilderAssisted 메타데이터와 builderVariant: mcp를 표시합니다.
  • 웹훅 노드 ID를 자동으로 확인합니다.
  • folderId를 사용하려면 projectId도 함께 제공해야 합니다.
  • 사용자가 대상 프로젝트 이름을 지정한 경우, 먼저 search_projects를 호출하고 확인된 projectId를 전달하세요. 추측하지 마세요.
  • 생성 후, targetProject 필드를 사용하여 워크플로가 생성된 프로젝트를 사용자에게 알려주세요.
  • n8n v2.27.0부터 255자를 초과하는 description은 거부되지 않고 잘립니다. 이 경우 응답의 note에 명시됩니다.

update_workflow#

Note

n8n v2.12.0부터 사용 가능합니다. v2.20.0부터 이 도구는 업데이트할 때마다 전체 워크플로를 다시 작성하는 대신 부분 업데이트를 수행하도록 전환되었습니다.

대상이 지정된 부분 업데이트의 순서화된 배치를 적용하여 n8n의 기존 워크플로를 업데이트합니다. 배치는 원자적(atomic)입니다. 작업 중 하나라도 실패하면 변경 사항이 저장되지 않습니다.

매개변수#

Name Type Required Description
workflowId string 예 업데이트할 워크플로의 ID
skillsUsed string[] 아니요 이 워크플로 업데이트를 만드는 데 MCP 클라이언트가 사용한 n8n 스킬 이름. 값은 서버 측에서 정규화됩니다.
operations array 예 적용할 작업의 순서화된 목록. 1~100개의 작업을 포함해야 합니다.

지원되는 작업#

Operation Required fields Optional fields Description
updateNodeParameters nodeName, parameters replace 기존 노드의 매개변수에 parameters를 딥 머지합니다. replace가 true인 경우 전체 매개변수 객체를 교체합니다.
setNodeParameter nodeName, path, value RFC 6901 JSON 포인터 경로를 사용하여 매개변수 하나를 설정합니다. 예: /jsonSchema 또는 /options/systemMessage. 필요한 경우 중간 객체를 생성합니다. 배열 인덱스는 지원되지 않으므로 배열 전체를 설정하세요.
addNode node.name, node.type, node.typeVersion node.id, node.parameters, node.position, node.credentials, node.disabled, node.notes 노드를 추가합니다. position은 [x, y]입니다. id를 생략하면 자동 생성됩니다. 노드 이름은 고유해야 합니다.
removeNode nodeName 노드와 모든 인바운드 및 아웃바운드 연결을 제거합니다. 연결된 서브노드는 워크플로에 남지만 연결이 끊깁니다.
renameNode oldName, newName 노드 이름을 변경하고 연결 참조를 다시 작성합니다. 새 이름은 고유해야 합니다.
addConnection source, target sourceIndex, targetIndex, connectionType 연결을 추가합니다. sourceIndex와 targetIndex의 기본값은 0이고, connectionType의 기본값은 main입니다. 동일한 기존 연결은 중복 생성되지 않습니다.
removeConnection source, target sourceIndex, targetIndex, connectionType 일치하는 연결을 제거합니다. sourceIndex와 targetIndex의 기본값은 0이고, connectionType의 기본값은 main입니다.
setNodeCredential nodeName, credentialKey, credentialId, credentialName 노드 자격 증명 참조를 설정하거나 교체합니다. 자격 증명은 접근 가능해야 하며 노드 타입이 허용하는 자격 증명 키와 일치해야 합니다.
setNodePosition nodeName, position 노드의 캔버스 위치를 [x, y]로 업데이트합니다.
setNodeDisabled nodeName, disabled 노드를 활성화하거나 비활성화합니다.
setNodeSettings nodeName, settings 노드 수준의 실행 설정을 업데이트합니다. settings에는 지원되는 설정이 하나 이상 포함되어야 합니다.
setWorkflowMetadata name, description 워크플로 메타데이터를 업데이트합니다. name의 최대 길이는 128자이고, description의 최대 길이는 255자입니다.

setNodeSettings 필드#

Field Type Required Description
onError `"stopWorkflow" "continueRegularOutput" "continueErrorOutput"`
retryOnFail boolean 아니요 노드가 실패했을 때 재시도할지 여부
maxTries integer 아니요 retryOnFail이 true일 때의 시도 횟수. 2~5여야 함
waitBetweenTries integer 아니요 재시도 사이에 대기할 밀리초. 0~5000이어야 함
alwaysOutputData boolean 아니요 노드가 항상 데이터를 출력해야 하는지 여부
executeOnce boolean 아니요 노드가 한 번만 실행되어야 하는지 여부

출력#

Field Type Description
workflowId string 업데이트된 워크플로의 ID
name string 업데이트된 워크플로의 이름
nodeCount number 워크플로의 노드 수
url string n8n에서 워크플로를 여는 URL
appliedOperations number 적용된 작업 수
autoAssignedCredentials array 이번 업데이트에서 추가된 노드에 자동으로 할당된 자격 증명
autoAssignedCredentials[].nodeName string 자격 증명이 자동으로 할당된 노드
autoAssignedCredentials[].credentialName string 자동으로 할당된 자격 증명
autoAssignedCredentials[].credentialType string 자동으로 할당된 자격 증명 타입
validationWarnings array 결과 워크플로에 대한 그래프 및 JSON 검증 경고. 이 경고는 저장을 막지 않습니다
validationWarnings[].code string 경고 코드
validationWarnings[].message string 경고 메시지
validationWarnings[].nodeName string 경고와 연관된 선택적 노드
note string 워크플로 업데이트에 대한 추가 참고 사항. 예: 자격 증명 자동 할당 중 건너뛴 HTTP Request 노드
error string 업데이트가 실패한 경우의 오류 메시지

참고#

  • 작업은 순서대로 적용되고 원자적으로 저장됩니다.
  • 기존 자격 증명은 명시적으로 변경하지 않는 한 유지됩니다.
  • 자격 증명 자동 할당은 현재 호출에서 추가된 노드에만 실행됩니다.
  • HTTP Request 노드는 자격 증명 자동 할당 중 건너뛰며 수동으로 구성해야 합니다.
  • 결과 워크플로는 저장하기 전에 검증됩니다. 검증 경고는 validationWarnings에 반환됩니다.
  • 워크플로에 aiBuilderAssisted 메타데이터와 builderVariant: mcp를 표시합니다.

archive_workflow#

Note

n8n v2.12.0부터 사용 가능

ID로 n8n의 워크플로를 보관(archive)합니다.

매개변수#

Name Type Required Description
workflowId string 예 보관할 워크플로의 ID

출력#

Field Type Description
archived boolean 워크플로가 보관되었는지 여부
workflowId string 보관된 워크플로의 ID
name string 보관된 워크플로의 이름

참고#

  • 멱등적(idempotent)입니다. 이미 보관된 워크플로는 건너뜁니다.

데이터 테이블#

search_data_tables#

Note

n8n v2.16.0부터 사용 가능

현재 사용자가 접근할 수 있는 데이터 테이블을 검색합니다. 데이터를 수정하거나 추가하기 전에 데이터 테이블 ID를 찾는 데 사용하세요.

매개변수#

Name Type Required Description
query string 아니요 이름으로 데이터 테이블 필터링(대소문자를 구분하지 않는 부분 일치)
projectId string 아니요 프로젝트 ID로 필터링
limit integer 아니요 결과 수 제한(최대 100)

출력#

Field Type Description
data array 쿼리와 일치하는 데이터 테이블 목록
data[].id string 데이터 테이블의 고유 식별자
data[].name string 데이터 테이블 이름
data[].projectId string 이 데이터 테이블이 속한 프로젝트
data[].createdAt string 데이터 테이블이 생성된 시점의 ISO 타임스탬프
data[].updatedAt string 데이터 테이블이 마지막으로 업데이트된 시점의 ISO 타임스탬프
data[].columns array 이 데이터 테이블에 정의된 열
data[].columns[].id string 열의 고유 식별자
data[].columns[].name string 열 이름
data[].columns[].type string 열 데이터 타입. 다음 중 하나: "string", "number", "boolean", "date"
data[].columns[].index integer 테이블 내 열의 위치
count integer 일치하는 데이터 테이블의 총 개수

참고#

  • 최대 결과 제한은 100개입니다.

create_data_table#

Note

n8n v2.16.0부터 사용 가능

지정된 열로 새 데이터 테이블을 생성합니다.

매개변수#

Name Type Required Description
projectId string 예 데이터 테이블이 생성될 프로젝트 ID
name string 예 데이터 테이블 이름(최소 1자, 최대 128자, 프로젝트 내에서 고유해야 함)
columns array 예 (최소 1개) 데이터 테이블에 생성할 열
columns[].name string 예 열 이름. 문자로 시작해야 하며, 문자, 숫자, 밑줄만 포함할 수 있습니다(최대 63자).
columns[].type string 예 열의 데이터 타입. 다음 중 하나: "string", "number", "boolean", "date"

출력#

Field Type Description
id string 생성된 데이터 테이블의 고유 식별자
name string 생성된 데이터 테이블의 이름
projectId string 생성된 데이터 테이블의 프로젝트 ID

참고#

  • 열이 하나 이상 필요합니다.
  • 테이블 이름은 프로젝트 내에서 고유해야 합니다.
  • 열 이름은 다음 패턴과 일치해야 합니다: ^[a-zA-Z][a-zA-Z0-9_]*$ (최대 63자).

add_data_table_column#

Note

n8n v2.16.0부터 사용 가능

기존 데이터 테이블에 새 열을 추가합니다.

매개변수#

Name Type Required Description
dataTableId string 예 열을 추가할 데이터 테이블의 ID
projectId string 예 데이터 테이블이 속한 프로젝트 ID
name string 예 열 이름. 문자로 시작해야 하며, 문자, 숫자, 밑줄만 포함할 수 있습니다(최대 63자).
type string 예 새 열의 데이터 타입. 다음 중 하나: "string", "number", "boolean", "date"

출력#

Field Type Description
success boolean 작업 성공 여부
message string 결과 설명
column object 생성된 열
column.id string 열의 고유 식별자
column.name string 열 이름
column.type string 열 데이터 타입

참고#

  • 열 이름은 다음 패턴과 일치해야 합니다: ^[a-zA-Z][a-zA-Z0-9_]*$ (최대 63자).
  • 생성 후 열 타입은 (MCP를 통해서는) 변경할 수 없습니다.

rename_data_table_column#

Note

n8n v2.16.0부터 사용 가능

데이터 테이블의 열 이름을 변경합니다.

매개변수#

Name Type Required Description
dataTableId string 예 열을 포함하는 데이터 테이블의 ID
projectId string 예 데이터 테이블이 속한 프로젝트 ID
columnId string 예 이름을 변경할 열의 ID
name string 예 새 열 이름. 열 이름 규칙을 따라야 합니다.

출력#

Field Type Description
success boolean 작업 성공 여부
message string 결과 설명
column object 이름이 변경된 열
column.id string 열의 고유 식별자
column.name string 새 열 이름
column.type string 열 데이터 타입

참고#

  • 새 이름은 다음 열 이름 규칙을 따라야 합니다: ^[a-zA-Z][a-zA-Z0-9_]*$ (최대 63자).

delete_data_table_column#

Note

n8n v2.16.0부터 사용 가능

데이터 테이블에서 열을 삭제합니다. 이렇게 하면 열과 모든 데이터가 영구적으로 제거됩니다.

매개변수#

Name Type Required Description
dataTableId string 예 열을 포함하는 데이터 테이블의 ID
projectId string 예 데이터 테이블이 속한 프로젝트 ID
columnId string 예 삭제할 열의 ID

출력#

Field Type Description
success boolean 작업 성공 여부
message string 결과 설명

참고#

  • MCP를 통한 열 삭제는 취소할 수 없습니다.

rename_data_table#

Note

n8n v2.16.0부터 사용 가능

기존 데이터 테이블의 이름을 변경합니다.

매개변수#

Name Type Required Description
dataTableId string 예 이름을 변경할 데이터 테이블의 ID
projectId string 예 데이터 테이블이 속한 프로젝트 ID
name string 예 데이터 테이블의 새 이름(최소 1자, 최대 128자)

출력#

Field Type Description
success boolean 작업 성공 여부
message string 결과 설명

참고#

  • 이름은 프로젝트 내에서 고유해야 합니다.

add_data_table_rows#

Note

n8n v2.16.0부터 사용 가능

기존 데이터 테이블에 행을 삽입합니다. 각 행은 열 이름을 값에 매핑하는 객체입니다.

매개변수#

Name Type Required Description
dataTableId string 예 행을 삽입할 데이터 테이블의 ID
projectId string 예 데이터 테이블이 속한 프로젝트 ID
rows array 예 (최소 1개, 최대 1000개) 행 객체의 배열. 각 객체는 열 이름을 값(string, number, boolean, 또는 null)에 매핑합니다.

출력#

Field Type Description
success boolean 삽입 작업 성공 여부
insertedCount integer 성공적으로 삽입된 행 수

참고#

  • 호출당 최대 1000개 행.
  • 행 값은 string, number, boolean, 또는 null이어야 합니다.
  • 행 객체의 열 이름은 데이터 테이블에 있는 기존 열 이름과 일치해야 합니다.