3-1. n8n MCP 도구 카탈로그 — 21개 도구 한눈에 보기
이번 섹션에서 만들 워크플로우는 "매일 아침 AI 브리핑" 입니다. 매일 오전 9시에 서울 날씨, 주요 뉴스 5건, 달러 환율을 AI가 요약해 슬랙에 보내는 자동화입니다.
본격적으로 모듈을 작성하기 전에, 모듈이 사용할 n8n MCP 도구 21개를 먼저 파악합니다.
★ 핵심. 도구는 리모컨의 버튼이고, 스킬 모듈은 그 버튼을 언제 어떤 순서로 누를지 정한 사용 설명서입니다. 버튼 목록부터 익혀야 사용 설명서를 쓸 수 있습니다.
1. 왜 도구를 먼저 알아야 하는가
스킬 모듈은 "이런 요청이 오면 이 도구를 이 순서로 사용하라"는 절차서입니다. 어떤 도구가 있는지 모르면 절차서를 작성할 수 없습니다.
n8n MCP 서버는 총 21개의 도구를 제공합니다. 5개 그룹으로 나뉘어 있어, 그룹별로 "이런 종류의 일을 하는 도구들이 있다"는 정도만 파악하면 충분합니다.
2. 그룹 1 — 워크플로우 생명주기 (8개)
워크플로우를 만들고, 조회하고, 수정하고, 삭제하는 모든 과정을 담당합니다.
n8n_health_check
n8n 서버가 살아있는지 확인합니다. 모든 작업의 시작점입니다.
n8n_create_workflow
새 워크플로우를 만듭니다. 아침 브리핑 워크플로우도 이 도구로 생성합니다.
n8n_get_workflow
특정 워크플로우의 상세 정보를 가져옵니다.
n8n_list_workflows
전체 워크플로우 목록을 조회합니다.
n8n_update_full_workflow
워크플로우 전체를 새 내용으로 교체합니다.
n8n_update_partial_workflow
워크플로우의 일부분만 수정합니다.
n8n_delete_workflow
워크플로우를 삭제합니다.
n8n_workflow_versions
워크플로우의 변경 이력을 확인합니다.
이 8개 도구만 있으면 워크플로우의 전체 생애를 관리할 수 있습니다.
3. 그룹 2 — 검증 및 테스트 (5개)
워크플로우를 만들기 전에 점검하고, 만든 후에 실행해보고, 문제가 있으면 고치는 역할을 합니다.
validate_workflow
워크플로우 JSON 구조가 올바른지 사전 검증합니다. 아침 브리핑처럼 노드가 6개라면 연결 실수가 나기 쉬워, 이 도구가 특히 중요합니다.
n8n_validate_workflow
n8n 서버에서 직접 워크플로우를 검증합니다.
validate_node
개별 노드의 설정이 맞는지 확인합니다.
n8n_autofix_workflow
검증에서 에러가 나면 자동으로 수정을 시도합니다.
n8n_test_workflow
워크플로우를 실제로 한 번 실행해 결과를 확인합니다.
이 도구들이 안전장치 역할을 합니다. 검증 없이 워크플로우를 바로 만들면 에러가 날 확률이 높습니다.
4. 그룹 3 — 실행 및 데이터 (2개)
- n8n_executions: 워크플로우 실행 이력을 조회합니다. "아침 브리핑이 오늘 정상 실행됐는가" 같은 질문에 답할 수 있습니다.
- n8n_manage_datatable: n8n 내부 데이터 테이블을 관리합니다.
개수는 적지만 운영 단계에서 매우 중요합니다. 다음 섹션 "운영 관리 모듈"에서 본격적으로 다룹니다.
5. 그룹 4 — 노드 및 템플릿 (5개)
search_nodes
키워드로 노드를 검색합니다. 아침 브리핑을 만들 때 Schedule Trigger, HTTP Request, AI, Slack 등을 이 도구로 찾습니다.
get_node
특정 노드의 상세 스펙을 가져옵니다. 어떤 설정값이 필요한지 알 수 있습니다.
search_templates
n8n 템플릿 라이브러리에서 기존 워크플로우 템플릿을 검색합니다.
get_template
특정 템플릿의 상세 내용을 가져옵니다.
deploy_template
템플릿을 그대로 n8n 서버에 배포합니다.
이 중 search_nodes와 get_node는 이번 섹션에서 가장 많이 사용합니다.
6. 그룹 5 — 참조 (1개)
- tools_documentation: 21개 도구 각각의 상세 사용법 문서를 조회합니다.
도구를 쓰다가 파라미터가 헷갈리거나 사용법이 불확실할 때 문서를 확인할 수 있습니다. 사전 같은 역할입니다.
7. 아침 브리핑 워크플로우에 필요한 핵심 도구
21개 중 "매일 아침 AI 브리핑" 워크플로우를 만들 때 꼭 필요한 도구만 추리면 다음과 같습니다.
search_nodes — Schedule Trigger, HTTP Request, AI 노드, Slack 노드를 검색
get_node — 각 노드의 상세 설정 정보를 확인
validate_workflow — 6개 노드가 올바르게 연결됐는지 사전 검증
n8n_create_workflow — 검증을 통과한 워크플로우를 실제 생성
n8n_test_workflow — 생성된 워크플로우를 테스트 실행
흐름을 요약하면 검색 → 확인 → 검증 → 생성 → 테스트 입니다. 이 순서가 다음 클립에서 만들 워크플로우 생성 모듈의 뼈대가 됩니다.
8. 마무리
n8n MCP 서버는 21개 도구를 5개 그룹으로 제공합니다.
| 그룹 | 도구 수 | 역할 |
|---|---|---|
| 워크플로우 생명주기 | 8 | 생성·조회·수정·삭제 |
| 검증 및 테스트 | 5 | 사전 검증·자동 수정·실행 테스트 |
| 실행 및 데이터 | 2 | 실행 이력·내부 데이터 관리 |
| 노드 및 템플릿 | 5 | 노드 검색·템플릿 배포 |
| 참조 | 1 | 도구 사용법 문서 |
전부 외울 필요 없습니다. 실제로 쓸 때는 Claude Code가 스킬을 보고 적절한 도구를 골라줍니다.
다음 클립에서는 이 도구들을 활용하는 워크플로우 생성 모듈을 직접 작성합니다.