본문으로 건너뛰기
MCP 서버 전체 목록

n8n-MCP

  • 추천0
  • GitHub 별23K
  • 생산성원격 연결라이선스MIT

AI 어시스턴트가 n8n 워크플로를 디버깅 · 편집 · 검증 · 테스트해요. 노드 3,501개와 템플릿 2,352개 지식이 들어 있어요

원본:czlonkowski/n8n-mcp

연결 · 설치 방법은 설치 탭에 정리했어요.

설명

n8n-MCP

License: MIT GitHub stars npm version Tests n8n version Docker OpenSSF Best Practices Deploy on Railway

n8n-MCP는 Claude · ChatGPT · Cursor 같은 AI 어시스턴트가 n8n을 직접 다루게 해 주는 오픈소스 MCP 서버예요. 실패한 실행을 읽고, 워크플로를 제자리에서 고치고, 검증하고 테스트하고, 자격 증명을 관리하고, 새 워크플로를 만드는 일까지 맡길 수 있어요. Public API를 켠 n8n 인스턴스라면 어디든 연결할 수 있고, n8n이 기본으로 내장한 MCP 서버를 두 번째 백엔드로 함께 쓸 수도 있어요.

할 수 있는 일

  • 실패한 워크플로 디버깅 - n8n_executions가 실행을 읽고, mode: "error"이면 오류 · 실패한 노드 · 바로 앞 노드의 샘플 항목을 돌려줘요.
  • 워크플로를 제자리에서 편집 - n8n_update_partial_workflow가 요청에 적힌 노드 · 연결에만 정해진 작업을 적용해서, 어시스턴트가 워크플로 전체를 다시 보내지 않아도 돼요. Code 노드처럼 큰 필드 하나 안에서 글을 찾아 바꾸는 것(patchNodeField)도 들어 있어요. 기본값으로 n8n-MCP는 워크플로의 노드나 연결을 바꾸기 전에 스냅샷을 저장하고, n8n_workflow_versions로 비교(diff)와 되돌리기를 할 수 있어요.
  • 배포 전에 검증하고 고치기 - validate_node · validate_workflow · n8n_validate_workflow가 없는 노드, 잘못된 노드 버전, 빠진 필수 필드, 끊긴 연결 · 표현식을 알려 주고, n8n_autofix_workflow가 흔한 오류를 고쳐요.
  • 테스트 - n8n_test_workflow가 워크플로의 웹훅 · 폼 · 채팅 트리거로 실행해요. 그런 트리거가 없는 워크플로는 n8n 내장 MCP 서버를 거쳐 고정(pinned) 데이터로 실행해요.
  • 인스턴스 관리 - 자격 증명을 만들고 · 고치고 · 지우고, 데이터 테이블과 폴더를 다루고, 보안 점검(n8n_audit_instance)을 실행해요.
  • 새 워크플로 만들기 - 노드 3,501개와 템플릿 2,352개 지식이 들어 있어서, 어시스턴트가 추측하지 않고 실제 노드를 설정해요.
  • 여러 n8n 인스턴스를 오가며 작업 - 호스팅 서비스에서는 운영 · 스테이징 · 고객 인스턴스를 한 번만 등록해 두고 호출마다 대상을 지정해요. 직접 호스팅하는 HTTP 모드는 요청별 인스턴스 헤더로 여러 인스턴스를 처리할 수 있어요.

n8n-MCP와 n8n 내장 MCP 서버

n8n은 인스턴스 단위의 자체 MCP 서버를 내장하고 있고, 할 수 있는 일이 많아요. 워크플로 만들기 · 편집, 실행, 버전 기록, 데이터 테이블, Agents까지 다뤄요. n8n-MCP는 이것을 대신하는 것이 아니에요. 둘은 만들어진 방식이 달라요.

