MCP Server Trigger 노드를 사용하면 n8n이 Model Context Protocol(MCP) 서버 역할을 하여 n8n 도구와 워크플로를 MCP 클라이언트에 제공할 수 있습니다.

MCP Server Trigger 노드의 작동 방식#

MCP Server Trigger 노드는 MCP 클라이언트가 n8n에 접근하는 진입점 역할을 합니다. 이 노드는 MCP 클라이언트가 상호작용하여 n8n 도구에 접근할 수 있는 URL을 노출하는 방식으로 작동합니다.

이벤트에 응답하고 그 출력을 다음 연결된 노드로 전달하는 일반적인 트리거 노드¹와 달리, MCP Server Trigger 노드는 오직 도구 노드에만 연결되고 이를 실행합니다. 클라이언트는 사용 가능한 도구 목록을 조회하고 개별 도구를 호출하여 작업을 수행할 수 있습니다.

Custom n8n Workflow Tool 노드에 워크플로를 연결하면 n8n 워크플로를 클라이언트에 노출할 수 있습니다.

노드 파라미터#

이 파라미터를 사용하여 노드를 구성합니다.

MCP URL#

MCP Server Trigger 노드에는 테스트용과 프로덕션용 두 가지 MCP URL이 있습니다. n8n은 노드 패널 상단에 URL을 표시합니다.

Test URL 또는 Production URL을 선택하여 n8n이 표시하는 URL을 전환할 수 있습니다.

• Test: 워크플로가 활성화되어 있지 않은 상태에서 Listen for Test Event 또는 Execute workflow를 선택하면 n8n이 테스트 MCP URL을 등록합니다. 이 MCP URL을 호출하면 n8n이 워크플로에 데이터를 표시합니다.
• Production: 워크플로를 게시하면 n8n이 프로덕션 MCP URL을 등록합니다. 프로덕션 URL을 사용할 때는 n8n이 워크플로에 데이터를 표시하지 않습니다. 다만 프로덕션 실행에 대한 워크플로 데이터는 계속 확인할 수 있습니다. 워크플로에서 Executions 탭을 선택한 다음, 확인하려는 워크플로 실행을 선택하세요.

인증#

MCP URL에 연결하는 클라이언트에 인증을 요구할 수 있습니다. 다음 인증 방법 중에서 선택하세요.

• Bearer auth
• Header auth

각 자격 증명 유형 설정에 대한 자세한 내용은 HTTP request 자격 증명을 참고하세요.

경로#

기본적으로 이 필드에는 다른 MCP Server Trigger 노드와의 충돌을 피하기 위해 무작위로 생성된 MCP URL 경로가 들어 있습니다.

URL 경로를 직접 지정할 수 있으며, 라우트 파라미터를 추가하는 것도 가능합니다. 예를 들어 n8n을 사용해 API를 프로토타이핑하면서 일관된 엔드포인트 URL을 원할 경우 이 작업이 필요할 수 있습니다.

템플릿 및 예제#

MCP Server Trigger 노드 문서 통합 템플릿 찾아보기 또는 모든 템플릿 검색

Claude Desktop과 통합하기#

Claude Desktop에서 게이트웨이를 실행하여 SSE 메시지를 stdio 기반 서버로 프록시함으로써 MCP Server Trigger 노드에 연결할 수 있습니다.

이를 위해 Claude Desktop 설정에 다음을 추가하세요.

{
  "mcpServers": {
    "n8n": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "",
        "--header",
        "Authorization: Bearer ${AUTH_TOKEN}"
      ],
      "env": {
        "AUTH_TOKEN": ""
      }
    }
  }
}

과 자리 표시자를 MCP Server Trigger 노드의 파라미터와 자격 증명에서 얻은 값으로 반드시 교체하세요.

제한 사항#

웹훅 레플리카를 사용하여 MCP Server Trigger 노드 구성하기#

MCP Server Trigger 노드는 SSE(Server-Sent Events) 또는 스트리밍 가능한 HTTP에 의존하며, 이는 지속적인 연결을 처리하기 위해 동일한 서버 인스턴스가 필요합니다. 이는 웹훅 프로세서 구성에 따라 큐 모드에서 n8n을 실행할 때 문제를 일으킬 수 있습니다.

• 단일 웹훅 레플리카로 큐 모드를 사용하는 경우, MCP Server Trigger 노드는 예상대로 작동합니다.
• 여러 웹훅 레플리카를 실행하는 경우, 모든 /mcp* 요청을 단일 전용 웹훅 레플리카로 라우팅해야 합니다. MCP 요청 전용으로 웹훅 컨테이너 하나를 갖는 별도의 레플리카 세트를 만드세요. 그런 다음 인그레스 또는 로드 밸런서 설정을 업데이트하여 모든 /mcp* 트래픽을 해당 인스턴스로 보내도록 하세요.

관련 리소스#

n8n은 또한 n8n AI 에이전트를 외부 도구에 연결할 수 있는 MCP Client Tool 노드를 제공합니다.

프로토콜, 서버, 클라이언트에 대한 자세한 내용은 MCP 문서와 MCP 사양을 참고하세요.

일반적인 문제#

MCP Server Trigger 노드에서 발생하는 일반적인 오류와 문제, 그리고 이를 해결하거나 문제를 진단하는 단계는 다음과 같습니다.

리버스 프록시와 함께 MCP Server Trigger 노드 실행하기#

nginx와 같은 리버스 프록시 뒤에서 n8n을 실행하는 경우, MCP 엔드포인트가 SSE 또는 스트리밍 가능한 HTTP용으로 구성되어 있지 않으면 문제가 발생할 수 있습니다.

구체적으로, 해당 엔드포인트에 대해 프록시 버퍼링을 비활성화해야 합니다. 그 외에도 조정할 수 있는 항목으로는 gzip 압축 비활성화(n8n이 자체적으로 이를 처리함), 청크 전송 인코딩 비활성화, 전달되는 헤더에서 제거하기 위해 Connection을 빈 문자열로 설정하는 것 등이 있습니다. MCP 엔드포인트에서 이러한 항목을 명시적으로 비활성화하면 nginx 설정의 다른 부분에서 상속되지 않도록 보장할 수 있습니다.

이러한 설정으로 MCP 트래픽을 처리하는 nginx location 블록의 예는 다음과 같습니다.

location /mcp/ {
    proxy_http_version          1.1;
    proxy_buffering             off;
    gzip                        off;
    chunked_transfer_encoding   off;

    proxy_set_header            Connection '';

    # The rest of your proxy headers and settings
    # . . .
}

Footnotes

1. 트리거 노드는 특정 조건에 응답하여 워크플로를 실행하는 역할을 하는 특수 노드입니다. 모든 프로덕션 워크플로에는 워크플로 실행 시점을 결정하는 트리거가 최소 하나 이상 필요합니다. ↩