연결된 앱 등록, 테스트, 게시

기본 요건을 충족한 후 다음 단계에 따라 연결된 앱을 등록, 구성, 테스트, 게시합니다.

1단계: 연결된 앱 만들기

연결된 앱을 만들려면 다음 안내를 따르세요.

  1. Google Connected Console에 로그인합니다.
  2. 홈페이지에서 앱 만들기를 선택합니다.
  3. 만들 항목 선택 대화상자에서 다음을 수행합니다.
    • 연결된 앱 서비스 약관에 동의하라는 메시지가 표시되면 약관 보기를 선택하고 계약을 검토하고 동의한 후 만들기를 선택합니다. 계정 관리자만 계약에 동의할 수 있습니다.
    • 그렇지 않으면 연결된 앱 카드에서 만들기를 선택합니다.

  4. 연결된 앱의 이름 지정 대화상자에서 연결된 앱의 이름을 입력합니다. 이 이름은 Google 제품 전반에서 연결된 앱을 표시하는 데 사용되며 사용자가 @를 사용하여 연결된 앱을 멘션하는 방식입니다. 다음을 선택합니다.

  5. 연결된 앱 카테고리 선택 대화상자의 카테고리 선택 메뉴에서 앱의 도메인, 카테고리 또는 업종을 선택합니다.

  6. 연결 유형 선택 대화상자에서 다음 옵션 중 하나를 선택합니다.

    • MCP 서버: MCP 서버를 연결하여 웹, Android, iOS 전반에서 Gemini 및 Google 검색 사용자에게 서비스를 제공합니다.
    • Android MCP: 앱에서 사용자를 위해 작업을 트리거하고 완료할 수 있도록 Android의 Gemini에 온디바이스 기능을 노출합니다.

    Android MCP 연결 앱을 설정하는 방법을 자세히 알아보세요. 연결된 앱당 하나의 연결 유형만 선택할 수 있으며 나중에 변경할 수 없습니다.

  7. 연결된 앱 만들기를 선택합니다.

그러면 연결된 앱의 관리 개요 페이지(연결된 앱 설정 및 테스트)가 열리며, 여기에서 앱 세부정보, MCP 서버 연결, 테스터를 구성할 수 있습니다.

2단계: 연결된 앱의 세부정보 입력하기

연결된 앱에 관한 세부정보를 제공하고 사용자에게 표시되는 방식을 구성하려면 다음 안내를 따르세요.

  1. 연결된 앱의 개요 페이지에 있는 앱 세부정보 행에서 시작하기를 선택합니다(기존 세부정보를 업데이트하는 경우 관리 선택).
  2. 앱 세부정보 페이지 상단에서 연결된 앱 이름 필드를 확인합니다. 필요한 경우 이름을 업데이트할 수 있습니다. 이 이름은 Google 제품 전반에서 사용자에게 표시되며, 사용자가 @을 사용하여 앱을 멘션할 때 사용됩니다.
  3. 공개 세부정보 섹션의 아이콘에서 앱 아이콘(JPG 또는 PNG, 최대 1MB, 512px × 512px)을 업로드합니다.

  4. 다음 입력란을 작성하세요.

    • 설명: 연결된 앱의 주요 기능과 앱으로 할 수 있는 작업을 설명하는 간결한 한 문장 요약(30단어 미만)을 입력합니다. 이 텍스트는 사용자에게 표시되며 모델 안내로 사용되지 않습니다.
    • 기능: 연결된 앱이 수행할 수 있는 가치가 높은 작업을 3개 이상 입력합니다. 기능 추가를 선택하여 항목을 더 추가합니다. 기능 시작 부분에 숫자를 포함하지 마세요. 항목당 하나의 기능만 포함합니다. 카테고리에 사전 정의된 기능이 포함된 경우 목록 상단에 표시되며 수정할 수 없습니다.
    • 프롬프트 예시: 사용자가 요청할 수 있는 작업을 이해하는 데 도움이 되는 프롬프트 예시를 3개 이상 입력합니다. 예시 프롬프트 추가를 선택하여 항목을 추가합니다.
      • @<YourAppName>(예: @Order Tracker where is my last order?)로 시작하는 프롬프트 2개 이상을 입력합니다.
      • 앱 이름으로 시작하지 않는 하나 이상의 프롬프트에서 자연스럽게 <YourAppName> 앱을 언급하세요(예: Track my recent order on Order Tracker).
      • 번호가 매겨진 프리픽스(1., 2., 3.)를 포함하거나 프롬프트를 따옴표("...")로 묶지 마세요.

    • 다국어 현지화: 설명, 기능, 예시 프롬프트의 번역을 제공하려면 입력란 내에서 각 언어의 텍스트를 언어 태그로 래핑합니다. 예를 들면 다음과 같습니다.

      <en-US>
