n8n MCP 서버 설정 및 사용

요약

n8n의 내장 MCP 서버를 통해 지원되는 MCP 클라이언트를 n8n 워크플로에 연결합니다. 이 서버를 통해 Lovable 또는 Claude Desktop과 같은 클라이언트가 n8n 인스턴스에 안전하게 연결할 수 있습니다.

n8n의 내장 MCP 서버를 통해 지원되는 MCP 클라이언트를 n8n 워크플로에 연결합니다.

이 서버를 통해 Lovable 또는 Claude Desktop과 같은 클라이언트가 n8n 인스턴스에 안전하게 연결할 수 있습니다. 연결된 후 이 클라이언트들은 다음을 수행할 수 있습니다:

워크플로 검색
MCP에서 사용 가능으로 표시된 워크플로와 상호작용
노출된 워크플로 트리거 및 테스트
워크플로 및 데이터 테이블 생성 및 편집

인스턴스 수준 MCP 접근과 MCP Server Trigger node의 차이#

인스턴스 수준 MCP 접근은 n8n 인스턴스당 하나의 연결을 생성하고, 중앙 집중식 인증을 사용하며, 접근을 허용할 워크플로를 선택할 수 있습니다. 허용된 워크플로는 각 워크플로마다 추가 설정 없이 쉽게 찾고 실행할 수 있습니다.

이에 비해 MCP Server Trigger node는 단일 워크플로 내부에 구성합니다. 이 노드는 해당 워크플로의 도구만 노출하며, 하나의 워크플로 내에서 특정 MCP 서버 동작을 구현하고 싶을 때 유용한 방식입니다.

인스턴스 수준 MCP 접근 사용 시 주요 고려사항#

MCP는 두 가지 유형의 워크플로 상호작용을 지원합니다: 워크플로 실행 도구로 기존 워크플로를 실행하거나, 워크플로를 구축 또는 편집합니다(v2.13 이상).
인스턴스의 모든 워크플로에 무조건적으로 접근 권한을 부여하지는 않습니다. 인스턴스 수준에서 MCP를 활성화한 다음 각 워크플로를 개별적으로 활성화해야 합니다. 단 search_workflows 도구는 예외로, 현재 사용자가 접근할 수 있는 모든 워크플로에 접근 가능하지만 전체 워크플로 데이터가 아닌 미리보기만 표시합니다.
각 MCP 클라이언트 범위로 제한되지 않습니다. 연결한 모든 클라이언트(예: Claude Desktop과 ChatGPT)는 MCP 접근을 위해 활성화한 모든 워크플로를 볼 수 있습니다. 특정 워크플로를 특정 클라이언트로 제한할 수는 없습니다. 사용자 수준에서는 가시성이 사용자 범위로 유지됩니다: 사용자는 자신이 접근 권한을 가진 MCP 활성화 워크플로만 볼 수 있습니다.
대부분의 MCP 도구는 게시되지 않은 워크플로에서 작동합니다. 단 execute_workflow는 기본적으로 프로덕션 모드로 실행되며 워크플로의 게시된 버전을 실행합니다. 현재(게시되지 않은) 버전을 실행하기 위한 manual 실행 모드도 지원합니다.

MCP 접근 활성화#

Cloud 및 셀프 호스팅 인스턴스의 경우#

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

활성화되면 다음을 볼 수 있습니다:

MCP 클라이언트에 노출된 워크플로 목록
연결된 OAuth 클라이언트 목록
인스턴스 수준 접근을 활성화/비활성화하는 기본 MCP 토글
MCP 클라이언트 연결에 대한 자세한 지침을 보여주는 연결 세부 정보 버튼

비활성화하려면: 기본 MCP 토글을 끕니다.

환경 변수 (셀프 호스팅 전용)

셀프 호스팅 인스턴스에서는 환경 변수를 사용하여 MCP 설정을 관리할 수도 있습니다. 환경 변수를 사용하여 인스턴스 설정 관리를 참조하세요.

셀프 호스팅: 완전 비활성화#

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

N8N_DISABLED_MODULES=mcp

이 작업을 수행하면 MCP 엔드포인트가 제거되고 관련 UI 요소가 모두 숨겨집니다.

MCP 인증 설정#

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

OAuth2
액세스 토큰

OAuth2 사용#

