1-3. n8n MCP 서버 연결 — AI에게 n8n 조종 능력 부여하기

이번 클립에서는 Claude Code와 n8n을 연결합니다. 연결이 끝나면 Claude Code가 n8n 워크플로우를 직접 조회·생성·수정·삭제할 수 있습니다.

1. MCP란 무엇인가?

MCP는 Model Context Protocol의 약자입니다. Claude Code가 외부 서비스와 통신할 수 있도록 연결해주는 다리 역할을 합니다.

역할을 나눠 보면 다음과 같습니다.

지금까지 Claude Code는 내 컴퓨터의 파일을 읽고 쓰는 정도만 가능했습니다. MCP로 n8n을 연결하면 Claude Code가 n8n 서버에 직접 접근하여 워크플로우를 다룰 수 있습니다.

2. n8n MCP 서버 설치

연결 방법은 두 가지입니다.

방법 1: Claude Code에게 맡기기

Claude Code 프롬프트에 다음과 같이 입력합니다.

"n8n MCP 서버를 연결해줘. 내 n8n 서버 주소는 http://localhost:5678이고, API 키는 .env 파일에 있어."

Claude Code가 설정 파일을 자동으로 생성합니다.

방법 2: 직접 설정하기

프로젝트 폴더 안의 .claude/settings.json 파일에 다음 내용을 추가합니다.

{
  "mcpServers": {
    "n8n": {
      "type": "url",
      "url": "https://n8n-mcp.example.com/mcp",
      "headers": {
        "x-n8n-api-key": "YOUR_API_KEY",
        "x-n8n-host-url": "http://localhost:5678"
      }
    }
  }
}

두 값을 내 정보로 교체합니다.

• x-n8n-api-key: 이전 클립에서 발급받은 API 키.
• x-n8n-host-url: 내 n8n 서버 주소. 로컬 Docker라면 http://localhost:5678, n8n Cloud라면 https://my-instance.app.n8n.cloud 형태입니다.

저장 후 Claude Code를 재시작하면 MCP 연결이 적용됩니다.

3. 연결 확인

설정이 끝났으면 Claude Code에 다음과 같이 입력합니다.

"n8n 서버 상태 확인해줘"

Claude Code가 n8n_health_check 도구를 호출합니다. 정상 연결 시 "n8n is running" 같은 응답이 돌아옵니다.

에러가 발생하면 두 가지를 점검합니다.

• API 키가 정확한지 확인합니다. 복사 시 앞뒤 공백이 들어가지 않았는지 확인합니다.
• n8n 서버가 실행 중인지 확인합니다. Docker Desktop에서 n8n 컨테이너 상태가 "Running"이어야 합니다.

4. 연결 전후 비교

MCP 연결 전후로 Claude Code가 할 수 있는 일이 크게 달라집니다.

MCP 연결 한 번으로 21개의 n8n 제어 도구가 Claude Code에 추가됩니다. 모든 도구를 외울 필요는 없습니다. 자연어로 지시하면 Claude Code가 알맞은 도구를 선택합니다.

5. 마무리

이번 클립에서 완료한 작업은 두 가지입니다.

• MCP 설정으로 Claude Code와 n8n 서버 연결
• health_check로 연결 정상 여부 확인

다음 클립에서는 첫 자연어 명령을 직접 내려봅니다. 코드 한 줄 없이 "내 워크플로우 목록 보여줘"라고 말하면 실제 목록이 출력되는 과정을 확인합니다.