클로드 MCP로 n8n 워크플로우 조종하기 — 설정부터 실전까지

매일 n8n 캔버스를 열고, 노드를 끌어다 놓고, 파라미터를 채우고, 다시 노드를 지우고를 반복하고 있다면 — 그 클릭 흐름을 클로드 MCP가 대신 처리합니다. 슬랙 채널로 매출 요약 보내는 워크플로우를 만들어 달라고 한국어로 말하면 됩니다.

MCP(Model Context Protocol)는 Anthropic이 2024년 말 공개한 오픈 프로토콜로, LLM이 외부 도구·데이터소스와 안전하게 대화하는 방법을 정의합니다. 클로드 MCP 생태계가 2026년 상반기에 폭발적으로 커지면서 n8n 같은 자동화 툴을 대화형으로 조종하는 일이 실무 수준으로 안정화됐습니다.

왜 지금 클로드 MCP × n8n인가

세 가지가 동시에 정렬됐습니다. 첫째, MCP 스펙이 2026년 초 1.0으로 안정화되면서 툴 호출·리소스·프롬프트 세 축이 굳어졌습니다. 둘째, n8n 2.29+가 API-first 설계로 재정비되면서 워크플로우 CRUD·실행 트리거·노드 스키마가 전부 REST로 노출됩니다. 셋째, 커뮤니티가 만든 @czlonkowski/n8n-mcp 서버가 프로덕션급으로 성숙해져 별도 개발 없이 붙일 수 있습니다.

필요한 것

• n8n 2.29+ 인스턴스 (self-hosted 또는 Cloud 모두 가능)
• n8n API key — Settings → API에서 발급, scope는 workflows와 executions 최소
• Claude Desktop 최신판 (또는 Claude Code CLI)
• Node.js 20+ — MCP 서버가 로컬에서 자동 실행됨
• 기타 MCP 클라이언트 (Cursor, Continue 등)도 동일 스펙

30분 셋업

1. n8n에서 Settings → API로 이동, Create API key → scope workflows,executions,credentials:read 선택 후 발급 (키는 한 번만 표시되니 바로 저장)
2. 터미널에서 npx @czlonkowski/n8n-mcp install을 실행 — 로컬에 서버 스크립트가 설치됩니다
3. Claude Desktop 설정 파일 claude_desktop_config.json을 엽니다 (macOS: ~/Library/Application Support/Claude/)
4. 설정 파일에 아래 mcpServers 블록을 추가하고 YOUR_N8N_URL, YOUR_N8N_API_KEY를 실제 값으로 교체
5. Claude Desktop을 완전히 종료 후 재시작 (⌘Q 후 다시 실행 — 새로고침으로는 반영되지 않음)
6. Settings → Developer 탭에서 n8n-mcp 서버가 초록불이면 성공
7. 대화창에 n8n 워크플로우 목록 보여줘라고 입력해 첫 툴 호출 확인
8. 성공하면 아무 워크플로우나 하나 만들어 달라고 자연어로 요청

{
  "mcpServers": {
    "n8n-mcp": {
      "command": "npx",
      "args": ["-y", "@czlonkowski/n8n-mcp"],
      "env": {
        "N8N_URL": "YOUR_N8N_URL",
        "N8N_API_KEY": "YOUR_N8N_API_KEY"
      }
    }
  }
}

첫 대화 — 워크플로우 만들어달라고 부탁하기

설정이 끝났으면 이제 대화입니다. 원하는 결과를 한국어로 자연스럽게 적으면 됩니다. 아래는 실제로 붙여 넣어 본 프롬프트입니다.

슬랙 #alerts 채널로 매일 오전 9시에 어제 매출 요약을 보내는 워크플로우 만들어 줘.

클로드는 세 단계로 움직입니다. 먼저 list_nodes 툴로 사용 가능한 노드를 훑어 Schedule Trigger, Postgres, Slack 조합을 고르고, 다음으로 create_workflow 툴에 JSON을 조립해 던집니다. 마지막으로 저장된 워크플로우 ID와 편집 URL을 대화창에 보고합니다. 이 전 과정이 대략 90초 안에 끝납니다.