OAuth 탭에서 인스턴스 서버 URL을 복사하고 이를 사용하여 MCP 클라이언트를 구성합니다. 연결 후 클라이언트가 접근 권한을 인가하기 위해 n8n으로 리디렉션합니다.

클라이언트 접근 취소#

연결된 MCP 클라이언트에 대한 접근을 취소하려면:

설정 > 인스턴스 수준 MCP로 이동합니다.
연결된 클라이언트 탭으로 전환합니다. 연결된 OAuth 클라이언트 테이블이 표시됩니다.
각 클라이언트 행의 작업 메뉴를 사용하여 특정 클라이언트의 접근을 취소합니다.

액세스 토큰 사용#

연결 세부 정보 메뉴의 액세스 토큰 탭에서 인스턴스 서버 URL과 개인 MCP 액세스 토큰을 사용합니다.

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

Note

토큰을 즉시 복사하세요. 이후 방문 시에는 일부 가려진 값만 볼 수 있으며 복사 버튼이 비활성화됩니다.

토큰 교체#

토큰을 분실하거나 교체가 필요한 경우:

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

새 토큰을 생성하면 n8n이 이전 토큰을 취소합니다.
연결된 모든 MCP 클라이언트를 새 값으로 업데이트합니다.

MCP 클라이언트에 워크플로 노출#

MCP 클라이언트는 search_workflows를 사용하여 현재 사용자가 접근할 수 있는 모든 워크플로의 미리보기를 검색할 수 있습니다. 그러나 해당 워크플로에 대해 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. 설명 편집을 선택합니다.

도구 및 리소스#

Tip

채팅 클라이언트 대신 코딩 에이전트(예: Claude Code 또는 Google ADK 에이전트)를 MCP 클라이언트로 사용하는 것을 고려해보세요. 코딩 에이전트는 TypeScript 코드 생성 및 검증에 최적화되어 있어 프로그래밍 방식으로 워크플로를 구축하는 데 이상적입니다.

n8n MCP 서버는 워크플로 관리, 워크플로 구축 및 데이터 테이블을 위한 도구를 노출합니다. 사용 가능한 도구 및 매개변수의 전체 목록은 MCP 서버 도구 참조를 참조하세요.

예시#

n8n MCP 서버에 Lovable 연결#

Lovable에서 MCP 서버 구성(OAuth).
- 워크스페이스 설정 > 연동으로 이동합니다.
- MCP 서버 섹션에서 n8n을 찾아 연결을 클릭합니다.
- n8n 서버 URL을 입력합니다(MCP 접근 페이지에 표시됨).
- 연결을 저장합니다. 성공하면 n8n이 Lovable을 인가하도록 리디렉션합니다.
연결 확인.
- 연결되면 Lovable이 MCP 접근이 활성화된 워크플로를 쿼리할 수 있습니다.
- 예시: Lovable에게 사용자를 나열하고 삭제할 수 있는 워크플로 UI를 구축하도록 요청.

n8n MCP 서버에 Claude Desktop 연결#

OAuth2 사용#

Claude Desktop에서 설정 > 커넥터로 이동합니다.
사용자 정의 커넥터 추가를 클릭합니다.
다음 세부 정보를 입력합니다:
- 이름: n8n MCP
- 원격 MCP 서버 URL: n8n 기본 URL(인스턴스 수준 MCP 페이지에 표시됨)
커넥터를 저장합니다.
메시지가 표시되면 Claude Desktop이 n8n 인스턴스에 접근하도록 인가합니다.

액세스 토큰 사용#

claude_desktop_config.json 파일에 다음 항목을 추가합니다:

"mcpServers": {
  "n8n-mcp": {
    "type": "http",
    "url": "https://<your-n8n-domain>/mcp-server/http",
    "headers": {
      "Authorization": "Bearer "
    }
  }
}

여기서 다음을 교체합니다:

<your-n8n-domain>: n8n 기본 URL(인스턴스 수준 MCP 페이지에 표시됨)

n8n MCP 서버에 Claude Code 연결#

옵션 1: OAuth2를 사용한 인증 (권장)#

다음 CLI 명령을 사용합니다:

claude mcp add --transport http n8n-mcp https://<your-n8n-domain>/mcp-server/http

또는 claude.json 파일에 다음 항목을 추가합니다:

{
    "mcpServers": {
        "n8n-mcp": {
            "type": "http",
            "url": "https://<your-n8n-domain>/mcp-server/http"
        }
    }
}

여기서 다음을 교체합니다:

