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

MCP Server Trigger 노드의 작동 방식#

MCP Server Trigger 노드는 MCP 클라이언트가 n8n에 진입하는 진입점 역할을 합니다. MCP 클라이언트가 n8n 도구에 액세스하기 위해 상호작용할 수 있는 URL을 노출하여 작동합니다.

이벤트에 응답하고 출력을 다음 연결된 노드로 전달하는 기존 트리거 노드와 달리, MCP Server Trigger 노드는 도구 노드에만 연결하고 실행합니다. 클라이언트는 사용 가능한 도구를 나열하고 개별 도구를 호출하여 작업을 수행할 수 있습니다.

커스텀 n8n 워크플로 도구 노드를 연결하여 클라이언트에 n8n 워크플로를 노출할 수 있습니다.

노드 파라미터#

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

MCP URL#

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

테스트 URL 또는 프로덕션 URL을 선택하여 n8n이 표시하는 URL을 전환합니다.

• 테스트: 워크플로가 활성화되지 않은 경우 테스트 이벤트 수신 또는 워크플로 실행을 선택하면 n8n이 테스트 MCP URL을 등록합니다. MCP URL을 호출하면 n8n이 워크플로에 데이터를 표시합니다.
• 프로덕션: 워크플로를 게시하면 n8n이 프로덕션 MCP URL을 등록합니다. 프로덕션 URL을 사용할 때 n8n은 워크플로에 데이터를 표시하지 않습니다. 프로덕션 실행의 워크플로 데이터를 볼 수 있습니다: 워크플로의 실행 탭을 선택한 다음 보려는 워크플로 실행을 선택합니다.

인증#

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

• Bearer 인증
• 헤더 인증

각 자격 증명 유형 설정에 대한 자세한 내용은 HTTP 요청 자격 증명을 참조하십시오.

경로#

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

URL 경로를 수동으로 지정할 수 있으며 경로 파라미터도 추가할 수 있습니다. 예를 들어 n8n을 사용하여 API 프로토타입을 만들고 일관된 엔드포인트 URL을 원하는 경우 이 작업이 필요할 수 있습니다.

템플릿 및 예시#

Claude Desktop과 통합#

게이트웨이를 실행하여 SSE 메시지를 stdio 기반 서버로 프록시함으로써 Claude Desktop에서 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) 또는 스트리밍 가능 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 /mcp/ {
    proxy_http_version          1.1;
    proxy_buffering             off;
    gzip                        off;
    chunked_transfer_encoding   off;

    proxy_set_header            Connection '';

    # 나머지 프록시 헤더와 설정
    # . . .
}