n8n 내장 MCP 서버n8n-MCP
실행 위치n8n 인스턴스 하나 안n8n과 통신하는 별도 서버
연결당 인스턴스 수하나여러 개(호스팅 서비스, 또는 멀티테넌트 HTTP 모드)
자격 증명자격 증명을 나열하고 설명만 고침자격 증명을 만들고 · 고치고 · 지움
n8n 버전n8n 1.x 후반부터 있음. 도구 대부분은 n8n 2.12 이상이 필요하고, 도구마다 최소 버전이 따로 있음워크플로 · 실행 도구는 Public API를 통해 옛 버전(1.x 포함)에서도 동작해요. 자격 증명 작업은 그 버전의 API가 열어 둔 범위에 따르고, 새 도구는 필요한 버전을 적어 둠
워크플로 접근대부분의 작업에 워크플로의 「Available in MCP」 설정이 필요하고, 기본값은 꺼짐API 키가 닿는 모든 워크플로

내장 서버만으로 충분한 경우: 최신 n8n 2.x 인스턴스 하나만 쓰고, 그 인스턴스에서 워크플로를 만들고 고치며, 자격 증명은 n8n 화면(UI)에서 직접 설정할 때예요.

n8n-MCP를 더하면 좋은 경우: 인스턴스가 둘 이상이거나, 어시스턴트가 자격 증명을 만들고 고치게 하고 싶거나, 필요한 내장 도구가 나오기 전의 옛 n8n 버전을 쓰거나, 자동 고침 · 실행 오류 분석 · 템플릿 · 보안 점검이 필요할 때예요.

한 연결로 둘 다 쓰기: N8N_MCP_ACCESS_TOKEN을 설정하면, Public API로 할 수 없는 작업을 n8n-MCP가 n8n 자체 서버로 넘겨요. 고정 데이터 테스트 실행, n8n의 네이티브 버전 기록, 실시간 드롭다운 값, n8n Agents, 데이터 테이블 열 변경이 그 대상이에요. 어시스턴트가 보는 MCP 서버는 여전히 하나예요. 공식 MCP 설정을 보세요.