Play music, manage playlists, and discover artists
</en-US>
<es-ES>
Reproduce música, gestiona listas y descubre artistas
</es-ES>

      Connected Console은 태그를 자동으로 검증하고 각 필드 아래에 감지된 언어를 표시합니다(예: Found translations for 2 languages: en-US, es-ES).

    • 서비스 약관 URL: 서비스 약관에 대한 유효한 https:// 또는 http:// 링크를 입력합니다.

    • 정책 URL: 개인정보처리방침으로 연결되는 유효한 https:// 또는 http:// 링크를 입력합니다.

    • 웹사이트 URL(선택사항): 저작자 표시를 위해 웹사이트 링크를 입력합니다.

  5. 페이지 하단의 저장을 선택하여 개요 페이지로 돌아갑니다.

3단계: MCP 엔드포인트 입력 및 도메인 소유권 확인

Google이 MCP 서버에 연결하거나 도구를 동기화하려면 먼저 MCP 서버 엔드포인트 URL을 제공하고 호스팅되는 도메인을 소유하고 있는지 확인해야 합니다.

MCP 엔드포인트를 입력하고 도메인 소유권을 확인하려면 다음 단계를 따르세요.

  1. 연결된 앱의 개요 페이지에 있는 MCP 및 도구 설정 카드에서 시작하기를 선택합니다(기존 세부정보를 업데이트하는 경우 관리 선택). 그러면 MCP 설정 흐름의 1단계(MCP 서버 엔드포인트)가 열립니다.
  2. MCP 서버 엔드포인트 연결에서 MCP 서버 엔드포인트의 전체 HTTPS URL(예: https://api.yourdomain.com/v1/mcp)을 입력합니다.

  3. 도메인 확인에서 도메인의 챌린지 토큰 확인을 완료합니다. 개발자 계정에서 도메인 또는 상위 도메인을 이미 확인한 경우 자동으로 확인된 것으로 표시됩니다.

    1. 도메인 소유권 확인 카드에서 토큰 다운로드를 선택합니다. 브라우저에서 다음 구조의 google-connected-apps.json 파일을 다운로드합니다.

      {
  "verification_tokens": [
    "YOUR_VERIFICATION_TOKEN"
  ]
}

    2. 이 JSON 콘텐츠를 https://<your-domain>/.well-known/google-connected-apps에서 서버에 업로드하고 호스팅합니다.

      • 엔드포인트가 HTTPS를 통해 공개적으로 연결할 수 있고, HTTP 리디렉션 없이 HTTP 200 OK를 직접 반환하며, verification_tokens 배열 내에 토큰을 포함하는지 확인합니다.

    3. Google Connected Console로 돌아가 도메인 확인을 선택합니다.

    4. 확인이 완료되면 챌린지 토큰으로 도메인 확인됨 행에 녹색 체크표시가 표시되고 그 아래에 있는 사용자 인증 정보 액세스 섹션이 잠금 해제됩니다.

4단계: 액세스 사용자 인증 정보 구성

도메인을 확인한 후 Google이 MCP 서버로 인증하는 방법을 구성하고 서버의 도구 정의를 가져옵니다.

액세스 사용자 인증 정보를 구성하려면 다음 안내를 따르세요.

  1. MCP 및 도구 설정 페이지의 1단계에 있는 액세스 사용자 인증 정보 제공 섹션에서 시작하기를 선택합니다(또는 사용자 인증 정보 업데이트를 선택하여 기존 구성 수정).

  2. 서버에 승인이 필요한가요?에서 다음 옵션 중 하나를 선택합니다.

    • 아니요: 인증 없이 MCP 서버에 공개적으로 액세스할 수 있는 경우 이 옵션을 선택한 다음 확인을 선택합니다.

    • 예: MCP 서버에서 노출하는 도구 중 승인이 필요한 도구가 있는 경우 이 옵션을 선택합니다. 그런 다음 MCP 서버에서 사용하는 승인 모델 선택에서 인증 흐름을 선택합니다.

      • 머신 간(OAuth 클라이언트 사용자 인증 정보): Google이 최종 사용자 로그인 리디렉션 없이 공유 클라이언트 ID 및 보안 비밀을 사용하여 MCP 서버와 직접 통신하는 서비스 간 인증(RFC 6749)에 선택합니다.
        1. 클라이언트 ID(필수) 및 클라이언트 보안 비밀번호(선택사항)를 입력합니다.
        2. 서버가 /.well-known/oauth-authorization-server를 사용하여 광고하지 않는 경우 승인 엔드포인트(선택사항) 및 토큰 엔드포인트(선택사항)를 입력합니다.
        3. 클라이언트 등록(또는 클라이언트 업데이트)을 선택합니다.

      • 사용자 위임(승인 코드): MCP 서버에서 개별 사용자가 Google 계정 연결을 사용하여 자신의 계정으로 로그인하고 작업을 승인해야 하는 경우에 선택합니다.

        1. Google의 OAuth 리디렉션 URI 허용 목록 추가: 제공된 리디렉션 URI를 허용 목록에 추가했는지 확인 배너에서 보기를 선택하거나 복사 아이콘을 선택하여 연결된 앱에 생성된 정확한 앱별 리디렉션 URI를 검사합니다. 이를 OAuth 서버의 허용 목록에 추가한 다음 Google Connected Console로 돌아갑니다.
        2. Google이 OAuth 서버로 인증하는 방법 선택에서 OAuth 클라이언트가 등록되는 방법을 선택합니다.
          • 사전 등록됨: OAuth 제공업체에서 정적 클라이언트 ID 및 클라이언트 보안 비밀번호(선택사항)를 생성하는 경우에 이 옵션을 선택하세요. 원하는 경우 커스텀 승인 엔드포인트(선택사항) 및 커스텀 토큰 엔드포인트(선택사항)를 제공할 수도 있습니다.
          • 클라이언트 ID 메타데이터 또는 동적 클라이언트 등록(권장): 서버에서 OAuth 클라이언트 ID 메타데이터 문서(CIMD) 또는 동적 클라이언트 등록(RFC 7591)을 지원하는 경우에 이 옵션을 선택하세요. Google은 먼저 CIMD를 확인하고 .well-known 검색 엔드포인트를 사용하여 DCR로 대체합니다. 원하는 경우 커스텀 승인 및 토큰 엔드포인트를 지정할 수도 있습니다.

        3. 개발자 인증 정보로 인증에서 승인 모델로 사용자 위임을 선택했으므로 Google에서 도구를 가져오기 전에 서버에 로그인해야 합니다. 다음 중 하나를 선택합니다.

          • 팝업을 통해 인증(권장): 오버레이된 대화상자에서 인증 흐름을 엽니다. 이는 기본 환경입니다.
          • 리디렉션을 통해 인증(대체): 동일한 탭 또는 창에서 전체 화면 리디렉션을 사용하여 인증 흐름을 엽니다. 표시 제약조건 또는 보안 헤더(예: X-Frame-Options 또는 Content-Security-Policy)로 인해 대화상자가 렌더링되지 않는 경우에 이 옵션을 사용하세요.

          먼저 대화상자를 사용하여 인증을 시도하는 것이 좋습니다. 대화상자를 사용하여 인증할 수 없는 경우 리디렉션 방법을 사용합니다. 또한 선택한 항목에 따라 사용자가 연결된 앱을 처음 사용할 때의 로그인 환경이 결정됩니다.

        4. 클라이언트 등록(또는 클라이언트 업데이트)을 선택합니다.

5단계: 테스트 계정 세부정보 제공(사용자 위임 승인에만 해당)

연결된 앱에 인증이 필요한 경우 현실적인 샘플 데이터가 자동 입력되고 2단계 인증(2FA)이 사용 중지된 시드 테스트 사용자 인증 정보와 테스트 안내를 Google 담당자에게 제공해야 합니다. 이렇게 하면 Google의 검토 및 QA팀이 빈 샌드박스, 페이월 또는 2단계 인증 문제로 인해 차단되지 않고 도구 실행을 확인할 수 있습니다. Google에서 연결된 앱을 완전히 테스트할 수 없는 경우 검토 중에 거부될 수 있습니다.

6단계: 도구 동기화하기

연결된 앱의 각 버전을 만들기 위해 Google은 제공된 엔드포인트와 동기화하여 사용 가능한 도구를 가져오고 스냅샷을 만듭니다. 이러한 도구는 해당 버전의 사용자가 사용할 수 있습니다. 연결된 앱 버전이 프리뷰 상태이고 테스터가 사용할 수 있는 동안에는 서버에서 계속 변경하고 도구를 다시 동기화하여 업데이트할 수 있습니다. 이렇게 하면 도구의 새 스냅샷이 생성됩니다.

게시하면 도구의 최신 스냅샷이 해당 버전의 연결된 앱에 사용됩니다. 더 이상 도구, 설명 또는 서버 세부정보를 변경할 수 없습니다. 도구를 업데이트하거나 서버의 수정사항을 동기화하려면 연결된 앱 버전을 새로 만드세요. 연결된 앱의 각 버전에 대해 새 엔드포인트를 만드는 것이 좋습니다.

도구를 동기화하려면 다음 단계를 따르세요.

  1. 동기화 도구 섹션에서 다음을 수행합니다.

    1. 동기화 도구를 선택합니다.
    2. 로그인하라는 메시지가 표시되면 사용자에게 노출할 모든 도구를 나열할 수 있는 권한이 있는 개발자 계정으로 인증합니다. 계정에서 액세스할 수 없는 도구는 동기화되지 않습니다.
    3. 연결되면 Connected Console에 동기화된 도구 수와 도구 다시 동기화 버튼이 표시됩니다.

  2. 페이지 하단의 다음을 선택하여 MCP 및 도구 설정의 2단계로 진행합니다.

7단계: 사용자가 앱을 경험하는 방식과 위치 결정하기

MCP 및 도구 설정 페이지의 도구 섹션에서 연결된 앱을 사용할 수 있는 지리적 위치, 언어, 사용할 수 있는 Google 제품과 같은 기본 매개변수를 구성합니다.

  1. 사용 가능 여부의 버전 사용 가능 지역 옆에서 다음 타겟팅 옵션을 구성합니다.
    • 국가/지역: 연결된 앱을 사용할 수 있는 지리적 위치를 선택합니다.
    • 언어: 연결된 앱에서 지원하는 언어를 선택합니다.
    • 제품: 연결된 앱을 사용할 수 있는 Google 제품을 선택합니다.

  2. 사용 가능 여부 뒤의 도구 섹션에서 MCP 서버에서 동기화된 도구를 검토합니다. 도구 목록에서 도구를 선택하여 오른쪽의 도구 관리 패널에서 설정을 구성합니다.

    • 도구 사용 설정: 도구 사용 설정 스위치를 전환하여 연결된 앱에 도구를 포함하거나 제외합니다. 사용 중지된 도구는 연결된 앱에서 사용자가 상호작용할 수 없습니다.

    • 추가 컨텍스트: 도구가 작동하는 데 Google의 문맥 시그널이 필요한지 여부를 선택합니다.

      • 언어: 사용자의 Google 계정에 따라 결정된 언어입니다.
      • 대략적인 위치: 넓이가 3제곱킬로미터 이상인 영역 내의 실제 사용자 또는 기기 위치입니다(예: 사용자가 있는 도시).
      • 정확한 위치: 정확도가 50미터 이내인 실제 사용자 또는 기기 위치입니다.

    • 사용자 확인: 도구를 실행하기 전에 명시적인 사용자 확인을 요구하려면 사용자 확인 필요를 선택합니다. 도구의 MCP 주석에 destructiveHint: true가 지정된 경우 이 옵션이 자동으로 미리 선택됩니다.

  3. MCP 서버가 UI 리소스를 제공하는 경우 도구 옆에 있는 UI 리소스 탭으로 전환하여 서버의 UI 리소스(text/html, text/html;profile=mcp-app, text/javascript, text/css)를 검사하고, 각 리소스에 연결된 도구를 확인하고, 콘텐츠 보안 정책(CSP) connectDomains 및 resourceDomains를 검토합니다.

  4. 페이지 하단에서 저장을 선택합니다.

앱 세부정보와 MCP 및 도구 설정이 모두 저장되면 추가한 모든 테스터가 미리 볼 수 있도록 구성이 자동으로 제공되며 개요 페이지의 버전 상태가 테스터에게 제공됨으로 업데이트됩니다.

8단계: 연결된 앱 테스트하기

테스터가 연결된 앱을 사용할 수 있도록 하려면 테스터 관리 화면에서 테스터를 추가해야 합니다. 테스터 목록에 추가한 사용자만 게시되지 않은 연결된 앱을 보고 상호작용할 수 있습니다. @gmail.com 계정이 있는 테스터만 추가할 수 있습니다.

  1. 연결된 앱의 개요 페이지에 있는 앱 테스트 카드에서 테스터 추가(또는 이미 추가한 경우 테스터 관리)를 선택합니다.

  2. 테스터 관리 화면에서 기존 이메일 목록을 선택하거나 이메일 목록 만들기를 선택하여 통합을 테스트할 수 있는 권한이 부여된 Google 계정을 추가합니다. 앱을 직접 테스트하려면 자신의 이메일 주소를 포함해야 합니다.

  3. 저장을 선택합니다.

  4. Gemini 앱의 테스터는 @ 다음에 연결된 앱의 이름을 입력하고 메뉴에서 선택하여 연결된 앱을 호출할 수 있습니다. 왼쪽 탐색 메뉴에서 설정 및 도움말 → 연결된 앱으로 이동하여 Gemini에서 앱을 확인하고 연결할 수도 있습니다.

  5. 통합을 철저히 테스트하는 것이 좋습니다.

    • 모든 프롬프트 예시를 사용해 봅니다.
    • 명시적 @<AppName> 호출과 자연어 쿼리를 모두 테스트합니다.
    • 엔드 투 엔드 인증 흐름, 도구 실행, 사용자 확인 메시지, UI 리소스를 확인합니다.

테스트가 만족스러우면 연결된 앱을 Google에 제출하여 검토를 받을 수 있습니다.

9단계: 연결된 앱 검토를 시작하고 승인 후 게시하기

연결된 앱을 모든 사용자에게 제공하기 전에 Google에서 통합을 검토하고 테스트합니다.

검토를 위해 연결된 앱을 전송하려면 다음 단계를 따르세요.

  1. 연결된 앱의 개요 페이지에서 페이지 오른쪽에 있는 버전 카드에서 검토를 위해 전송을 선택합니다(앱 구성이 완료되고 차단 문제가 없는 미리보기 상태인 경우 사용 설정됨).

  2. 버전이 검토 중인 경우:

    • Connected Console은 수정 가능한 새 초안 버전을 자동으로 생성하므로 테스터는 앱을 계속 미리 볼 수 있으며 개발자는 검토를 중단하지 않고 향후 수정사항을 준비할 수 있습니다.
    • 검토 중인 버전에 대한 변경사항을 잠급니다.
    • 검토 중인 버전의 읽기 전용 세부정보를 보거나 검토를 취소하려면 검토 중 카드에서 옵션 더보기(⋮) 버튼을 선택하고 앱 세부정보 보기 또는 검토 취소를 선택합니다.

  3. Google에서 검토를 완료하면 알림이 전송되고 출시 카드가 업데이트됩니다.

    • 문제가 발견된 경우: 출시 카드에 발견된 문제가 표시됩니다. 문제 보기를 선택하여 구체적인 검토 결과를 확인합니다. 수정 가능한 프리뷰 버전에서 구성 또는 MCP 서버를 업데이트하고, 테스터와 함께 수정사항을 확인한 후 검토를 위해 전송을 다시 선택합니다.
    • 승인된 경우: 버전 카드에 게시 준비 완료가 표시됩니다. 연결된 앱을 사용자에게 출시할 준비가 되면 게시를 선택합니다.

축하합니다. 이제 연결된 앱이 게시되었으며 선택한 Google 제품 전반에서 사용자에게 출시됩니다.

게시 후 및 지속적인 버전 관리

게시되면 출시 아래의 하단 카드에 연결된 앱의 서비스 중인 버전 번호, 발행일, 타겟팅된 국가/지역, 언어, 제품 수와 함께 게시됨이 표시됩니다. 언제든지 게시됨 카드에서 옵션 더보기(⋮) 메뉴를 선택하고 앱 세부정보 보기를 선택하여 라이브 버전의 읽기 전용 구성을 검사할 수 있습니다.

게시된 버전이 프로덕션에서 계속 게시되는 동안 왼쪽의 연결된 앱 수정 및 테스트 패널을 사용하거나(초안이 없는 경우 새 버전 만들기 선택) 새 버전(Version <N+1>)의 업데이트를 검토 및 게시를 위해 전송하기 전에 독립적으로 구성, 미리보기, 테스트할 수 있습니다.