MCP Reference: ces.googleapis.com

모델 컨텍스트 프로토콜 (MCP) 서버는 대규모 언어 모델 (LLM) 또는 AI 애플리케이션에 컨텍스트, 데이터 또는 기능을 제공하는 외부 서비스 간의 프록시 역할을 합니다. MCP 서버는 AI 애플리케이션을 데이터베이스 및 웹 서비스와 같은 외부 시스템에 연결하여 응답을 AI 애플리케이션이 이해할 수 있는 형식으로 변환합니다.

서버 설정

사용하기 전에 MCP 서버를 사용 설정하고 인증을 설정해야 합니다. Google 및 Google Cloud 원격 MCP 서버 사용에 대한 자세한 내용은 Google Cloud MCP 서버 개요를 참고하세요.

고객 경험을 위한 Gemini Enterprise API의 MCP 서버

서버 엔드포인트

MCP 서비스 엔드포인트는 AI 애플리케이션 (MCP 클라이언트의 호스트)이 보안 표준 연결을 설정하는 데 사용하는 MCP 서버의 네트워크 주소 및 통신 인터페이스 (일반적으로 URL)입니다. LLM이 컨텍스트를 요청하거나, 도구를 호출하거나, 리소스에 액세스할 때 사용하는 연락처입니다. Google MCP 엔드포인트는 전역 또는 리전일 수 있습니다.

ces.googleapis.com MCP 서버에는 다음과 같은 MCP 엔드포인트가 있습니다.

  • https://ces.[REGION].rep.googleapis.com/mcp

MCP 도구

MCP 도구는 MCP 서버가 LLM 또는 AI 애플리케이션에 노출하여 실제 작업을 실행하는 함수 또는 실행 가능한 기능입니다.

ces.googleapis.com MCP 서버에는 다음 도구가 있습니다.

MCP 도구
list_apps 특정 프로젝트와 위치의 앱을 나열합니다.
get_app 지정된 앱의 세부정보를 가져옵니다.
create_app 지정된 프로젝트와 위치에 새 앱을 만듭니다.
update_app 지정된 앱을 업데이트합니다. 항상 입력에 업데이트 마스크를 전달해야 합니다.
delete_app 지정된 앱을 삭제합니다.
list_agents 지정된 앱의 에이전트를 나열합니다.
get_agent 지정된 에이전트의 세부정보를 가져옵니다.
create_agent 지정된 앱에 새 에이전트를 만듭니다.
update_agent 지정된 에이전트를 업데이트합니다. 항상 입력에 업데이트 마스크를 전달해야 합니다.
delete_agent 지정된 에이전트를 삭제합니다.
list_tools 지정된 앱의 도구를 나열합니다.
get_tool 지정된 도구의 세부정보를 가져옵니다.
create_tool 지정된 앱에 새 도구를 만듭니다.
update_tool 지정된 도구를 업데이트합니다. 항상 입력에 업데이트 마스크를 전달해야 합니다.
delete_tool 지정된 도구를 삭제합니다.
list_guardrails 지정된 앱의 가이드라인을 나열합니다.
get_guardrail 지정된 가드레일의 세부정보를 가져옵니다.
create_guardrail 지정된 앱에 새로운 가드레일을 만듭니다.
update_guardrail 지정된 가드레일을 업데이트합니다. 항상 입력에 업데이트 마스크를 전달해야 합니다.
delete_guardrail 지정된 가드레일을 삭제합니다.
list_deployments 지정된 앱의 배포를 나열합니다.
get_deployment 지정된 배포의 세부정보를 가져옵니다.
create_deployment 지정된 앱에 새 배포를 만듭니다.
update_deployment 지정된 배포를 업데이트합니다. 항상 입력에 업데이트 마스크를 전달해야 합니다.
delete_deployment 지정된 배포를 삭제합니다.
list_toolsets 지정된 앱의 툴셋을 나열합니다.
get_toolset 지정된 도구 모음의 세부정보를 가져옵니다.
create_toolset 지정된 앱에 새 도구 모음을 만듭니다.
update_toolset 지정된 도구 모음을 업데이트합니다. 항상 입력에 업데이트 마스크를 전달해야 합니다.
delete_toolset 지정된 도구 모음을 삭제합니다.
list_app_versions 지정된 앱의 모든 앱 버전을 나열합니다.
get_app_version 지정된 앱 버전의 세부정보를 가져옵니다.
create_app_version 지정된 앱에 새 앱 버전을 만듭니다.
delete_app_version 지정된 앱 버전을 삭제합니다.
restore_app_version 지정된 앱 버전을 복원합니다.
list_changelogs 지정된 앱의 변경 로그를 나열합니다.
get_changelog 지정된 변경사항의 세부정보를 가져옵니다.
start_export_app CES 앱 내보내기를 시작합니다.
start_import_app CES 앱 가져오기를 시작합니다.
run_evaluation CES 앱의 평가를 실행합니다.
create_evaluation 새 평가를 만듭니다.
create_evaluation_dataset 새 평가 데이터 세트를 만듭니다.
delete_evaluation 지정된 평가를 삭제합니다.
delete_evaluation_dataset 지정된 평가 데이터 세트를 삭제합니다.
generate_evaluation_from_conversation 대화에서 평가를 생성합니다.
get_evaluation 지정된 평가의 세부정보를 가져옵니다.
get_evaluation_dataset 지정된 평가 데이터 세트의 세부정보를 가져옵니다.
get_evaluation_result 지정된 평가 결과의 세부정보를 가져옵니다.
get_evaluation_run 지정된 평가 실행의 세부정보를 가져옵니다.
list_evaluation_datasets 평가 데이터 세트를 나열합니다.
list_evaluation_results 평가 결과를 나열합니다.
list_evaluation_runs 평가 실행을 나열합니다.
list_evaluations 평가를 나열합니다.
update_evaluation 지정된 평가를 업데이트합니다. 항상 입력에 업데이트 마스크를 전달해야 합니다.
update_evaluation_dataset 지정된 평가 데이터 세트를 업데이트합니다. 항상 입력에 업데이트 마스크를 전달해야 합니다.
delete_evaluation_result 지정된 평가 결과를 삭제합니다.
delete_evaluation_run 지정된 평가 실행을 삭제합니다.
get_conversation 지정된 대화의 세부정보를 가져옵니다.
list_conversations 대화를 나열합니다.
get_operation

장기 실행 작업의 상태를 가져옵니다.

사용 일부 도구 (예: run_evaluation)는 장기 실행 작업을 반환합니다. 이 도구를 사용하여 작업 상태를 확인할 수 있습니다. 장기 실행 작업의 상태를 폴링하기 위해 반복적으로 호출할 수 있습니다.

매개변수 * name: 가져올 작업의 이름입니다. * name은 작업을 시작한 도구에서 반환된 이름이어야 합니다. * nameprojects/{project}/locations/{location}/operations/{operation} 형식이어야 합니다.

MCP 도구 사양 가져오기

MCP 서버의 모든 도구에 대한 MCP 도구 사양을 가져오려면 tools/list 메서드를 사용하세요. 다음 예시에서는 curl을 사용하여 MCP 서버 내에서 현재 사용할 수 있는 모든 도구와 사양을 나열하는 방법을 보여줍니다.

curl 요청
                      curl --location 'https://ces.[REGION].rep.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
    "method": "tools/list",
    "jsonrpc": "2.0",
    "id": 1
}'