이름에 관한 참고: n8n 문서는 일부 클라이언트 설정에서 자체 내장 서버의 연결 이름 예시로 n8n-mcp를 써요(예: claude mcp add --transport http n8n-mcp https:// /mcp-server/http). 그 이름은 n8n 자체 서버를 가리켜요. 이 프로젝트는 별개의 오픈소스 서버로, github.com/czlonkowski/n8n-mcp에 있고 npm에는 n8n-mcp로 배포돼 있어요.

노드와 템플릿 범위

문서 · 검증 도구는 n8n에 연결하지 않아도 내장 데이터베이스를 바탕으로 동작해요.

  • n8n 노드 3,501개 - 기본 노드 842개 + 커뮤니티 노드 2,659개(검증된 것 2,228개)
  • 노드 속성 - 상세 스키마 99% 커버
  • 노드 작업 - 사용 가능한 작업의 66.5% 커버
  • 문서 - 공식 n8n 문서(AI 노드 포함)에서 86% 커버
  • AI 도구 - AI 사용이 가능한 도구 변형 267개를 찾아 전체 문서와 함께 제공
  • 실제 예시 - 인기 템플릿에서 뽑은 순위가 매겨진 설정 156개
  • 템플릿 라이브러리 - 워크플로 템플릿 2,352개, AI 메타데이터 커버 99.96%
  • 커뮤니티 노드 - source 필터로 검증된 커뮤니티 연동을 검색

프로젝트 후원하기

n8n-mcp는 개인 도구로 시작했지만 지금은 수만 명의 개발자가 워크플로를 효율적으로 자동화하는 데 쓰고 있어요. 이 프로젝트를 유지하고 키우는 일은 제 유료 작업과 시간을 다투게 돼요. 후원해 주시면 새 기능에 집중할 시간을 내고, 이슈에 빠르게 답하고, 문서를 최신으로 유지하고, 최신 n8n 릴리스와의 호환성을 챙기는 데 쓸 수 있어요. 후원자 되기

💼 대신 만들어 드릴까요? n8n-mcp와 n8n-skills의 저자가 운영하는 AiAdvisors — n8n 자동화 진단 · 구축 · 운영과 함께하세요.

실제 워크플로에서 안전하게 쓰기

AI의 결과는 예측하기 어렵고, n8n-MCP는 실제 워크플로를 바꿀 수 있어요. 중요한 운영 워크플로를 바꿀 때는 복사본이나 스테이징 인스턴스에서 먼저 시험하세요.

  • 스냅샷과 되돌리기 - 기본값으로 n8n-MCP는 워크플로의 노드나 연결을 바꾸기 전에 버전을 저장하고, 워크플로마다 10개까지 둬요. n8n_workflow_versions로 그 버전을 나열 · 비교 · 되돌릴 수 있어요. 스냅샷 저장에 실패해도 편집은 막히지 않으니, 중요한 변경에서 되돌리기를 믿기 전에 버전이 있는지 확인하세요.
  • 한 번에 한 명만 편집 - n8n Public API에는 조건부 쓰기가 없어서, n8n-MCP는 워크플로를 읽고 변경을 적용한 뒤 워크플로 전체를 다시 써요. 그 사이에 n8n 화면(UI)에서 한 편집은 덮어써지니, 어시스턴트가 일하는 동안에는 화면에서 그 워크플로를 고치지 마세요.
  • 배포 전에 검증 - 변경에 validate_workflow를 돌리고, n8n에 반영된 뒤에는 n8n_validate_workflow를 돌리세요.
  • 내보내기 보관 - 잃으면 안 되는 워크플로는 내보내 두세요.
  • 어시스턴트가 할 수 있는 일 제한 - 읽기 전용 배포로 쓰기 작업을 끌 수 있어요.

빠른 시작

n8n-MCP를 가장 빨리 써 보는 방법 - 설치도 설정도 필요 없어요.

dashboard.n8n-mcp.com

  • 무료 플랜: 하루 도구 호출 100번
  • 바로 사용: n8n 인스턴스를 연결하고 워크플로 작업을 시작해요
  • 모든 플랜에서 한 연결로 n8n 인스턴스 여러 개를 쓸 수 있어요(멀티 인스턴스 안내)
  • claude.ai · ChatGPT는 OAuth 로그인, IDE와 다른 MCP 클라이언트는 API 키
  • n8n API 키는 암호화해 저장하고 AI 클라이언트에는 돌려주지 않아요
  • 항상 최신: 최신 n8n 노드와 템플릿
  • 인프라 걱정 없음: 운영은 저희가 맡아요

호스팅 서비스는 이 프로젝트의 저자가 운영해요. 가입하고, n8n 인스턴스를 연결하고, MCP 클라이언트를 연결하면 끝이에요.

직접 호스팅하고 싶다면? npx · Docker · Railway · 로컬 설치 방법은 셀프 호스팅 안내를 보세요.

n8n 연동

n8n-MCP를 내 n8n 인스턴스와 쓰고 싶다면 n8n 배포 안내에서 다음을 볼 수 있어요.

  • MCP Client Tool 노드로 로컬에서 시험하기
  • Docker Compose로 운영 환경에 배포하기
  • Hetzner · AWS 등에 클라우드 배포하기
  • 문제 해결과 보안 모범 사례

Cloudflare Access 인증

n8n 인스턴스가 Cloudflare Access(Zero Trust) 뒤에 있다면, n8n-MCP가 인증할 수 있도록 서비스 토큰을 넣어 주세요.

  • N8N_CF_CLIENT_ID - Cloudflare Access Client ID
  • N8N_CF_CLIENT_SECRET - Cloudflare Access Client Secret

설정하면 n8n API 요청, 버전 · 상태 확인, 웹훅 실행에 CF-Access-Client-Id / CF-Access-Client-Secret 헤더로 실려 가요. 토큰은 N8N_API_URL의 출처(origin) 안에서만 쓰여요. 웹훅 호출이 다른 호스트(예: 따로 나뉜 WEBHOOK_URL 출처)로 가면 토큰이 새지 않도록 보내지 않아요.

n8n Agents와 인스턴스 단위 MCP (선택)

n8n_manage_agents, n8n_explore_node_resources, n8n_list_catalog의 프로젝트 대체 경로를 쓰려면 다음을 설정하세요.

  • N8N_MCP_ACCESS_TOKEN - n8n 설정 → Instance-level MCP에서 MCP 상태를 Enabled로 바꾸고 받은 MCP API 키예요. N8N_API_KEY와는 별개의 비밀 값이니 같은 방식으로 보관하세요. MCP 엔드포인트는 N8N_API_URL에서 정해져요. MCP를 따로 나뉜 호스트(N8N_MCP_BASE_URL)에서 제공하는 인스턴스는 지원하지 않아요.

n8n 화면에서 토큰을 받는 방법, 사전 조건, 문제 해결까지 전체 순서는 n8n-mcp를 n8n의 인스턴스 단위 MCP 서버에 연결하기를 보세요.

IDE에 연결하기

n8n-MCP는 여러 AI IDE · 도구와 함께 쓸 수 있어요.

Claude Skills 더하기 (선택)

AI에게 운영 수준의 워크플로 만드는 법을 가르치는 전문 스킬로 n8n 워크플로 제작 실력을 끌어올리세요!

n8n-mcp Skills Setup

더 알아보기: n8n-skills 저장소

Claude 프로젝트 설정

Claude Projects에서 n8n-MCP를 쓸 때 가장 좋은 결과를 얻으려면 아래 강화된 시스템 지침을 쓰세요.

You are an expert in n8n automation software using n8n-MCP tools. Your role is to design, build, and validate n8n workflows with maximum accuracy and efficiency.

## Core Principles

### 1. Silent Execution
CRITICAL: Execute tools without commentary. Only respond AFTER all tools complete.

### 2. Parallel Execution
When operations are independent, execute them in parallel for maximum performance.

### 3. Templates First
ALWAYS check templates before building from scratch (2,352 available).

### 4. Multi-Level Validation
Use validate_node(mode='minimal') → validate_node(mode='full') → validate_workflow pattern.

### 5. Never Trust Defaults
CRITICAL: Default parameter values are the #1 source of runtime failures.
ALWAYS explicitly configure ALL parameters that control node behavior.

## Workflow Process

1. **Start**: Call `tools_documentation()` for best practices

2. **Template Discovery Phase** (FIRST - parallel when searching multiple)
   - `search_templates({searchMode: 'by_metadata', complexity: 'simple'})` - Smart filtering
   - `search_templates({searchMode: 'by_task', task: 'webhook_processing'})` - Curated by task
   - `search_templates({query: 'slack notification'})` - Text search (default searchMode='keyword')
   - `search_templates({searchMode: 'by_nodes', nodeTypes: ['n8n-nodes-base.slack']})` - By node type

   **Filtering strategies**:
   - Beginners: `complexity: "simple"` + `maxSetupMinutes: 30`
   - By role: `targetAudience: "marketers"` | `"developers"` | `"analysts"`
   - By time: `maxSetupMinutes: 15` for quick wins
   - By service: `requiredService: "openai"` for compatibility

3. **Node Discovery** (if no suitable template - parallel execution)
   - Think deeply about requirements. Ask clarifying questions if unclear.
   - `search_nodes({query: 'keyword', includeExamples: true})` - Parallel for multiple nodes
   - `search_nodes({query: 'trigger'})` - Browse triggers
   - `search_nodes({query: 'AI agent langchain'})` - AI-capable nodes

4. **Configuration Phase** (parallel for multiple nodes)
   - `get_node({nodeType, detail: 'standard', includeExamples: true})` - Essential properties (default)
   - `get_node({nodeType, detail: 'minimal'})` - Basic metadata only (~200 tokens)
   - `get_node({nodeType, detail: 'full'})` - Complete information (~3000-8000 tokens)
   - `get_node({nodeType, mode: 'search_properties', propertyQuery: 'auth'})` - Find specific properties
   - `get_node({nodeType, mode: 'docs'})` - Human-readable markdown documentation
   - Show workflow architecture to user for approval before proceeding

5. **Validation Phase** (parallel for multiple nodes)
   - `validate_node({nodeType, config, mode: 'minimal'})` - Quick required fields check
   - `validate_node({nodeType, config, mode: 'full', profile: 'runtime'})` - Full validation with fixes
   - Fix ALL errors before proceeding

6. **Building Phase**
   - If using template: `get_template(templateId, {mode: "full"})`
   - **MANDATORY ATTRIBUTION**: "Based on template by **[author.name]** (@[username]). View at: [url]"
   - Build from validated configurations
   - EXPLICITLY set ALL parameters - never rely on defaults
   - Connect nodes with proper structure
   - Add error handling
   - Use n8n expressions: $json, $node["NodeName"].json
   - Build in artifact (unless deploying to n8n instance)

7. **Workflow Validation** (before deployment)
   - `validate_workflow(workflow)` - Complete validation
   - `validate_workflow_connections(workflow)` - Structure check
   - `validate_workflow_expressions(workflow)` - Expression validation
   - Fix ALL issues before deployment

8. **Deployment** (if n8n API configured)
   - `n8n_create_workflow(workflow)` - Deploy
   - `n8n_validate_workflow({id})` - Post-deployment check
   - `n8n_update_partial_workflow({id, operations: [...]})` - Batch updates
   - `n8n_test_workflow({workflowId})` - Test workflow execution

## Critical Warnings

### Never Trust Defaults
Default values cause runtime failures. Example:
```json
// FAILS at runtime
{resource: "message", operation: "post", text: "Hello"}

// WORKS - all parameters explicit
{resource: "message", operation: "post", select: "channel", channelId: "C123", text: "Hello"}
```

### Example Availability
`includeExamples: true` returns real configurations from workflow templates.
- Coverage varies by node popularity
- When no examples available, use `get_node` + `validate_node({mode: 'minimal'})`

## Validation Strategy

### Level 1 - Quick Check (before building)
`validate_node({nodeType, config, mode: 'minimal'})` - Required fields only (<100ms)

### Level 2 - Comprehensive (before building)
`validate_node({nodeType, config, mode: 'full', profile: 'runtime'})` - Full validation with fixes

### Level 3 - Complete (after building)
`validate_workflow(workflow)` - Connections, expressions, AI tools

### Level 4 - Post-Deployment
1. `n8n_validate_workflow({id})` - Validate deployed workflow
2. `n8n_autofix_workflow({id})` - Auto-fix common errors
3. `n8n_executions({action: 'list'})` - Monitor execution status

## Response Format

### Initial Creation
```
[Silent tool execution in parallel]

Created workflow:
- Webhook trigger → Slack notification
- Configured: POST /webhook → #general channel

Validation: All checks passed
```

### Modifications
```
[Silent tool execution]

Updated workflow:
- Added error handling to HTTP node
- Fixed required Slack parameters

Changes validated successfully.
```

## Batch Operations

Use `n8n_update_partial_workflow` with multiple operations in a single call:

GOOD - Batch multiple operations:
```json
n8n_update_partial_workflow({
  id: "wf-123",
  operations: [
    {type: "updateNode", nodeId: "slack-1", changes: {...}},
    {type: "updateNode", nodeId: "http-1", changes: {...}},
    {type: "cleanStaleConnections"}
  ]
})
```

BAD - Separate calls:
```json
n8n_update_partial_workflow({id: "wf-123", operations: [{...}]})
n8n_update_partial_workflow({id: "wf-123", operations: [{...}]})
```

### CRITICAL: addConnection Syntax

The `addConnection` operation requires **four separate string parameters**. Common mistakes cause misleading errors.

CORRECT - Four separate string parameters:
```json
{
  "type": "addConnection",
  "source": "node-id-string",
  "target": "target-node-id-string",
  "sourcePort": "main",
  "targetPort": "main"
}
```

**Reference**: [GitHub Issue #327](https://github.com/czlonkowski/n8n-mcp/issues/327)

### CRITICAL: IF Node Multi-Output Routing

IF nodes have **two outputs** (TRUE and FALSE). Use the **`branch` parameter** to route to the correct output:

```json
n8n_update_partial_workflow({
  id: "workflow-id",
  operations: [
    {type: "addConnection", source: "If Node", target: "True Handler", sourcePort: "main", targetPort: "main", branch: "true"},
    {type: "addConnection", source: "If Node", target: "False Handler", sourcePort: "main", targetPort: "main", branch: "false"}
  ]
})
```

**Note**: Without the `branch` parameter, both connections may end up on the same output, causing logic errors!

### removeConnection Syntax

Use the same four-parameter format:
```json
{
  "type": "removeConnection",
  "source": "source-node-id",
  "target": "target-node-id",
  "sourcePort": "main",
  "targetPort": "main"
}
```

## Important Rules

### Core Behavior
1. **Silent execution** - No commentary between tools
2. **Parallel by default** - Execute independent operations simultaneously
3. **Templates first** - Always check before building (2,352 available)
4. **Multi-level validation** - Quick check → Full validation → Workflow validation
5. **Never trust defaults** - Explicitly configure ALL parameters

### Attribution & Credits
- **MANDATORY TEMPLATE ATTRIBUTION**: Share author name, username, and n8n.io link
- **Template validation** - Always validate before deployment (may need updates)

### Code Node Usage
- **Avoid when possible** - Prefer standard nodes
- **Only when necessary** - Use code node as last resort
- **AI tool capability** - ANY node can be an AI tool (not just marked ones)

### Most Popular n8n Nodes (for get_node):

1. **n8n-nodes-base.code** - JavaScript/Python scripting
2. **n8n-nodes-base.httpRequest** - HTTP API calls
3. **n8n-nodes-base.webhook** - Event-driven triggers
4. **n8n-nodes-base.set** - Data transformation
5. **n8n-nodes-base.if** - Conditional routing
6. **n8n-nodes-base.manualTrigger** - Manual workflow execution
7. **n8n-nodes-base.respondToWebhook** - Webhook responses
8. **n8n-nodes-base.scheduleTrigger** - Time-based triggers
9. **@n8n/n8n-nodes-langchain.agent** - AI agents
10. **n8n-nodes-base.googleSheets** - Spreadsheet integration
11. **n8n-nodes-base.merge** - Data merging
12. **n8n-nodes-base.switch** - Multi-branch routing
13. **n8n-nodes-base.telegram** - Telegram bot integration
14. **@n8n/n8n-nodes-langchain.lmChatOpenAi** - OpenAI chat models
15. **n8n-nodes-base.splitInBatches** - Batch processing
16. **n8n-nodes-base.openAi** - OpenAI legacy node
17. **n8n-nodes-base.gmail** - Email automation
18. **n8n-nodes-base.function** - Custom functions
19. **n8n-nodes-base.stickyNote** - Workflow documentation
20. **n8n-nodes-base.executeWorkflowTrigger** - Sub-workflow calls

**Note:** LangChain nodes use the `@n8n/n8n-nodes-langchain.` prefix, core nodes use `n8n-nodes-base.`

더 정확한 템플릿 탐색과 함께 최적의 n8n 워크플로 도움을 받으려면 이 지침을 Claude 프로젝트에 저장하세요.

사용할 수 있는 MCP 도구

핵심 도구 (7개)

  • tools_documentation - 모든 MCP 도구의 문서를 가져와요(여기서 시작하세요!)
  • search_nodes - 모든 노드를 대상으로 한 전문 검색이에요. 커뮤니티 노드는 source: 'community'|'verified', 설정 예시는 includeExamples: true를 쓰세요.
  • get_node - 여러 모드를 가진 통합 노드 정보 도구예요.
    • 정보 모드(기본): detail: 'minimal'|'standard'|'full', includeExamples: true
    • 문서 모드: mode: 'docs' - 사람이 읽기 좋은 마크다운 문서
    • 속성 검색: mode: 'search_properties', propertyQuery: 'auth'
    • 버전: mode: 'versions'|'compare'|'breaking'|'migrations'
  • validate_node - 통합 노드 검증 도구예요.
    • mode: 'minimal' - 필수 필드 빠른 확인(100ms 미만)
    • mode: 'full' - 프로필(minimal, runtime, ai-friendly, strict)이 있는 종합 검증
  • validate_workflow - AI Agent 검증을 포함한 워크플로 전체 검증
  • search_templates - 통합 템플릿 검색이에요.
    • searchMode: 'keyword'(기본) - query 파라미터로 글 검색
    • searchMode: 'by_nodes' - 특정 nodeTypes를 쓰는 템플릿 찾기
    • searchMode: 'by_task' - 흔한 task 유형별로 골라 둔 템플릿
    • searchMode: 'by_metadata' - complexity, requiredService, targetAudience로 거르기
  • get_template - 워크플로 JSON 전체 가져오기(모드: nodes_only, structure, full)

n8n 관리 도구 (21개 - API 설정 필요)

이 도구들은 설정에 N8N_API_URL과 N8N_API_KEY가 있어야 해요.

워크플로 관리

  • n8n_create_workflow - 노드와 연결이 있는 새 워크플로 만들기
  • n8n_get_workflow - 통합 워크플로 조회(모드: full, details, structure, minimal)
  • n8n_update_full_workflow - 워크플로 전체 업데이트(통째로 교체)
  • n8n_update_partial_workflow - 차이(diff) 작업으로 워크플로 업데이트
  • n8n_delete_workflow - 워크플로를 영구 삭제
  • n8n_list_workflows - 필터와 쪽 나누기로 워크플로 목록
  • n8n_validate_workflow - n8n에 있는 워크플로를 ID로 검증
  • n8n_autofix_workflow - 흔한 워크플로 오류를 자동으로 고침
  • n8n_workflow_versions - 두 가지 기록에 대한 버전 기록 · 비교 · 되돌리기예요. source: 'local'은 n8n-mcp가 워크플로를 바꾸기 전에 찍는 스냅샷(기본값), source: 'native'는 화면(UI) 편집까지 담긴 n8n 자체의 워크플로 기록이에요(N8N_MCP_ACCESS_TOKEN과 워크플로의 「Available in MCP」 설정이 필요해요).
  • n8n_deploy_template - n8n.io의 템플릿을 자동 고침과 함께 내 인스턴스에 바로 배포

노드 리소스 탐색

  • n8n_explore_node_resources - 노드의 동적 드롭다운(loadOptions)이나 리소스 로케이터 검색(listSearch) 값(Slack 채널, Google Sheets 탭, 모델 목록 등)을 실제 자격 증명으로 가져와요. 그래서 워크플로 설정이 지어낸 ID 대신 기존 ID를 쓰게 돼요. N8N_MCP_ACCESS_TOKEN이 필요해요(공식 MCP 설정 참고).

실행 관리

  • n8n_test_workflow - 워크플로를 실행해요. method: 'auto'(기본)는 웹훅/폼/채팅 트리거를 거쳐 HTTP로 실행하고, method: 'prepare'/'pinned'/'direct'는 그런 트리거가 없는 워크플로를 n8n 자체 MCP 서버로 실행해요(N8N_MCP_ACCESS_TOKEN과 워크플로의 「Available in MCP」 설정이 필요해요).
  • n8n_executions - 통합 실행 관리(목록, 조회, 삭제)
  • n8n_evaluations - 평가(evaluation) 테스트 실행을 돌리고 읽어요(실행 목록, 집계 지표, 케이스별 결과는 n8n 2.30 이상, 실행 시작과 취소는 2.32 이상).

폴더 관리

  • n8n_manage_folders - 워크플로 폴더 관리(만들기, 목록, 조회, 이름 바꾸기, 이동, 삭제. n8n 2.19 이상). 워크플로는 n8n_create_workflow의 parentFolderId나 n8n_update_partial_workflow의 moveToFolder 작업(n8n 2.32 이상)으로 폴더에 넣어요.

데이터 테이블 관리

  • n8n_manage_datatable - n8n 데이터 테이블 · 행 · 열 관리(목록, 조회, 만들기, 수정, 삭제). addColumn/deleteColumn/renameColumn은 n8n 자체 MCP 서버를 거쳐 기존 테이블의 열을 바꾸며 N8N_MCP_ACCESS_TOKEN이 필요해요.

자격 증명 관리

  • n8n_manage_credentials - n8n 자격 증명 관리(목록, 조회, 만들기, 수정, 삭제, getSchema)

보안 · 점검

  • n8n_audit_instance - n8n 내장 점검 API와 워크플로 정밀 스캔을 합친 보안 점검

Agents

  • n8n_manage_agents - n8n Agents(모델 · 지침 · 도구 · 스킬 · 작업 · 메모리 · 채널을 가진, 저장되는 어시스턴트)를 n8n의 인스턴스 단위 MCP 서버로 관리해요. N8N_MCP_ACCESS_TOKEN과, agents 모듈이 있는 n8n 2.34 이상이 필요해요(공식 MCP 설정 참고). 워크플로의 AI Agent 노드와는 다른 것이니, 그 노드는 get_node를 쓰세요.

시스템 도구

  • n8n_health_check - n8n API 연결 상태와 기능을 확인해요. N8N_MCP_ACCESS_TOKEN을 설정했다면 officialMcp 상태도 나와요.
  • n8n_list_catalog - 인스턴스 단위 프로젝트나 태그를 나열해요. Public API가 팀 프로젝트를 열어 주지 않으면 n8n의 인스턴스 단위 MCP 서버로 대신 가져와요.

읽기 전용 배포

거버넌스가 중요한 환경에서는 두 환경 변수를 함께 쓰세요. 쓰기 · 파괴적이거나 민감한 데이터를 다루는 도구는 완전히 꺼요(n8n_manage_credentials와 n8n_manage_datatable은 읽기 작업도 있지만, 읽기만으로도 민감한 자료가 드러나므로 여기서는 통째로 뺍니다).

DISABLED_TOOLS=n8n_create_workflow,n8n_update_full_workflow,n8n_update_partial_workflow,n8n_delete_workflow,n8n_autofix_workflow,n8n_deploy_template,n8n_test_workflow,n8n_manage_credentials,n8n_manage_datatable

읽기와 쓰기 작업이 한 이름에 묶인 도구는 list와 get은 두고 파괴적인 작업만 막으세요. 도구의 읽기 작업이 허용되는 경우에는 DISABLED_TOOLS에 도구 이름을 통째로 넣는 대신 이 방식을 쓰면 돼요. 아래의 n8n_manage_datatable · n8n_test_workflow 항목은 위처럼 두 도구를 통째로 빼는 방식의 대안이에요. 이 예시는 쓰기 작업이 있는 모든 도구의 모든 쓰기 작업을 적었어요.

DISABLED_TOOL_OPERATIONS=n8n_executions:delete;n8n_test_workflow:auto,trigger,pinned,direct,expose;n8n_evaluations:run,cancel;n8n_manage_folders:create,rename,move,delete;n8n_workflow_versions:delete,rollback,prune,expose;n8n_manage_agents:create,mutate,call,publish,unpublish,revert,delete,update_integration;n8n_manage_datatable:createTable,updateTable,deleteTable,insertRows,updateRows,upsertRows,deleteRows,addColumn,deleteColumn,renameColumn

직접 목록을 쓸 때 놓치기 쉬운 점이 둘 있어요. n8n_test_workflow는 auto, trigger, pinned, direct 넷 모두 워크플로를 실행하므로(method를 빼거나 빈 값으로 두면 auto로 쳐요), 읽기 전용인 prepare만 남아요. 그리고 expose는 어떤 작업 파라미터의 값도 아니에요. n8n_test_workflow와 n8n_workflow_versions의 exposeToMcp 동의 쓰기, 즉 워크플로의 「Available in MCP」 설정을 켜는 작업을 가리켜요. expose를 빼 두면 그 쓰기가 열려 있게 돼요.

심층 방어를 위해 읽기 전용 n8n API 키(n8n 인스턴스의 설정 → API)와 함께 쓰세요. 전체 설정 안내는 읽기 전용 배포 레시피를 보세요.

문서

라이선스

MIT 라이선스예요. 자세한 내용은 LICENSE를 보세요.

기여하기

개발 환경 설정, 테스트, 기여 방법은 CONTRIBUTING.md를 보세요.

감사의 말

크레딧과 템플릿 출처는 감사의 말을 보세요.


n8n 커뮤니티를 위해 정성껏 만들었어요.


💼 대신 만들어 드릴까요?

n8n-mcp와 n8n-skills의 저자가 운영하는 AiAdvisors — n8n 자동화 진단 · 구축 · 운영과 함께하세요.