<your-n8n-domain>: n8n 기본 URL(인스턴스 수준 MCP 페이지에 표시됨)

옵션 2: 액세스 토큰을 사용한 인증#

다음 CLI 명령을 사용합니다:

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

또는 claude.json 파일에 다음 항목을 추가합니다:

{
    "mcpServers": {
        "n8n-mcp": {
            "type": "http",
            "url": "https://<your-n8n-domain>/mcp-server/http",
            "headers": {
                "Authorization": "Bearer "
            }
        }
    }
}

여기서 다음을 교체합니다:

<your-n8n-domain>: n8n 기본 URL(인스턴스 수준 MCP 페이지에 표시됨)
: 생성된 토큰

n8n MCP 서버에 Codex CLI 연결#

옵션 1: OAuth2를 사용한 인증 (권장)#

다음 CLI 명령을 사용합니다:

codex mcp add n8n-mcp --url https://<your-n8n-domain>/mcp-server/http

또는 ~/.codex/config.toml 파일에 다음 항목을 추가합니다:

[mcp_servers.n8n-mcp]
url = "http://localhost:5678/mcp-server/http"

여기서 다음을 교체합니다:

<your-n8n-domain>: n8n 기본 URL(인스턴스 수준 MCP 페이지에 표시됨)

옵션 2: 액세스 토큰을 사용한 인증#

~/.codex/config.toml 파일에 다음 항목을 추가합니다:

[mcp_servers.n8n-mcp]
url = "https://<your-n8n-domain>/mcp-server/http"
http_headers = { "authorization" = "Bearer " }

여기서 다음을 교체합니다:

<your-n8n-domain>: n8n 기본 URL(인스턴스 수준 MCP 페이지에 표시됨)
: 생성된 토큰

n8n MCP 서버에 Google ADK 에이전트 연결#

다음은 원격 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}",
                },
            ),
        )
    ],
)

자세한 내용은 n8n에 ADK 에이전트 연결을 참조하세요.

문제 해결#

MCP 클라이언트를 n8n 인스턴스에 연결하는 데 문제가 발생하는 경우 다음을 고려하세요:

클라우드 기반 MCP 클라이언트를 사용하는 경우 n8n 인스턴스가 공개적으로 접근 가능한지 확인합니다.
n8n 설정에서 MCP 접근이 활성화되어 있는지 확인합니다.
실행 또는 수정하려는 워크플로가 MCP에서 사용 가능으로 표시되어 있는지 확인합니다.
MCP 클라이언트에서 인증 방법(OAuth2 또는 액세스 토큰)이 올바르게 구성되어 있는지 확인합니다.
MCP 연결과 관련된 오류 메시지에 대해 n8n 서버 로그를 검토합니다.

n8n MCP 서버 설정 및 사용

n8n v2.25

원문 보기

번역일: 2026-06-11

요약

n8n의 내장 MCP 서버를 통해 지원되는 MCP 클라이언트를 n8n 워크플로에 연결합니다.

워크플로 검색
MCP에서 사용 가능으로 표시된 워크플로와 상호작용
노출된 워크플로 트리거 및 테스트
워크플로 및 데이터 테이블 생성 및 편집

인스턴스 수준 MCP 접근과 MCP Server Trigger node의 차이#

인스턴스 수준 MCP 접근 사용 시 주요 고려사항#

MCP는 두 가지 유형의 워크플로 상호작용을 지원합니다: 워크플로 실행 도구로 기존 워크플로를 실행하거나, 워크플로를 구축 또는 편집합니다(v2.13 이상).
인스턴스의 모든 워크플로에 무조건적으로 접근 권한을 부여하지는 않습니다. 인스턴스 수준에서 MCP를 활성화한 다음 각 워크플로를 개별적으로 활성화해야 합니다. 단 search_workflows 도구는 예외로, 현재 사용자가 접근할 수 있는 모든 워크플로에 접근 가능하지만 전체 워크플로 데이터가 아닌 미리보기만 표시합니다.
각 MCP 클라이언트 범위로 제한되지 않습니다. 연결한 모든 클라이언트(예: Claude Desktop과 ChatGPT)는 MCP 접근을 위해 활성화한 모든 워크플로를 볼 수 있습니다. 특정 워크플로를 특정 클라이언트로 제한할 수는 없습니다. 사용자 수준에서는 가시성이 사용자 범위로 유지됩니다: 사용자는 자신이 접근 권한을 가진 MCP 활성화 워크플로만 볼 수 있습니다.
대부분의 MCP 도구는 게시되지 않은 워크플로에서 작동합니다. 단 execute_workflow는 기본적으로 프로덕션 모드로 실행되며 워크플로의 게시된 버전을 실행합니다. 현재(게시되지 않은) 버전을 실행하기 위한 manual 실행 모드도 지원합니다.

