n8n MCP를 Claude에 연결하는 완벽 가이드 (1)

n8n MCP를 Claude에 연결하는 완벽 가이드 (1)

n8n에서 실행하는 MCP(Model Context Protocol) 서버를 Claude와 연결하여 자동화 워크플로우를 AI와 직접 연동하는 방법을 단계별로 안내합니다. 로컬 방식과 웹 통합 방식 두 가지 방법을 모두 다루며, 인증 설정까지 포함한 완전한 가이드입니다.

1. 사전 준비사항

1.1 필수 요구사항

n8n 환경
  • n8n 설치 및 실행 중인 환경
  • MCP 서버 기능 활성화
  • 네트워크 접근 가능한 상태
Claude 환경
  • Claude Desktop 앱 (로컬 방식용) 또는
  • Claude Web 계정 (웹 방식용)

1.2 사전 지식

권장 사전 지식:
  • 기본적인 n8n 워크플로우 작성 경험
  • JSON 설정 파일 편집
  • 네트워크 및 포트 개념

2. 방법 1: 로컬 방식 (Claude Desktop + mcp-remote)

이 방법은 인증이 필요한 환경이나 내부 네트워크에서 안전하게 연결할 때 사용합니다.

2.1 Claude Desktop 설치

  1. Claude Desktop 다운로드
      • 운영체제에 맞는 버전 다운로드 및 설치
      notion image
  1. 설치 완료 확인
      • Claude Desktop 실행
      • 정상 로그인 및 동작 확인
      notion image
  1. MCP 서버 주소 확인
    1. notion image
      • Production URL 탭을 누르면, 자동으로 url 이 생성되어 있는 것을 확인 할수 있음
        • 예시: https://localhost:5678/mcp/ae212cb0-560a-4fc4-8927-a5eefca9a63c
      • n8n이 로컬서버라면 이 과정은 생략해도 되지만, 만약 공식 SaaS 를 사용하거나 클라우드 셀프 호스팅 n8n이라면 반드시 API 설정하기를 바람. (탈취시 보안사고 발생 가능)
      • Authentication은 Bearer Auth로 설정하고, New Credential 버튼을 눌러서 새로운 인증키를 등록.
      notion image
      • 나만 알수 있는 API Key를 만들어 입력.
      • 같은 API 랜덤 생성 사이트를 이용하면 간편함. (따로 기록해둘것)
        * 예시 : bkdmV+L0yddTdGrrptm5AiTrcqE6+rQkbPtxCkADmY8=
      • [Save] 버튼을 눌러 저장하고 닫기 버튼으로 빠져나올것.
      notion image
      • 워크플로 활성화
      notion image

3.3 Claude Desktop 설정 파일 편집

  1. 설정 파일 위치 찾기
    1. notion image
      notion image
      notion image
  • Mac 사용자:
    • ~/Library/ApplicatVion Support/Claude/claude_desktop_config.json
  • Windows 사용자:
    • %APPDATA%/Claude/claude_desktop_config.json
      notion image
      notion image
  1. 설정 파일 편집
  • 기본 연결 설정 (인증 없음):
    • { "mcpServers": { "MCP_SIMPLE_TEST": { "command": "npx", "args": [ "mcp-remote", "http://localhost:5678/mcp/ae212cb0-650b-4fc4-8927-a5eefca9a63c" ] } } }

3.5 인증 설정 (Bearer Token)

  • 인증이 필요한 n8n 환경의 경우:
    • { "mcpServers": { "n8n-mcp-auth": { "command": "npx", "args": [ "mcp-remote", "http://localhost:5678/mcp/ae212cb0-650b-4fc4-8927-a5eefca9a63c", "--header", "Authorization:${N8N_AUTH_TOKEN}" ], "env": { "N8N_AUTH_TOKEN": "Bearer your-n8n-api-token-here" } } } }
📸 [이미지 위치: 인증 토큰이 포함된 설정 파일]

3.6 Claude Desktop 재시작

  1. 완전 종료
      • Claude Desktop 완전히 종료
      • 시스템 트레이에서도 제거 확인
  1. 재시작 및 연결 확인
      • Claude Desktop 다시 실행
      • 새로운 대화에서 [설정 아이콘] 버튼 클릭
      • 드롭다운 목록에 위에서 등록한 MCP 도구 사용 가능 여부 확인
      notion image

4. 방법 2: 웹 방식 (Claude Web 통합 기능)

이 방법은 공개 접근 가능한 n8n 서버에서 간편하게 연결할 때 사용합니다.

4.1 Claude Web에서 MCP 연결

  1. Claude Web 접속
    1. notion image
  1. 통합 기능 설정
      • 채팅 메세지 입력 하단 설정 아이콘 클릭
      • '통합 추가하기' 메뉴 선택
      notion image
  1. MCP 서버 추가
      • '연동 이름' 과 '연동 URL' 입력
      • 연동 이름 (예시) : MCP_SIMPLE_REMOTE_TEST
      • 연동 URL 입력 (여러분의 n8n MCP 주소로 입력하세요): https://n8n.dantelabs.com/mcp/ae212cb0-650b-4fc4-8927-a5eefca9a63c
      notion image
      • [연결] 버튼 클릭
      notion image
  1. 연결 완료 확인
      • [연결] 버튼이 사라지면 연결이 활성화 된 것임.
      • 점세개 설정 버튼을 누르면 팝업 메뉴가 나옴.
      • [도구 및 설정] 버튼 클릭
      notion image
      notion image
      • MCP의 도구마다 매전 승인 절차를 거치지 않으려면 [감독 없이 허용] 을 선택하고 [완료] 버튼 클릭
      notion image
      • 지금부터 새로운 대화에서 n8n 도구 사용 가능
      notion image
      notion image
      notion image
      notion image
 

4.3 웹 방식(Beta)의 제한사항

⚠️ 주의사항:
  • n8n 인증 미지원: Bearer Token 등 커스텀 헤더 인증 불가
  • 자체 Oauth2 인증 지원 공개 서버만 인증기능 지원