n8n MCP 서버에 액세스

n8n에 내장된 MCP 서버를 사용해 지원되는 MCP 클라이언트가 n8n 워크플로에 연결되도록 할 수 있습니다.

이 서버를 사용하면 Lovable 또는 Claude Desktop 같은 클라이언트가 n8n 인스턴스에 안전하게 연결할 수 있습니다. 연결되면 이러한 클라이언트는 다음을 수행할 수 있습니다.

MCP에서 사용 가능하도록 표시된 워크플로 검색
워크플로의 메타데이터 및 트리거 정보 가져오기
공개된 워크플로를 트리거하고 실행

인스턴스 수준 MCP 액세스와 MCP Server Trigger 노드의 차이

인스턴스 수준 MCP 액세스를 사용하면 각 n8n 인스턴스에 대해 하나의 연결을 설정할 수 있고, 중앙화된 인증을 사용하며, 어떤 워크플로에 액세스할 수 있을지 선택할 수 있습니다. 활성화된 워크플로는 각 워크플로마다 별도로 구성하지 않아도 쉽게 검색하고 실행할 수 있습니다.

반면 MCP Server Trigger 노드는 개별 워크플로 내부에서 구성됩니다. 이 노드는 해당 워크플로의 도구만 MCP에 노출하며, 하나의 워크플로 안에서 특정 MCP 서버 동작을 맞춤 설정하려는 경우 유용합니다.

인스턴스 수준 MCP 액세스 사용 시 중요한 참고 사항

이것은 AI 클라이언트를 통해 워크플로를 구축하거나 편집하는 방식이 아닙니다. 워크플로 작성은 여전히 n8n에서 이루어집니다.
인스턴스의 모든 워크플로가 노출되는 것은 아닙니다. 먼저 인스턴스 수준에서 MCP를 활성화한 뒤, 각 워크플로별로 따로 활성화해야 합니다.
범위가 MCP 클라이언트별로 구분되지 않으므로, 연결된 모든 클라이언트는 MCP 액세스용으로 활성화된 모든 워크플로를 볼 수 있습니다.

MCP 액세스 활성화

Cloud 및 자체 호스팅 인스턴스용

설정 > 인스턴스 수준 MCP로 이동합니다.
MCP 액세스 활성화를 켭니다(인스턴스 소유자 또는 관리자 권한 필요).

활성화하면 다음 항목이 표시됩니다.

MCP 클라이언트에 공개된 워크플로 목록
연결된 OAuth 클라이언트 목록
인스턴스 수준 액세스를 활성화/비활성화하는 기본 MCP 스위치
클릭하면 MCP 클라이언트 연결에 대한 자세한 안내를 표시하는 연결 세부정보 버튼

비활성화: 기본 MCP 스위치를 끄면 됩니다.

자체 호스팅 사용자용: 완전히 비활성화

이 기능을 완전히 제거하려면 다음 환경 변수를 설정하세요.

N8N_DISABLED_MODULES=mcp

이렇게 하면 MCP 엔드포인트가 제거되고 관련 UI 요소도 모두 숨겨집니다.

MCP 인증 설정

연결 세부정보 메뉴는 MCP 클라이언트에 두 가지 인증 옵션을 제공합니다.

OAuth2
액세스 토큰(Access Token)

OAuth2 사용

OAuth 탭에서 인스턴스 서버 URL을 복사해 MCP 클라이언트 구성에 사용하세요. 연결 후 클라이언트는 권한 부여를 위해 n8n으로 리디렉션됩니다.

클라이언트 액세스 철회

연결된 MCP 클라이언트의 액세스 권한을 철회하려면 다음 단계를 따르세요.

설정 > 인스턴스 수준 MCP로 이동합니다.
연결된 클라이언트 탭으로 전환하면 연결된 OAuth 클라이언트 테이블이 표시됩니다.
각 클라이언트 행의 작업 메뉴를 사용해 특정 클라이언트의 액세스 권한을 철회합니다.

액세스 토큰 사용

인스턴스 서버 URL과 함께 연결 세부정보 메뉴의 액세스 토큰 탭에서 가져온 개인 MCP 액세스 토큰을 사용하세요.

처음 MCP 액세스 페이지를 열면 n8n이 사용자 계정에 연결된 개인 MCP 액세스 토큰을 자동으로 생성합니다.

주의