MCP 접근 활성화#

Cloud 및 셀프 호스팅 인스턴스의 경우#

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

활성화되면 다음을 볼 수 있습니다:

MCP 클라이언트에 노출된 워크플로 목록
연결된 OAuth 클라이언트 목록
인스턴스 수준 접근을 활성화/비활성화하는 기본 MCP 토글
MCP 클라이언트 연결에 대한 자세한 지침을 보여주는 연결 세부 정보 버튼

비활성화하려면: 기본 MCP 토글을 끕니다.

환경 변수 (셀프 호스팅 전용)

셀프 호스팅 인스턴스에서는 환경 변수를 사용하여 MCP 설정을 관리할 수도 있습니다. 환경 변수를 사용하여 인스턴스 설정 관리를 참조하세요.

셀프 호스팅: 완전 비활성화#

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

N8N_DISABLED_MODULES=mcp

이 작업을 수행하면 MCP 엔드포인트가 제거되고 관련 UI 요소가 모두 숨겨집니다.

MCP 인증 설정#

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

OAuth2
액세스 토큰

OAuth2 사용#

클라이언트 접근 취소#

연결된 MCP 클라이언트에 대한 접근을 취소하려면:

설정 > 인스턴스 수준 MCP로 이동합니다.
연결된 클라이언트 탭으로 전환합니다. 연결된 OAuth 클라이언트 테이블이 표시됩니다.
각 클라이언트 행의 작업 메뉴를 사용하여 특정 클라이언트의 접근을 취소합니다.

액세스 토큰 사용#

연결 세부 정보 메뉴의 액세스 토큰 탭에서 인스턴스 서버 URL과 개인 MCP 액세스 토큰을 사용합니다.

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

Note

토큰을 즉시 복사하세요. 이후 방문 시에는 일부 가려진 값만 볼 수 있으며 복사 버튼이 비활성화됩니다.

토큰 교체#

토큰을 분실하거나 교체가 필요한 경우:

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

새 토큰을 생성하면 n8n이 이전 토큰을 취소합니다.
연결된 모든 MCP 클라이언트를 새 값으로 업데이트합니다.

MCP 클라이언트에 워크플로 노출#

접근 활성화#

옵션 1: MCP 설정 페이지에서 (n8n v2.2.0부터 사용 가능)#

워크플로 활성화 버튼을 클릭합니다(워크플로 테이블 헤더 또는 테이블 빈 상태에서).
원하는 워크플로를 검색하고(이름 또는 설명으로) 목록에서 선택합니다.
활성화 버튼을 클릭하여 확인합니다.

옵션 2: 워크플로 편집기에서#

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

옵션 3: 워크플로 목록에서#

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

접근 관리#

워크플로, 홈 프로젝트 또는 상위 폴더를 직접 열기
작업 메뉴를 사용하여 접근 취소(또는 워크플로 카드 메뉴에서 MCP 접근 비활성화 사용)
작업 메뉴를 사용하여 워크플로 설명 업데이트(또는 워크플로 편집기의 메뉴 사용)
워크플로 활성화 버튼을 사용하여 더 많은 워크플로에 대한 접근 활성화(n8n v2.2.0부터 사용 가능)

워크플로 설명#

MCP 클라이언트가 워크플로를 식별할 수 있도록 다음과 같이 자유 텍스트 설명을 추가할 수 있습니다:

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

도구 및 리소스#

Tip

예시#

n8n MCP 서버에 Lovable 연결#

Lovable에서 MCP 서버 구성(OAuth).
- 워크스페이스 설정 > 연동으로 이동합니다.
- MCP 서버 섹션에서 n8n을 찾아 연결을 클릭합니다.
- n8n 서버 URL을 입력합니다(MCP 접근 페이지에 표시됨).
- 연결을 저장합니다. 성공하면 n8n이 Lovable을 인가하도록 리디렉션합니다.
연결 확인.
- 연결되면 Lovable이 MCP 접근이 활성화된 워크플로를 쿼리할 수 있습니다.
- 예시: Lovable에게 사용자를 나열하고 삭제할 수 있는 워크플로 UI를 구축하도록 요청.