'슬랙 채널로 매출 요약 보내는 거 만들어 줘'가 클릭 40번을 대신했습니다. 처음엔 반신반의했는데, 만든 워크플로우가 그대로 굴러갑니다.— 김지훈 · 마케팅팀

실전 활용 패턴

• 새 워크플로우 draft — 요구사항을 문장으로 던지면 초안이 캔버스에 뜹니다. 검토와 파라미터 다듬기만 사람이
• 기존 워크플로우 리팩터링 — 이 워크플로우에서 실패 알림을 슬랙 대신 텔레그램으로 바꿔 줘 같은 요청 처리
• 실행 로그 요약 — 어젯밤 실행 실패 원인을 자연어로 정리. executions 툴로 로그를 긁어 리포트
• 노드 파라미터 벌크 수정 — 여러 워크플로우의 Postgres 호스트 값을 한 번에 새 주소로 갱신
• 에러 조사 — 특정 워크플로우가 왜 계속 실패하는지 물으면 최근 실행 이력과 노드별 에러를 짚어 줌
• 워크플로우 문서화 — 팀에 인수인계할 때 워크플로우 구조를 마크다운으로 뽑아 달라고 요청

자주 묻는 질문

• Q. Cloud 인스턴스에서도 되나요? A. 예. API key만 발급되면 self-hosted든 n8n Cloud든 동일하게 동작합니다. URL이 https://your-org.app.n8n.cloud로 바뀔 뿐입니다.
• Q. MCP 서버는 어디서 실행되나요? A. Claude Desktop이 로컬에서 자동으로 npx로 띄웁니다. 별도 서버 배포 필요 없습니다. 클라우드로 옮기고 싶으면 stdio 대신 sse 트랜스포트를 쓰면 됩니다.
• Q. 권한을 좁게 줄 수 있나요? A. n8n API key scope로 세분화 가능합니다. 예: 읽기 전용으로만 두면 조회·요약은 되고 생성·삭제는 막힙니다. 프로덕션은 이 방식 권장.
• Q. 실수로 프로덕션 워크플로우를 지우면요? A. @czlonkowski/n8n-mcp는 삭제 툴에서 확인 프롬프트를 걸어 두었지만, 절대 반은 자동 백업이 답입니다. 별도 백업 워크플로우 하나 만들어 두세요.
• Q. 한국어로 대화해도 되나요? A. 완벽하게 동작합니다. 클로드는 프롬프트 언어와 상관없이 툴을 호출하고, 결과 요약도 한국어로 돌려줍니다.
• Q. 다른 MCP 클라이언트도 되나요? A. Claude Code CLI, Cursor, Continue 등 MCP 스펙을 따르는 모든 클라이언트에서 동일하게 붙습니다. 설정 파일 위치만 다릅니다.
• Q. Zapier나 Make에도 되나요? A. 지금은 n8n 전용 커뮤니티 서버만 성숙 단계입니다. Zapier·Make용 MCP 서버는 초기 단계로, 실무 투입은 아직 이릅니다.

한계와 주의점

• 사람의 검토는 여전히 필요 — 클로드가 만든 워크플로우도 결국 사람이 활성화 버튼을 눌러야 하고, 프로덕션 데이터를 건드리기 전에 한 번은 캔버스에서 눈으로 확인해야 합니다
• API rate limit — n8n API는 분당 요청 수 제한이 있어, 대량 벌크 작업은 배치로 나눠서 요청
• 프로덕션은 write-only 키 분리 — 편집 세션과 자동 실행 세션을 다른 API key로 분리해서 사고 반경을 좁혀 두세요
• MCP 서버 자체는 문의 응대를 못 함 — 워크플로우가 실행 중 만난 사용자 질문 응답은 별개의 AI Agent 노드 몫입니다. 참고: n8n 2026, AI 에이전트 노드가 워크플로우의 기본이 되다

클로드 MCP × n8n 조합은 워크플로우 자동화의 다음 단계를 그대로 보여줍니다. 노드를 손으로 배치하던 시대에서 결과를 문장으로 요청하는 시대로. n8n이 익숙하지 않다면 웹훅 입문부터 시작하고, 이미 굴리고 있다면 오늘 30분만 투자해 MCP를 붙여 보세요.