토큰은 즉시 복사하세요. 이후 다시 열면 마스킹 처리된 값만 볼 수 있으며, 복사 버튼도 비활성화됩니다.

토큰 갱신

토큰을 분실했거나 갱신이 필요한 경우:

설정 > 인스턴스 수준 MCP로 이동합니다.
오른쪽 상단의 버튼을 클릭해 연결 세부정보 메뉴를 엽니다.
액세스 토큰 탭으로 전환합니다.
마스킹된 토큰 값 옆의 버튼을 사용해 새 토큰을 생성합니다.

새 토큰이 생성되면 n8n은 이전 토큰을 철회합니다.

연결된 모든 MCP 클라이언트에서 새 값으로 업데이트합니다.

워크플로를 MCP 클라이언트에 공개하기

워크플로 자격 요건

워크플로가 MCP 클라이언트가 액세스할 수 있으려면 다음 조건을 충족해야 합니다.

게시됨
다음 트리거 노드 중 하나를 포함함:
- Webhook
- Schedule
- Chat
- Form

기본적으로 어떤 워크플로도 MCP 클라이언트에 표시되지 않습니다. 공개하려는 적격 워크플로마다 액세스를 명시적으로 활성화해야 합니다.

워크플로 자격을 평가할 때 n8n은 게시된 버전만 고려합니다. 초안 버전에 지원되는 트리거가 추가되어 있어도 해당 버전이 게시되기 전까지는 자격을 충족하는 것으로 간주되지 않습니다.

주의

워크플로 게시를 취소하면 n8n이 해당 워크플로의 MCP 액세스 권한을 제거합니다. 워크플로를 다시 게시한 후에는 액세스 권한을 다시 활성화해야 합니다.

액세스 활성화

방법 1: MCP 설정 페이지에서(n8n v2.2.0 이상에서 사용 가능)

워크플로 활성화 버튼을 클릭합니다(워크플로 테이블 헤더 또는 빈 상태에 표시됨).
대상 워크플로를 검색합니다(이름 또는 설명 기준).
목록에서 선택한 뒤 활성화 버튼을 클릭해 확인합니다.

방법 2: 워크플로 편집기에서

워크플로를 엽니다.
오른쪽 상단의 워크플로 기본 메뉴(...)를 클릭합니다.
설정을 선택합니다.
MCP에서 사용 가능을 켭니다.

방법 3: 워크플로 목록에서

워크플로로 이동합니다.
워크플로 카드의 메뉴를 엽니다.
MCP 액세스 활성화를 선택합니다.

액세스 권한 관리

인스턴스 수준 MCP 설정 페이지에는 MCP 클라이언트에서 사용할 수 있는 모든 워크플로가 표시됩니다. 이 목록에서 다음 작업을 할 수 있습니다.

워크플로, 해당 프로젝트 또는 상위 폴더 직접 열기
작업 메뉴를 사용해 액세스 권한 철회(또는 워크플로 카드 메뉴의 MCP 액세스 비활성화 사용)
작업 메뉴를 사용해 워크플로 설명 업데이트(또는 워크플로 편집기 메뉴 사용)
워크플로 활성화 버튼을 사용해 추가 워크플로에 대한 액세스 활성화(n8n v2.2.0 이상에서 사용 가능)

워크플로 설명

MCP 클라이언트가 워크플로를 더 잘 식별할 수 있도록 자유 형식의 설명을 다음과 같이 추가할 수 있습니다.

방법 1: 인스턴스 수준 MCP 페이지에서
1. 설정 > 인스턴스 수준 MCP로 이동합니다.
2. 워크플로 탭에 있는지 확인합니다.
3. 대상 워크플로 행의 작업 메뉴에서 설명 편집을 선택합니다.
4. 또는 설명 텍스트를 직접 클릭해 편집 대화상자를 엽니다.
방법 2: 워크플로 편집기에서
1. 워크플로를 엽니다.
2. 오른쪽 상단의 워크플로 기본 메뉴(...)를 클릭합니다.
3. 설명 편집을 선택합니다.

MCP 클라이언트를 통해 워크플로 실행

MCP 클라이언트는 요청에 따라 적격 워크플로를 실행할 수 있습니다. 클라이언트가 워크플로를 트리거하면 워크플로는 n8n에서 평소처럼 실행되며, 실행 기록 목록에서 해당 실행을 모니터링할 수 있습니다. 실행이 완료되면 MCP 클라이언트가 결과를 가져옵니다.

