MCP Client 노드는 외부 MCP 서버가 노출하는 도구를 사용할 수 있게 해주는 Model Context Protocol(MCP) 클라이언트입니다.

MCP Client 노드를 사용하여 워크플로에서 MCP 도구를 일반 단계로 사용할 수 있습니다.

AI Agent용 도구로 MCP 도구를 사용하려면 대신 MCP Client Tool node를 사용하세요.

노드 매개변수#

다음 매개변수로 노드를 구성합니다.

• Server Transport: 연결하려는 MCP 서버 엔드포인트가 사용하는 전송 프로토콜입니다.
• MCP Endpoint URL: 외부 MCP 서버의 URL입니다. 예: https://mcp.notion.com/mcp.
• Authentication: MCP 서버에 대한 인증 방법입니다. MCP Client 노드는 bearer, 일반 header, 다중 헤더, OAuth2 인증을 지원합니다. 인증 없이 연결을 시도하려면 None을 선택하세요.
  • Multiple Headers Auth: MCP 서버가 API 키와 사용자 이름처럼 두 개 이상의 헤더를 요구할 때 사용합니다. 자격 증명에서 각 헤더를 Name과 Value 쌍으로 추가하세요. 필요한 만큼 헤더를 추가할 수 있습니다.
• Tool: 노드에서 사용할 도구를 선택합니다. 도구 목록은 외부 MCP 서버에서 자동으로 가져옵니다.
• Input Mode:
  • Manual: 각 도구 매개변수를 수동으로 지정합니다.
  • JSON: 도구 매개변수를 JSON 객체로 지정합니다. 중첩된 매개변수가 있는 도구에는 이 모드를 사용하세요.

옵션#

• Convert to Binary: 이미지와 오디오를 바이너리 데이터로 변환할지 여부입니다. false인 경우 이미지와 오디오는 base64로 인코딩된 문자열로 반환됩니다.
• Timeout: 도구 호출이 완료될 때까지 대기할 시간(밀리초)입니다.

템플릿 및 예제#

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

관련 자료#

AI Agent와 함께 MCP 도구를 사용하려면 n8n의 MCP Client Tool node를 이용하세요.

n8n에는 외부 AI Agent에 n8n 도구를 노출할 수 있는 MCP Server Trigger 노드도 있습니다.

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