MCP 서버 등록

에이전트 레지스트리는 모델 컨텍스트 프로토콜 (MCP) 서버 엔드포인트와 노출하는 특정 도구를 등록하고 관리하여 중앙 집중식 카탈로그 역할을 합니다.

이 문서에서는 MCP 서버를 등록하는 방법과 에이전트 레지스트리 내에서 도구 사양이 관리되는 방법을 설명합니다.

MCP 서버 자동 검색 Google Cloud

공식 Google 및 Google Cloud 원격 MCP 서버는 에이전트 레지스트리에 자동으로 등록되고 수집됩니다. 사용 가능한 Google 및 Google Cloud 원격 MCP 서버는MCP 서버 문서의 지원되는 제품에 나열되어 있습니다.Google Cloud

프로젝트에서 Compute Engine API와 같은 지원되는 Google Cloud API를 사용 설정하면 해당 MCP 서버와 도구가 즉시 등록되고 에이전트 레지스트리에서 검색할 수 있게 됩니다. 이러한 서비스의 도구 사양을 수동으로 구성하거나 업로드할 필요가 없습니다.

외부 MCP 서버 등록

외부 서비스 또는 커스텀 API에서 제공하는 도구를 관리하고 재사용하려면 MCP 서버를 명시적으로 등록해야 합니다.

MCP 서버를 수동으로 등록할 때 에이전트 레지스트리는 엔드포인트를 등록합니다. 하지만 서버를 자동으로 인트로스펙션하여 사용 가능한 도구를 확인하지는 않습니다. 사용자가 MCP 서버에서 사용할 수 있는 정확한 도구를 검색할 수 있도록 하려면 등록 중에 toolspec.json 파일을 업로드하여 도구 사양을 제공해야 합니다.

시작하기 전에

시작하기 전에 에이전트 레지스트리를 설정하세요. 이러한 작업을 수행하려면 프로젝트 ID 가 필요합니다.

이 문서의 gcloud CLI 명령어를 사용하려면 Google Cloud CLI 환경을 설정해야 합니다.

필요한 역할

에이전트 레지스트리에서 MCP 서버를 수동으로 등록하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 에이전트 레지스트리 API 편집자 (roles/agentregistry.editor) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참고하세요.

커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.

도구 사양 준비

서버에서 제공하는 도구를 간략하게 설명하는 toolspec.json 파일을 만듭니다. 이 JSON 파일은 도구 스키마의 MCP 사양과 일치해야 합니다. 예를 들면 다음과 같습니다.

{
  "tools": [
    {
      "name": "get_customer_info",
      "description": "Retrieves customer details from the database.",
      "annotations": {
        "title": "Get Customer Info",
        "readOnlyHint": true,
        "idempotentHint": true
      }
    },
    {
      "name": "create_support_ticket",
      "description": "Creates a new support ticket in the issue tracking system.",
      "annotations": {
        "title": "Create Support Ticket",
        "destructiveHint": true,
        "idempotentHint": false,
        "openWorldHint": true
      }
    }
  ]
}

자세한 구조적 요구사항은 JSON 스키마 및 REST 참조를 확인하세요.

서버 및 도구 등록

MCP 서버를 등록하고 도구 정의를 동시에 업로드합니다.

콘솔

콘솔에서 에이전트 레지스트리로 이동합니다. Google Cloud

에이전트 레지스트리로 이동
프로젝트 선택 도구에서 에이전트 레지스트리를 Google Cloud 설정한 프로젝트를 선택합니다.
MCP 서버 탭을 선택합니다.
MCP 서버 추가 를 클릭합니다.
MCP 서버 세부정보 패널에서 표시 이름, 설명, 지리적 리전을 입력합니다.
도구 사양 섹션에서 MCP 서버 엔드포인트 URL을 입력하고 toolspec.json 파일의 콘텐츠를 붙여넣습니다. 이 패널에서 도구 가져오기 를 클릭하여 URL에서 MCP 도구를 가져올 수도 있습니다.
다음 을 클릭합니다.

MCP 도구 선택 패널에 MCP 서버의 이름과 설명이 있는 도구 목록이 표시됩니다.
포함할 모든 MCP 도구를 선택합니다. 이름 또는 값으로 목록에서 도구를 필터링할 수 있습니다.
저장 을 클릭합니다.

gcloud

도구 사양으로 MCP 서버를 등록합니다.

gcloud alpha agent-registry services create SERVER_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --display-name="DISPLAY_NAME" \
  --mcp-server-spec-type=tool-spec \
  --mcp-server-spec-content=@toolspec.json \
  --interfaces=url=SERVER_URL,protocolBinding=PROTOCOL

다음을 바꿉니다.

SERVER_NAME: MCP 서버에 지정할 이름입니다(예: custom-mcp-server).
PROJECT_ID: 프로젝트 ID입니다.
REGION: 레지스트리 리전입니다.
DISPLAY_NAME: 서버에 지정할 사람이 읽을 수 있는 이름입니다(예: Custom MCP Server).
SERVER_URL: MCP 서버의 엔드포인트 URL입니다(예: https://api.example.com/mcp).
PROTOCOL: 엔드포인트의 프로토콜 바인딩입니다. 유효한 값은 JSONRPC, HTTP_JSON 또는 GRPC입니다. MCP 서버의 경우 이 값은 JSONRPC인 경우가 많습니다.

등록 확인

새로 등록된 MCP 서버의 세부정보를 나열, 필터링, 확인합니다. MCP 서버가 성공적으로 등록되었는지 확인하려면 레지스트리의 서버를 나열하면 됩니다.