입력 데이터 제공

MCP 클라이언트는 일반적으로 워크플로에 필요한 입력을 추론할 수 있습니다. Webhook 트리거를 사용 중이고 클라이언트가 올바른 입력을 파악하는 데 어려움을 겪는다면, 워크플로 설명에 해당 정보를 제공하는 것을 권장합니다.

워크플로 시간 초과

n8n은 MCP 클라이언트에 의해 트리거된 워크플로 실행에 대해 실행 시간 제한을 5분으로 강제 적용합니다. 워크플로가 5분 내에 완료되지 않으면 n8n은 실행을 중지하고 MCP 클라이언트에 오류를 전송하며, 워크플로 설정에서 MCP 트리거 실행에 대해 지정한 시간 초과 값은 무시합니다.

제한 사항

워크플로에 여러 개의 지원되는 트리거가 있는 경우, MCP 클라이언트는 그중 하나(첫 번째)만 사용해 워크플로를 트리거할 수 있습니다.
다단계 Form 또는 어떤 형태로든 사용자 상호작용이 필요한 프로세스를 포함한 워크플로 실행은 지원되지 않습니다.
바이너리 입력 데이터는 지원되지 않으며, MCP 클라이언트는 워크플로에 텍스트 기반 입력만 제공할 수 있습니다.

예시

Lovable을 n8n MCP 서버에 연결하기

Lovable에서 MCP 서버를 구성합니다(OAuth).
- 작업 공간의 설정 > 통합으로 이동합니다.
- MCP Servers 섹션에서 n8n을 찾아 Connect를 클릭합니다.
- n8n 서버 URL(MCP 액세스 페이지에 표시됨)을 입력합니다.
- 연결을 저장합니다. 성공하면 Lovable이 권한 부여를 위해 n8n으로 리디렉션됩니다.
연결을 확인합니다.
- 연결 후 Lovable은 MCP 액세스가 활성화된 워크플로를 조회할 수 있습니다.
- 예시: 사용자 목록을 표시하고 사용자를 삭제할 수 있는 워크플로 UI를 만들도록 Lovable에 요청합니다.

Claude Desktop을 n8n MCP 서버에 연결하기

OAuth2 사용

Claude Desktop에서 Settings > Connectors로 이동합니다.
Add custom connector를 클릭합니다.
다음 정보를 입력합니다.
- 이름: n8n MCP
- 원격 MCP 서버 URL: n8n 기본 URL(인스턴스 수준 MCP 페이지에 표시됨)
커넥터를 저장합니다.
메시지가 표시되면 Claude Desktop이 n8n 인스턴스에 액세스할 수 있도록 승인합니다.

액세스 토큰 사용

주의

이 작업에는 최신 버전의 Node.js가 필요합니다.

claude_desktop_config.json 파일에 다음 항목을 추가하세요.

{
  "mcpServers": {
    "n8n-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "supergateway",
        "--streamableHttp",
        "https://<YOUR_N8N_HOST>/mcp-server/http",
        "--header",
        "authorization: Bearer <YOUR_TOKEN>"
      ]
    }
  }
}

다음 값을 바꿔 넣으세요.

<YOUR_N8N_HOST>: n8n 기본 URL(인스턴스 수준 MCP 페이지에 표시됨)
<YOUR_TOKEN>: 생성한 토큰

Claude Code를 n8n MCP 서버에 연결하기

다음 CLI 명령을 사용하세요.

claude mcp add --transport http n8n-mcp https://<YOUR_N8N_HOST>/mcp-server/http \
  --header "Authorization: Bearer <YOUR_TOKEN>"

또는 claude.json 파일에 다음 항목을 추가하세요(위 안내와 동일하게 자리 표시자 값을 바꿔 사용).

Codex CLI를 n8n MCP 서버에 연결하기

~/.codex/config.toml 파일에 다음 항목을 추가하세요.

[mcp_servers.n8n_mcp]
command = "npx"
args = [
    "-y",
    "supergateway",
    "--streamableHttp",
    "https://<YOUR_N8N_HOST>/mcp-server/http",
    "--header",
    "authorization:Bearer <YOUR_TOKEN>"
]

(자리 표시자는 n8n 기본 URL과 생성한 토큰으로 바꿔 사용하세요.)

Google ADK 에이전트를 n8n MCP 서버에 연결하기

