Claude가 일상 언어로 내 워크플로우를 목록화, 실행 및 모니터링할 수 있도록 n8n MCP 서버를 구축했습니다

워크플로우를 확인할 때마다 n8n 대시보드를 여는 것에 지쳤습니다.

어떤 과정인지 잘 아실 겁니다: 브라우저 열기 → 실행(executions) 메뉴로 이동 → 적절한 워크플로우 찾기 → 상태 확인 → 닫기. 즉각적이어야 할 작업에 다섯 번의 클릭이 필요합니다.

그래서 저는 **Model Context Protocol (MCP)**를 통해 Claude Desktop이 제 n8n 인스턴스 전체에 접근할 수 있도록 하는 9개 노드의 n8n 워크플로우를 구축했습니다.

이제 저는 그저 이렇게 입력하기만 하면 됩니다:

"어젯밤에 내 백업 자동화가 성공적으로 실행되었나요?"

그러면 Claude가 실제 n8n API를 호출하고 실행 상태를 응답합니다. 브라우저도, 클릭도 필요 없습니다.

MCP란 무엇인가요?

MCP (Model Context Protocol)는 AI 어시스턴트가 외부 도구 및 데이터 소스에 연결할 수 있도록 하는 Anthropic의 개방형 표준입니다. Claude는 단순히 학습 데이터로부터 질문에 답하는 대신, 실제 API를 호출하고 실시간 데이터를 읽으며 작업을 수행할 수 있습니다.

n8n에는 이미 MCP Server Trigger 노드(1.70+ 버전에서 사용 가능)가 있습니다. 저는 이를 사용하여 Claude에게 4가지 도구를 노출했습니다:

도구	기능
list_workflows	ID와 이름을 포함한 모든 활성 워크플로우 반환
...

작동 원리

아키텍처는 간단합니다:

Claude Desktop → mcp-remote → n8n MCP Server Trigger → Code nodes → n8n REST API

4가지 도구 각각은 X-N8N-API-KEY 인증을 사용하여 내부적으로 n8n REST API를 호출하는 Code node입니다.

워크플로우 구성:

1. MCP Server Trigger — Claude가 연결하는 SSE 엔드포인트
2. list_workflows — GET /api/v1/workflows?active=true
3. run_workflow — POST /api/v1/workflows/{id}/run
4. get_executions — GET /api/v1/executions?workflowId={id}&limit=N
5. search_workflows — 워크플로우 이름에 대한 키워드 필터링

자격 증명(Credentials)은 n8n Variables ($vars.N8N_BASE_URL 및 $vars.N8N_API_KEY)에 저장되며, 절대 하드코딩하지 않습니다.

Claude Desktop 설정

{
  "mcpServers": {
    "n8n": {
...

Claude Desktop을 재시작하세요. 이제 Claude가 사용자의 n8n 인스턴스에 접근할 수 있습니다.

지난주의 실제 사례

아침 점검:

"내 모든 활성 워크플로우 (workflows)를 목록화하고, 지난 24시간 동안 실행된 것이 무엇인지 알려줘"

Claude가 워크플로우를 나열하고, 실행 이력 (execution history)을 확인하며, 예정된 일정대로 실행되지 않은 항목을 표시합니다.

빠른 트리거 (Quick trigger):

"고객 인보이스 워크플로우를 실행해줘"

Claude가 키워드로 워크플로우를 찾아 실행을 트리거하고, 실행 ID (execution ID)를 반환합니다.

디버깅 (Debugging):

"이메일 자동화의 최근 실행 5건을 보여줘 — 실패한 게 있어?"

Claude가 실행 데이터를 가져와 에러 메시지를 포함한 결과를 요약해 보여줍니다.

요구 사항

• n8n 1.70+ (클라우드 또는 셀프 호스팅)
• Claude Desktop 또는 Claude Code
• n8n API 키 (Settings → API Keys)
• 로컬 환경의 경우 Public URL 또는 ngrok

설정 시간: 약 15분

템플릿 가져오기

전체 워크플로우 JSON + Claude Desktop 설정 스니펫 (config snippet)은 n8nMarkets에서 확인할 수 있습니다: https://www.n8nmarkets.com/en/workflow-templates

"MCP Server"를 검색하세요.

모든 자격 증명 (credentials)은 사용자의 n8n 인스턴스에 유지됩니다. Claude는 도구 (tools)가 반환하는 정보만 볼 수 있으며, 사용자의 API 키는 서버를 절대 벗어나지 않습니다.