MCP 클라이언트

**Model Context Protocol(MCP)**은 AI 모델에 도구를 제공하기 위한 개방형 표준입니다. 많은 서비스가 MCP 서버를 제공하며, 직접 만들 수도 있습니다. AI MCP 클라이언트는 MonoChat을 하나의 MCP 서버에 연결하여, 해당 서버가 제공하는 도구를 MonoChat에서 작성하는 AI 도구 함수와 함께 AI 노드와 AI 에이전트에 부여할 수 있게 합니다.

설정 › 자동화 › AI MCP 클라이언트에서 관리합니다.

작동 방식

1. MCP 서버 주소를 추가하고 연결합니다. MonoChat이 서버가 제공하는 도구, 리소스, 리소스 템플릿, 프롬프트를 읽어 옵니다.
2. 저장하면 MonoChat이 해당 목록을 클라이언트의 콘텐츠로 보관합니다.
3. AI 채팅 완성 생성 노드 또는 AI 에이전트 노드에서 해당 노드에 사용할 도구를 선택하고, 모델을 위해 각 도구의 설명을 다시 작성할 수 있습니다.
4. 대화 중에 모델이 도구를 호출할 시점을 결정하면, MonoChat이 MCP 서버를 호출하고 그 결과를 모델에 돌려줍니다.

노드에 추가한 도구만 해당 노드에서 사용할 수 있으므로, 각 노드는 필요한 도구만 볼 수 있습니다.

MCP 클라이언트 추가

1. 설정 › 자동화 › AI MCP 클라이언트로 이동하여 +(만들기)를 클릭합니다.

2. 필드를 입력합니다.

   필드	설명
   이름	서버의 이름으로, 노드 패널에서 각 도구 옆에 표시됩니다.
   설명	선택 사항인 메모입니다.
   버전	연결할 때 MonoChat이 서버에 알리는 클라이언트 버전입니다. 예: 1.0.0.
   엔드포인트	MCP 서버의 기본 URL입니다. MonoChat은 <Endpoint>/sse에서 SSE 전송 방식으로 연결하므로, /sse를 뺀 주소를 입력하세요.
   인증 유형	없음, 기본(사용자 이름과 비밀번호 사용) 또는 Bearer(토큰 사용). 자격 증명은 클라이언트와 함께 저장됩니다.

3. 연결을 클릭합니다. MonoChat이 서버에 연결하고 찾은 내용을 탭으로 보여 줍니다.

   • 서버 정보: 서버의 이름, 버전, 프로토콜 버전, 지침.
   • 도구: 각 도구의 이름과 설명.
   • 서버가 제공하는 경우 리소스, 리소스 템플릿, 프롬프트.

4. 목록이 올바르면 저장을 클릭합니다. 주소를 변경하고 다시 시도하려면 옆에 있는 연결 해제 버튼을 클릭하세요.

팁

연결이 실패하면 엔드포인트가 인터넷에서 접근 가능한지, 서버가 SSE 전송 방식을 지원하는지, URL이 이미 /sse로 끝나지 않는지 확인하세요.

도구 목록 업데이트

MCP 서버에 도구가 추가되거나 변경되면 업데이트로 클라이언트를 여세요. MonoChat이 다시 연결하여 현재 콘텐츠를 보여 주며, 업데이트를 클릭하면 새 목록이 저장됩니다.

클라이언트를 삭제하면 그 콘텐츠도 함께 삭제되므로, 해당 클라이언트의 도구를 사용하던 노드는 그 도구를 잃게 됩니다.

노드에 도구 부여

AI 채팅 완성 생성 노드

1. 노드를 열고 AI MCP 클라이언트 콘텐츠 도구 설정까지 스크롤합니다.
2. AI MCP 클라이언트 콘텐츠 도구 설정하기를 클릭합니다. AI MCP 클라이언트 콘텐츠 도구 패널에 이 노드에 이미 추가된 도구가 나열됩니다.
3. +(만들기)를 클릭한 다음 AI MCP 클라이언트 콘텐츠 도구에서 도구를 선택합니다. 도구는 <client name> - <tool name> 형식으로 표시됩니다.
4. 설명에는 도구 자체의 설명이 채워집니다. 모델에게 도구를 언제 사용해야 하는지 더 정확히 알려 주려면 수정하세요. 예: "주문 번호로 주문을 조회할 때 사용합니다". 설명은 필수입니다.
5. 각 도구에 대해 반복한 후 노드를 저장합니다.

같은 패널에서 도구의 설명을 수정하거나 노드에서 도구를 제거할 수 있습니다.

AI 에이전트 노드

AI 에이전트 노드의 도구 설정 섹션에도 같은 AI MCP 클라이언트 콘텐츠 도구 설정하기 버튼이 있습니다. 선택한 MCP 도구는 모든 하니스에서 노드의 AI 범위 및 AI 도구와 함께 에이전트에 제공됩니다. AI 에이전트를 참조하세요.

정보

에이전트 실행 시 노드의 모든 MCP 도구가 워크스페이스에 여전히 존재하는지 확인합니다. 노드가 사용하는 MCP 클라이언트를 삭제하면, 노드에서 해당 도구를 제거할 때까지 그 노드의 실행이 "이 워크스페이스에서 AI 범위 또는 MCP 도구를 찾을 수 없습니다."라는 메시지와 함께 실패합니다.

권한

접근은 역할 권한인 자동화 AI MCP 클라이언트 조회 / 생성 / 수정 / 삭제와 자동화 AI MCP 클라이언트 콘텐츠 조회로 제어됩니다. 역할을 참조하세요.

관련 문서

• 함수(AI 도구 함수)
• AI 에이전트
• MonoChat AI 지원