다음은 원격 n8n MCP 서버에 연결하는 에이전트를 만드는 예시 코드입니다.

from google.adk.agents import Agent
from google.adk.tools.mcp_tool import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import StreamableHTTPServerParams

N8N_INSTANCE_URL = "https://localhost:5678"
N8N_MCP_TOKEN = "YOUR_N8N_MCP_TOKEN"

root_agent = Agent(
    model="gemini-2.5-pro",
    name="n8n_agent",
    instruction="Help users manage and execute workflows in n8n",
    tools=[
        McpToolset(
            connection_params=StreamableHTTPServerParams(
                url=f"{N8N_INSTANCE_URL}/mcp-server/http",
                headers={"Authorization": f"Bearer {N8N_MCP_TOKEN}"},
            ),
        )
    ],
)

자세한 내용은 Connect ADK agent to n8n을 참조하세요.

문제 해결

MCP 클라이언트를 n8n 인스턴스에 연결하는 중 문제가 발생하면 다음 사항을 확인하세요.

클라우드 기반 MCP 클라이언트를 사용 중이라면 n8n 인스턴스가 외부에서 공개적으로 액세스 가능한지 확인하세요.
n8n 설정에서 MCP 액세스가 활성화되어 있는지 확인하세요.
액세스하려는 워크플로가 MCP에서 사용 가능하도록 표시되어 있는지 확인하세요.
MCP 클라이언트의 인증 방식(OAuth2 또는 액세스 토큰)이 올바르게 구성되었는지 확인하세요.
n8n 서버 로그를 확인해 MCP 연결 관련 오류 메시지가 있는지 살펴보세요.
데스크톱 MCP 클라이언트를 사용 중이라면 최신 버전의 Node.js가 설치되어 있는지 확인하세요.

인스턴스 수준 MCP 액세스와 MCP Server Trigger 노드의 차이​

인스턴스 수준 MCP 액세스 사용 시 중요한 참고 사항​

MCP 액세스 활성화​

Cloud 및 자체 호스팅 인스턴스용​

자체 호스팅 사용자용: 완전히 비활성화​

MCP 인증 설정​

OAuth2 사용​

클라이언트 액세스 철회​

액세스 토큰 사용​

토큰 갱신​

워크플로를 MCP 클라이언트에 공개하기​

워크플로 자격 요건​

액세스 활성화​

방법 1: MCP 설정 페이지에서(n8n v2.2.0 이상에서 사용 가능)​

방법 2: 워크플로 편집기에서​

방법 3: 워크플로 목록에서​

액세스 권한 관리​

워크플로 설명​

MCP 클라이언트를 통해 워크플로 실행​

입력 데이터 제공​

워크플로 시간 초과​

제한 사항​

예시​

Lovable을 n8n MCP 서버에 연결하기​

Claude Desktop을 n8n MCP 서버에 연결하기​

OAuth2 사용​

액세스 토큰 사용​

Claude Code를 n8n MCP 서버에 연결하기​

Codex CLI를 n8n MCP 서버에 연결하기​

Google ADK 에이전트를 n8n MCP 서버에 연결하기​

문제 해결​

인스턴스 수준 MCP 액세스와 MCP Server Trigger 노드의 차이

인스턴스 수준 MCP 액세스 사용 시 중요한 참고 사항

MCP 액세스 활성화

Cloud 및 자체 호스팅 인스턴스용

자체 호스팅 사용자용: 완전히 비활성화

MCP 인증 설정

OAuth2 사용

클라이언트 액세스 철회

액세스 토큰 사용

토큰 갱신

워크플로를 MCP 클라이언트에 공개하기

워크플로 자격 요건

액세스 활성화

방법 1: MCP 설정 페이지에서(n8n v2.2.0 이상에서 사용 가능)

방법 2: 워크플로 편집기에서

방법 3: 워크플로 목록에서

액세스 권한 관리

워크플로 설명

MCP 클라이언트를 통해 워크플로 실행

입력 데이터 제공

워크플로 시간 초과

제한 사항

예시

Lovable을 n8n MCP 서버에 연결하기

Claude Desktop을 n8n MCP 서버에 연결하기

OAuth2 사용

액세스 토큰 사용

Claude Code를 n8n MCP 서버에 연결하기

Codex CLI를 n8n MCP 서버에 연결하기

Google ADK 에이전트를 n8n MCP 서버에 연결하기

문제 해결