n8n 내장 MCP 서버 설정하기

📖 이론10분

🛠️ 실습20분

🎯 미션5분

"연결이 힘이다."

— 팀 버너스리 (Tim Berners-Lee, 월드와이드웹 발명가)

🎯 오늘의 학습 목표

n8n Settings에서 Instance-level MCP 서버를 활성화할 수 있다.
Claude Desktop에 n8n MCP 서버를 연결하는 설정을 완성할 수 있다.
Claude Desktop에서 n8n 워크플로우 목록을 조회하는 테스트를 완료할 수 있다.

전제 조건 확인

n8n 버전 2.13.0 이상 (워크플로우 빌딩), 2.2.0 이상 (기본 연동)이 필요합니다. 현재 버전을 확인하고, 낮다면 DAY 6의 업데이트 절차를 따라 최신 버전으로 업데이트하세요.

버전 확인

bash

docker compose exec n8n n8n --version

Step 1 — n8n에서 MCP 활성화

text

n8n UI에서:
Settings → Instance-level MCP → Enable MCP access 버튼 클릭
(Owner 또는 Admin 권한 필요)

MCP가 활성화되면 아래 3개 섹션이 나타납니다:
- Connection details
- Access
- Connected clients

Step 2 — MCP 액세스 토큰 생성 (API key 방식)

text

Connection details → Connect 버튼 클릭
→ API key 탭 선택
→ Configuration JSON 복사

⚠️ 이 값은 창을 닫으면 다시 볼 수 없으니 반드시 복사해두세요!

Step 3 — Claude Desktop 설정 (API key 방식)

json

{
  "mcpServers": {
    "n8n": {
      "command": "npx",
      "args": ["-y", "@n8n/mcp-server"],
      "env": {
        "N8N_API_URL": "https://n8n.mycompany.com/api/v1",
        "N8N_API_KEY": "자동생성된_MCP_액세스_토큰"
      }
    }
  }
}

설정 파일 경로

Mac: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json Claude Desktop을 완전히 종료 후 재시작합니다. 채팅창에 🔌 아이콘이 생기면 n8n이 연결된 것입니다!

Step 4 — 워크플로우를 MCP에 노출하기

text

워크플로우 편집기에서:
우측 상단 ... 메뉴 → Settings → Available in MCP 토글 활성화

⚠️ Published 상태이며 Webhook, Form, Schedule, Chat 트리거 중 하나를
포함한 워크플로우만 MCP 노출이 가능합니다.

Step 5 — 연결 테스트

text

Claude Desktop에서 아래 메시지를 입력:
"내 n8n에 워크플로우가 몇 개 있나요? 목록을 보여주세요."

다른 클라이언트 연결 (Cursor / VS Code)

json

// Cursor: .cursor/mcp.json
// VS Code: .vscode/mcp.json
{
  "mcpServers": {
    "n8n": {
      "command": "npx",
      "args": ["-y", "@n8n/mcp-server"],
      "env": {
        "N8N_API_URL": "https://n8n.mycompany.com/api/v1",
        "N8N_API_KEY": "자동생성된_MCP_액세스_토큰"
      }
    }
  }
}

🛠️ DAY 27 실습

Step 1n8n MCP 서버 활성화

n8n 버전 2.13.0 이상인지 확인 (낮으면 업데이트)
Settings → Instance-level MCP → Enable MCP access 클릭
Connection details에서 API key 탭의 Configuration JSON 복사

Step 2Claude Desktop 설정

Claude Desktop 설치: https://claude.ai/download
설정 파일 경로에 claude_desktop_config.json 생성 또는 편집
Configuration JSON 붙여넣기 후 저장
Claude Desktop 완전 종료 후 재시작

Step 3연결 테스트 및 워크플로우 노출

Claude Desktop 채팅창에 🔌 아이콘 확인
'내 n8n 워크플로우 목록 보여줘' 입력해서 응답 확인
워크플로우 1개 선택 → Settings → Available in MCP 활성화
Claude에서 해당 워크플로우 실행 명령 테스트

🚀 DAY 27 미션

Claude Desktop에서 n8n MCP 연결을 완성하고, Claude가 실제로 n8n 워크플로우 목록을 조회하는 화면을 캡처해두세요.

☑️ 미션 체크리스트

n8n MCP 서버 활성화 완료
Claude Desktop 설치 및 설정 파일 작성 완료
Claude Desktop에서 🔌 아이콘 확인
워크플로우 목록 조회 테스트 성공
워크플로우 1개 MCP 노출 설정 완료

💡 힌트: claude_desktop_config.json이 이미 있다면 기존 내용을 지우지 말고 mcpServers 객체 안에 n8n 항목을 추가하세요.

🎯 성공 기준: Claude Desktop에서 n8n 워크플로우 목록이 한국어로 표시되는 상태