MCP 서버

MCP(모델 컨텍스트 프로토콜) 서버에서 외부 툴을 가져와 상담원에게 추가하여 상담원의 작업 수행 능력을 향상시킬 수 있습니다.

MCP 서버 정보

MCP는 상담원이 MCP 서버를 통해 외부 도구 및 데이터 소스와 안전하고 유연하게 상호 작용할 수 있도록 하는 표준입니다. 상담원은 MCP를 통해 MCP 서버에서 제공하는 외부 도구를 검색하고, 연결하고, 시작할 수 있습니다. 이러한 서버는 웹 검색, 데이터베이스 쿼리, 이메일 전송, 웹 콘텐츠 가져오기 등 다양한 기능을 표준화된 방식으로 제공하는 중개자 역할을 합니다. 이 프로세스는 사용자 지정 API를 만들거나 수동으로 연결을 설정할 필요가 없으므로 상담원이 외부 도구를 사용하는 데 더 간단하고 효율적인 방법입니다.

MCP를 사용하면 상담원이 실행 중에 이러한 외부 도구를 검색하고 사용할 수 있어 고유의 기능을 뛰어넘는 기능을 향상시킬 수 있습니다. 외부 도구와의 모든 상호 작용은 단일 프로토콜을 통해 관리되므로 연결이 간소화되고 효율성이 향상됩니다. 또한 MCP는 서로 다른 공급업체 또는 플랫폼의 상담원 간에 협업 및 도구 공유를 용이하게 합니다.

도구는 로컬 MCP 서버 또는 원격 MCP 서버에서 가져올 수 있습니다. watsonx Orchestrate 는 일반적으로 npxuvx 명령을 사용하는 서버인 Node 및 Python MCP 서버의 설치 및 실행을 허용합니다.

로컬 MCP 서버는 사용자 자신의 시스템이나 네트워크에 설치 및 실행할 수 있습니다. 일반적으로 저장소에서 GitHub 다운로드하여 시스템에서 실행할 수 있습니다. 원격 MCP 서버는 외부 서버에 호스팅되며 인터넷을 통해 접근할 수 있습니다.

MCP는 SSO 또는 OBO 흐름은 물론, OAuth 2.0, Bearer Token, API Key, Basic Authentication 등 다양한 인증 방식을 지원합니다. MCP 서버를 구성할 때 연결 페이지에서 필요한 인증 유형을 선택할 수 있습니다. 인증 및 연결에 대한 자세한 내용은 앱 연결 및 자격 증명 관리를 참조하십시오.

로컬 또는 원격 MCP 서버에서 도구를 가져오기 전에 다음 단계를 따르십시오:

  1. 사용할 로컬 MCP 또는 원격 MCP 서버를 식별하십시오.

로컬 MCP 서버의 경우:

  1. 사용할 로컬 MCP 서버를 찾으십시오. 일반적으로 로컬 MCP 서버는 https://github.com/appcypher/awesome-mcp-servers 및 https://github.com/modelcontextprotocol/servers 와 같은 GitHub 저장소에서 찾을 수 있습니다.

  2. 설치 지침은 로컬 MCP 서버 문서 또는 읽기 파일에서 찾으십시오.

    • 일반적으로 Node 또는 Python.NET을 사용하여 로컬 MCP 서버를 시작하는 방법에 대한 지침을 찾을 수 있습니다. 예를 들어, npx -y time-mcp입니다.

    • 특정 로컬 MCP 서버는 원격 서비스와 통신하기 위해 API 키 또는 기타 환경 변수를 설정해야 합니다. 예를 들어 "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>" API 키입니다.

  3. 도구에 설명이 있는지 확인합니다. 로컬 MCP 서버의 각 도구에는 설명이 포함되어야 합니다. 설명은 기본 언어 모델에서 도구의 목적과 사용 방법을 이해하는 데 도움이 됩니다. 이 설명은 도구를 watsonx Orchestrate 으로 성공적으로 가져오기 위해서도 필요합니다. 도구 설명이 누락되면 오류가 발생합니다.

  1. MCP 서버가 상담원이 사용하기에 합법적이고 안전한지 확인하세요.

환경 변수가 필요한 MCP 서버 설치

환경 변수가 필요한 MCP 서버를 설치하려면 키-값 쌍을 사용하여 AppID/Connection 에 필요한 변수를 추가해야 합니다. 예를 들어 "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>" API 키를 사용하려면 GITHUB_PERSONAL_ACCESS_TOKEN 을 키로, 개인 토큰을 값으로 하는 키-값 쌍을 추가해야 합니다.

MCP 서버는 시작할 때 환경 변수를 가져오기 때문에 MCP 서버를 가져오거나 시작하기 전에 변수를 설정하는 것이 중요합니다.

MCP 서버 추가

IBM watsonx Orchestrate 또는 ADK(에이전트 개발 키트)를 사용하여 MCP 서버를 직접 추가할 수 있습니다.

MCP 서버를 가져오려면 MCP 서버에서 도구 가져오기를 참조하세요.

ADK를 사용하는 경우 MCP 서버는 툴킷으로 가져옵니다. 자세한 내용은 ‘툴킷 관리’를 참조하십시오.

제한사항

다음 기능은 MCP 서버 통합에서 지원되지 않습니다:

  • 도구 목록 새로 고침 또는 업데이트

MCP 서버에서 가져온 도구는 테넌트 카탈로그에서 자동으로 새로 고침되거나 업데이트될 수 없습니다. 서버 측 도구 목록의 변경 사항은 도구를 수동으로 재가져오기를 수행해야 합니다.

  • OAuth 2.1 및 동적 클라이언트 등록

OAuth 2.1 그리고 DCR은 지원되지 않습니다. OAuth2.0, API 키, Basic, Bearer 토큰, SSO 또는 OBO와 같은 기존 연결 유형만 지원됩니다.

  • 도구 실행 취소

도구가 실행되기 시작하면 자동으로 완료되어야 합니다. 사용자는 실행을 중지하거나 취소할 수 없습니다.

  • MCP 서버 리소스 및 프롬프트 가져오기

사전 정의된 프롬프트나 서버 측 자산과 같은 리소스는 플로우 빌더에서 가져와 사용할 수 없습니다. 도구만 추가할 수 있습니다.

  • Docker 이미지

Docker화된 MCP 서버 인스턴스는 플로우 빌더 내에서 가져오기 또는 실행이 지원되지 않습니다.

  • 추출 및 주석 달기

유도는 도구 실행 중 사용자로부터 정보를 상호작용적으로 수집하여 입력을 정제하거나 의사결정을 안내하는 과정이다. 주석 달기는 추가 분석이나 통합을 위해 도구 출력물에 메타데이터, 레이블 또는 주석을 추가하는 과정이다. 도구는 추출 및 주석을 지원하지 않습니다.

MCP 서버에서 가져오기

MCP(모델 컨텍스트 프로토콜) 서버에서 외부 툴을 가져와 상담원에게 추가하여 상담원의 작업 수행 능력을 향상시킬 수 있습니다.