연결된 앱 사용을 위한 기본 요건

시작하기 전에 다음 항목이 있는지 확인하세요.

  • 보안 HTTPS 엔드포인트가 있는 배포된 MCP 서버

    MCP 서버는 스트리밍 가능한 HTTP 전송(예: https://api.yourdomain.com/v1/mcp)을 사용하여 HTTPS를 통해 공개적으로 연결할 수 있어야 합니다.

    구현 세부정보는 연결된 앱 플랫폼 MCP 서버 개발자 가이드를 참고하세요.

  • 서버가 Google의 요청을 수신할 수 있는지 확인하기

    서버에서 소스 IP로 외부 액세스를 제한하는 경우 다음 IP 주소를 허용 목록에 추가합니다.

    • 108.177.64.0/20
    • 142.250.88.0/22
    • 172.217.80.0/20
    • 192.178.20.0/22
    • 192.179.0.0/20
    • 74.125.232.0/24
    • 136.121.40.0/21

    Google의 아웃바운드 IP 범위는 시간이 지남에 따라 변경될 수 있으므로 Google의 게시된 목록에서 읽고 허용 목록을 정기적으로 새로고침하는 것이 좋습니다.

  • Google Connected Console에 등록된 개발자 계정에 액세스

    로그인한 후 Google Connected Console에 다음 연결된 앱 권한 중 하나가 있는지 확인합니다.

    • 연결된 앱 보기
    • 연결된 앱 만들기 및 관리

    계정 소유자 또는 관리자가 연결된 앱 서비스 약관에 동의해야 합니다. 조직에서 Google Connected Console의 연결된 앱에 처음 액세스하는 경우, 초대된 팀원이 진행하기 전에 계정 소유자 또는 관리자가 로그인하여 프로그램 계약에 동의해야 합니다.

    액세스 권한이 있다고 생각되지만 연결된 앱을 만들 수 없는 경우 계정 소유자 또는 관리자에게 사용자 및 권한 페이지에서 사용자 계정에 '연결된 앱 보기' 또는 '연결된 앱 만들기 및 관리' 권한을 부여해 달라고 요청하세요.

  • MCP 서버 도메인에서 .well-known 인증 파일을 호스팅하는 기능

    도메인 소유권을 확인하려면 https://<your-domain>/.well-known/google-connected-apps에서 JSON 챌린지 토큰 파일을 직접(HTTP 200 OK 사용, 리디렉션 없음) 제공할 수 있어야 합니다.

  • 사용 가능한 연결된 앱 카테고리 검토하기

    연결된 앱의 카테고리는 고품질 사용자 경험을 보장하기 위해 지원해야 하는 특정 기능과 연결됩니다. 연결된 앱의 카테고리를 선택한 후에는 변경할 수 없습니다. 자세히 알아보기

  • 유효한 엔드포인트 URL이 있는 배포된 MCP 서버

    자세한 내용은 연결된 앱 MCP 서버 개발자 가이드를 참고하세요.

  • 연결된 앱의 공개 메타데이터 및 브랜드 애셋

    • 연결된 앱 이름: Google 제품 전반에서 사용자에게 표시되는 연결된 앱의 표시 이름이며, 사용자가 @로 앱을 멘션할 때 사용됩니다.
    • 설명: 연결된 앱이 사용자를 위해 할 수 있는 작업을 간결하게 한 문장으로 요약한 내용(30단어 미만)입니다(예: '최근 구매 내역을 추적하고 배송 상태를 확인하고 주문 내역을 확인하세요').
    • 아이콘: JPEG 또는 PNG 형식의 512px × 512px 앱 아이콘으로, 최대 파일 크기는 1MB(1,024KB)입니다.
    • 기능: 연결된 앱이 수행할 수 있는 가치가 높은 작업이 최소 3개 이상이어야 합니다(예: '주문 내역 검색' 또는 '실시간 배송 상태 확인'). 이러한 작업은 앱 카테고리에 정의된 기본 기능 외의 작업이어야 합니다. 사용자가 연결 여부를 결정하는 데 도움을 주기 위해 이 정보가 사용자에게 표시됩니다. 기능 시작 부분에 숫자를 포함하지 마세요.
    • 예시 프롬프트: 사용자가 무엇을 물어볼 수 있는지 이해하는 데 도움이 되는 샘플 질문이 3개 이상 있어야 합니다. 연결된 앱의 이름으로 시작하는 예시 프롬프트를 2개 이상 작성합니다. 하나 이상의 프롬프트에서 앱 이름을 자연스럽게 언급합니다(즉, 앱 이름으로 시작하지 않음). 예시 프롬프트 시작 부분에 숫자를 포함하지 마세요.
    • 서비스 약관 URL: 연결된 앱의 서비스 약관에 대한 공개적으로 액세스 가능한 URL입니다.
    • 개인정보처리방침 URL: 연결된 앱의 개인정보처리방침에 공개적으로 액세스할 수 있는 URL입니다.
    • 웹사이트 URL(선택사항): 연결된 앱의 웹사이트입니다.