모델 컨텍스트 프로토콜 (MCP)은 AI 애플리케이션을 외부 시스템에 연결하기 위한 오픈소스 표준입니다. 다양한 데이터 소스와 도구를 AI 모델에 연결하는 표준 방식으로 작동하는 특정 엔티티 집합과 정의된 구조를 설정합니다.
MCP 도구를 사용하여 에이전트 애플리케이션을 기존 MCP 서버에 연결할 수 있습니다.
제한사항
다음과 같은 제한사항이 적용됩니다.
- CX Agent Studio는 StreamableHttpTransport 기반 서버만 지원하며 SSE 전송 서버는 지원하지 않습니다.
MCP 서버 빌드 또는 선택
자체 MCP 서버를 빌드하려면 공식 MCP SDK 또는 FastMCP와 같은 신뢰할 수 있는 서드 파티 SDK를 사용하는 것이 좋습니다. MCP 서버가 생성되면 호스팅 서비스에 배포합니다. Cloud Run 또는 Compute Engine을 사용하여 MCP 서버를 호스팅할 수 있습니다. 이 가이드에 따라 전체 프로세스를 이해하세요. 10분 이내에 원격 MCP 서버를 빌드하고 Google Cloud Run에 배포
처음부터 MCP 서버를 빌드하는 대신 Google Cloud MCP 서버와 같은 사전 빌드된 MCP 서버를 사용할 수도 있습니다.
인증
MCP 도구에는 OpenAPI 도구와 동일한 인증 옵션이 있습니다.
MCP 서버를 독립적으로 테스트
에이전트를 MCP 서버에 연결하기 전에 MCP 서버를 독립적으로 테스트하는 것이 좋습니다.
StreamableHttpTransport를 사용하여 빌드된 서버는 접미사 (/mcp 또는 /mcp/)로 끝납니다. 예를 들어 서버가 https://example.com에 호스팅된 경우 서버에 요청을 전송하는 올바른 URL은 https://example.com/mcp입니다.
로컬에서 서버를 테스트하려면 curl 또는 Postman(기본적으로 MCP 연결 지원)을 사용하는 것이 좋습니다. 이렇게 하면 서버가 작동 중이고 서버와 통신하는 데 필요한 인증 정보를 이해할 수 있습니다.
MCP 도구 만들기
콘솔에서 MCP 도구를 만들려면 다음 단계를 따르세요.
- 에이전트 빌더 오른쪽에 있는 도구 아이콘을 클릭합니다.
- MCP 도구를 선택합니다.
- 도구 이름을 입력합니다.
- 도구 설명을 제공합니다.
- MCP 서버의 서버 주소를 제공합니다.
- 인증 유형을 선택합니다.
- 만들기를 클릭합니다.
Cloud Run에서 호스팅되는 서버의 경우 권장되는 인증 옵션은 서비스 에이전트 ID 토큰입니다.
이 메서드는 CX Agent Studio 서비스 계정(형식: service-{PROJECT_NUMBER}@gcp-sa-ces.iam.gserviceaccount.com)을 사용하여 Cloud Run 작업에 요청을 보냅니다.
CX Agent Studio 서비스 계정에 Cloud Run 호출자 역할을 부여하여 자체 ID를 사용하여 서버에 요청을 보낼 수 있도록 합니다.
에이전트에 추가 도구를 추가하기 전에 하나 이상의 도구를 테스트하여 인증 정보가 올바르게 설정되었는지 확인하는 것이 좋습니다.