n8n-MCP
- 추천0
- GitHub 별23K
- 생산성원격 연결라이선스MIT
AI 어시스턴트가 n8n 워크플로를 디버깅 · 편집 · 검증 · 테스트해요. 노드 3,501개와 템플릿 2,352개 지식이 들어 있어요
연결 · 설치 방법은 설치 탭에 정리했어요.
설명
n8n-MCP
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를 가장 빨리 써 보는 방법 - 설치도 설정도 필요 없어요.
- 무료 플랜: 하루 도구 호출 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 IDN8N_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 Code - Claude Code CLI 빠른 설정
- Visual Studio Code - GitHub Copilot과 함께 쓰는 VS Code
- Cursor - Cursor IDE 단계별 설정
- Windsurf - 프로젝트 규칙과 함께 쓰는 Windsurf 연동
- Codex - Codex 연동 안내
- Kiro - Kiro IDE · CLI 설정
- Antigravity - Antigravity 연동 안내
Claude Skills 더하기 (선택)
AI에게 운영 수준의 워크플로 만드는 법을 가르치는 전문 스킬로 n8n 워크플로 제작 실력을 끌어올리세요!
더 알아보기: 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)와 함께 쓰세요. 전체 설정 안내는 읽기 전용 배포 레시피를 보세요.
문서
- 셀프 호스팅 안내 - npx · Docker · Railway · 로컬 설치
- 보안과 강화 - 신뢰 모델, 강화 옵션, 워크플로 제한
- n8n 배포 안내 - n8n과 함께 쓰는 운영 배포
- 데이터베이스 설정 - SQLite 어댑터와 메모리 최적화
- 개인정보와 텔레메트리 - 수집하는 것과 끄는 방법
- 워크플로 diff 작업 - 토큰을 아끼는 워크플로 업데이트
- HTTP 배포 - 원격 서버 설정
- 공식 MCP 설정 - n8n-mcp를 n8n의 인스턴스 단위 MCP 서버에 연결해 Agents와 노드 리소스 탐색 쓰기
- 변경 기록 - 전체 버전 기록
라이선스
MIT 라이선스예요. 자세한 내용은 LICENSE를 보세요.
기여하기
개발 환경 설정, 테스트, 기여 방법은 CONTRIBUTING.md를 보세요.
감사의 말
크레딧과 템플릿 출처는 감사의 말을 보세요.
n8n 커뮤니티를 위해 정성껏 만들었어요.
💼 대신 만들어 드릴까요?
n8n-mcp와 n8n-skills의 저자가 운영하는 AiAdvisors — n8n 자동화 진단 · 구축 · 운영과 함께하세요.