n8n MCP 서버에 Claude Desktop 연결#

OAuth2 사용#

Claude Desktop에서 설정 > 커넥터로 이동합니다.
사용자 정의 커넥터 추가를 클릭합니다.
다음 세부 정보를 입력합니다:
- 이름: n8n MCP
- 원격 MCP 서버 URL: n8n 기본 URL(인스턴스 수준 MCP 페이지에 표시됨)
커넥터를 저장합니다.
메시지가 표시되면 Claude Desktop이 n8n 인스턴스에 접근하도록 인가합니다.

액세스 토큰 사용#

claude_desktop_config.json 파일에 다음 항목을 추가합니다:

"mcpServers": {
  "n8n-mcp": {
    "type": "http",
    "url": "https://<your-n8n-domain>/mcp-server/http",
    "headers": {
      "Authorization": "Bearer "
    }
  }
}

여기서 다음을 교체합니다:

<your-n8n-domain>: n8n 기본 URL(인스턴스 수준 MCP 페이지에 표시됨)

n8n MCP 서버에 Claude Code 연결#

옵션 1: OAuth2를 사용한 인증 (권장)#

다음 CLI 명령을 사용합니다:

claude mcp add --transport http n8n-mcp https://<your-n8n-domain>/mcp-server/http

또는 claude.json 파일에 다음 항목을 추가합니다:

{
    "mcpServers": {
        "n8n-mcp": {
            "type": "http",
            "url": "https://<your-n8n-domain>/mcp-server/http"
        }
    }
}

여기서 다음을 교체합니다:

<your-n8n-domain>: n8n 기본 URL(인스턴스 수준 MCP 페이지에 표시됨)

옵션 2: 액세스 토큰을 사용한 인증#

다음 CLI 명령을 사용합니다:

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

또는 claude.json 파일에 다음 항목을 추가합니다:

{
    "mcpServers": {
        "n8n-mcp": {
            "type": "http",
            "url": "https://<your-n8n-domain>/mcp-server/http",
            "headers": {
                "Authorization": "Bearer "
            }
        }
    }
}

여기서 다음을 교체합니다:

<your-n8n-domain>: n8n 기본 URL(인스턴스 수준 MCP 페이지에 표시됨)
: 생성된 토큰

n8n MCP 서버에 Codex CLI 연결#

옵션 1: OAuth2를 사용한 인증 (권장)#

다음 CLI 명령을 사용합니다:

codex mcp add n8n-mcp --url https://<your-n8n-domain>/mcp-server/http

또는 ~/.codex/config.toml 파일에 다음 항목을 추가합니다:

[mcp_servers.n8n-mcp]
url = "http://localhost:5678/mcp-server/http"

여기서 다음을 교체합니다:

<your-n8n-domain>: n8n 기본 URL(인스턴스 수준 MCP 페이지에 표시됨)

옵션 2: 액세스 토큰을 사용한 인증#

~/.codex/config.toml 파일에 다음 항목을 추가합니다:

[mcp_servers.n8n-mcp]
url = "https://<your-n8n-domain>/mcp-server/http"
http_headers = { "authorization" = "Bearer " }

여기서 다음을 교체합니다:

<your-n8n-domain>: n8n 기본 URL(인스턴스 수준 MCP 페이지에 표시됨)
: 생성된 토큰

n8n MCP 서버에 Google ADK 에이전트 연결#

다음은 원격 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}",
                },
            ),
        )
    ],
)

자세한 내용은 n8n에 ADK 에이전트 연결을 참조하세요.

문제 해결#

MCP 클라이언트를 n8n 인스턴스에 연결하는 데 문제가 발생하는 경우 다음을 고려하세요:

클라우드 기반 MCP 클라이언트를 사용하는 경우 n8n 인스턴스가 공개적으로 접근 가능한지 확인합니다.
n8n 설정에서 MCP 접근이 활성화되어 있는지 확인합니다.
실행 또는 수정하려는 워크플로가 MCP에서 사용 가능으로 표시되어 있는지 확인합니다.
MCP 클라이언트에서 인증 방법(OAuth2 또는 액세스 토큰)이 올바르게 구성되어 있는지 확인합니다.
MCP 연결과 관련된 오류 메시지에 대해 n8n 서버 로그를 검토합니다.