n8n MCP 설치 방법(클로드코드)

 

n8n이란?

n8n은 AI 워크플로우 자동화 오픈 소스 솔루션입니다.

Make, Zapier 등과 같이 업무를 자동화 하는데 최적화된  도구입니다.

심지어 n8n 셀프호스팅을 하게되면 무료로 사용이 가능합니다.

 

하지만 이런 노코드 자동화 도구들을 이용해서 자동화를 구축하는 것이 마냥 쉽지는 않습니다.

이를 해결해 주는것이 n8n MCP입니다.

---

n8n MCP란?

n8n MCP를 사용하면 각종 Code Assistant에서 n8n에 자동화를 쉽게 구축할 수 있습니다.

클로드 데스크탑에서도 채팅만으로 쉽게 구축이 가능합니다.

n8n MCP를 사용하면 n8n에서 제공되는 대부분의 기능을 구현할 수 있습니다.

n8n에서 API Key를 생성한 후 n8n mcp 설정에 추가만 하면 n8n 서버를 management 할 수 있습니다.

---

클로드 코드에서 n8n MCP 사용하기

클로드 코드에 n8n MCP를 설치하는 방법을 알아보겠습니다.

n8n mcp에 대한 자세한 내용은 github에 있는 내용을 참조하였습니다.

https://github.com/czlonkowski/n8n-mcp

GitHub - czlonkowski/n8n-mcp: A MCP for Claude Desktop / Claude Code / Windsurf / Cursor to build n8n workflows for you

 

 

n8n에 대한 내용은 제가 이전에 작성한 글을 참고하시기 바랍니다.

https://codegear.tistory.com/138

n8n: 당신의 워크플로우를 자동화하는 오픈소스 엔진!

n8n 셀프 호스팅 구축 방법도 이전에 작성한 글을 참고하시면 됩니다.

https://codegear.tistory.com/139

월 0원! AWS에 나만의 자동화 서버 구축! (n8n 셀프호스팅, AI 워크플로우 시작)

 

---

n8n MCP 설치하기

• 로그인 계정의 루트에 .claude.json 파일을 에디터에서 Open합니다.
• mcpServers 항목에 아래 내용을 추가합니다.

{
  "mcpServers": {
    "n8n-mcp": {
      "command": "npx",
      "args": ["n8n-mcp"],
      "env": {
        "MCP_MODE": "stdio",
        "LOG_LEVEL": "error",
        "DISABLE_CONSOLE_OUTPUT": "true"
      }
    }
  }
}

• 이렇게 설치하면 기본적인 툴만 사용 가능합니다.
• 만약, n8n 서버에 워크플로우를 작성하고, 수정하는 작업을 하려면 아래와 같이 인증 정보까지 추가해줍니다.

{
  "mcpServers": {
    "n8n-mcp": {
      "command": "npx",
      "args": ["n8n-mcp"],
      "env": {
        "MCP_MODE": "stdio",
        "LOG_LEVEL": "error",
        "DISABLE_CONSOLE_OUTPUT": "true",
        "N8N_API_URL": "https://your-n8n-instance.com",
        "N8N_API_KEY": "your-api-key"
      }
    }
  }
}

• 맥북 환경변수에 등록 하여 사용하실 경우는 .zshrc 파일에 아래 내용을 추가하시면 됩니다.

export N8N_API_URL="https://your-n8n-instance.com"
export N8N_API_KEY="your-api-key"

• 환경변수에 추가한 후에 .claude.json 은 해당 부분을 아래와 같이 수정합니다.

"N8N_API_URL": "$N8N_API_URL",
"N8N_API_KEY": "$N8N_API_KEY"

---

n8n MCP 연결 확인

• 이제 클로드코드를 재실행 합니다.
• "/mcp" 를 입력합니다.
• 아래와 같이 "connected"라고 나오면 정상적으로 설치가 완료된 것입니다.

 

이제 클로드 코드에서 n8n에 있는 워크플로우를 프롬프트로 제어할 수 있습니다.