GWC Bridge를 Gemini에 수동으로 연결하기

GWC Bridge를 Gemini에 연결하면 본인의 PC에서 허용한 파일과 명령을 Gemini에서 다룰 수 있습니다.

화면 레이블 안내: 따옴표로 표시된 레이블은 Google의 현재 공식 영어 문서를 따릅니다. Google의 기능 배포에 따라 실제 인터페이스는 다를 수 있습니다. GWC Bridge를 사용하면 GWC for VS Code 또는 GWC Studio가 실행 중인 본인의 PC에서 Gemini가 허용된 파일과 명령을 다룰 수 있습니다. 사용자 지정 MCP 서버를 추가한다고 해서 Google이 GWC Bridge를 검토하거나 보증했다는 뜻은 아닙니다.

1. 사용할 수 있는 경로

Gemini: 프로젝트의 관리형 조직 정책에서 사용자 지정 MCP 커넥터를 허용한 후 관리자가 Custom MCP Server 데이터 스토어를 추가할 수 있습니다. Google은 데이터 스토어를 생성하는 관리자에게 Discovery Engine Editor 역할을 요구하며, VPC Service Controls 또는 관리형 정책 강제 적용이 활성화된 경우 추가 이그레스(송신) 및 데이터 소스 정책 변경이 필요할 수 있습니다.^[1]^[2]

Gemini CLI: GWC Bridge는 현재 이 경로를 지원하지 않습니다. 정적 Gemini CLI OAuth 클라이언트를 구성하지 마세요.

일반 사용자용 Gemini 맞춤 앱: 현재 Google은 맞춤 앱을 만 18세 이상, 미국 거주, 개인 Google Account로 로그인, “Keep Activity”(활동 기록 보관) 켜짐, 그리고 이 기능의 언어를 영어로 사용하는 적격 사용자로 제한하고 있습니다. 설정은 Gemini 웹 앱에서 시작됩니다.^[4] 이 일반 사용자용 흐름에서는 아직 GWC Bridge가 활성화되어 있지 않습니다. Google은 서버가 동적 클라이언트 등록(Dynamic Client Registration)을 지원하지 않을 때 “Advanced features”(고급 기능)에서 자격 증명을 입력하도록 안내하지만, 현재 도움말 페이지에는 GWC가 허용 목록에 등록해야 할 콜백 URI가 공개되어 있지 않습니다. GWC는 이를 추측하거나 와일드카드 리디렉션을 허용하지 않습니다.

2. 시작하기 전에

GWC 계정과 활성 상태의 Connect Pass를 준비하고, Gemini가 사용할 PC에서 GWC for VS Code 또는 GWC Studio를 실행해 연결해 두세요.
OAuth 창이 열리면 동일한 GWC 계정으로 로그인하세요. MCP URL을 추가해도 PC 구성 요소가 설치되거나 시작되지는 않습니다.
해당 PC에서 공개할 파일, 폴더, 명령 권한을 검토하고, 처음에는 필요한 최소한의 액세스만 허용하세요.
GWC Bridge는 자체 계정, 권한 부여(그랜트), 폴더, 리소스, 승인 및 명령 정책을 그대로 적용합니다. GWC가 거부한 액세스 권한을 Gemini가 스스로 부여할 수는 없습니다.

3. 서버 주소와 OAuth

다음 MCP 서버 주소를 사용하세요.

https://mcp.gwc-corp.com/mcp

GWC의 OAuth 엔드포인트는 다음과 같습니다.

Authorization URL: https://api.gwc-corp.com/oauth/authorize
Token URL:         https://api.gwc-corp.com/oauth/token
Issuer:            https://api.gwc-corp.com

지원되는 Gemini 경로는 Authorization Code와 PKCE S256을 사용합니다. 정적 클라이언트 ID는 Google의 정확한 호스팅 콜백에 바인딩된 공개 식별자입니다. GWC Bridge는 현재 Gemini CLI OAuth 클라이언트를 등록하지 않습니다.

4. Gemini 관리자 설정

Google은 Custom MCP Server 구성을 조직 전체의 관리자 작업으로 취급합니다.^[1]

Google Cloud에서 Gemini 앱을 소유한 프로젝트를 선택합니다.
Organization Policies(조직 정책)를 열고 Disable custom MCP server connector for Gemini Enterprise(constraints/discoveryengine.managed.disableCustomMcpServerConnector)를 찾습니다. 이 프로젝트에 대해 상위 정책을 재정의(Override)하고 적용(Enforcement)을 Off로 설정합니다. 조직의 의도적인 거버넌스 결정이 아닌 한 더 넓은 조직 범위에서 정책을 비활성화하지 마세요.^[2]
프로젝트가 VPC Service Controls로 보호되고 있거나 관련 관리형 커넥터 정책이 이 프로젝트에 적용되는 경우, 데이터 소스로 custom_mcp를 허용하고 mcp.gwc-corp.com 및 api.gwc-corp.com 모두에 대한 이그레스를 허용합니다.^[1]^[5]
데이터 스토어를 생성하는 관리자에게 필수 역할인 Discovery Engine Editor(roles/discoveryengine.editor)를 부여합니다.^[1]
Gemini Enterprise → Data stores → Create data store → Custom MCP Server → Add MCP server를 엽니다.
OAuth 2.0을 선택하고 다음 값을 입력합니다.

필드	값
MCP Server URL	`https://mcp.gwc-corp.com/mcp`
Authorization URL	`https://api.gwc-corp.com/oauth/authorize`
Authorization URL Parameters	비워 둠(Leave blank)
Token URL	`https://api.gwc-corp.com/oauth/token`
Client ID	`gwc-google-gemini-v1`
Client Secret	`none`
Scopes	`files:read files:write commands:run`
Enable PKCE Support	On
Use HTTP Basic	Off

Gemini MCP 앱에 대한 Google Cloud의 현재 예제에서도 마찬가지로 PKCE가 활성화되고 HTTP Basic이 선택 해제되어 있습니다.^[7]

이 커넥터에 대해 Google이 문서화한 리디렉션 URI는 정확히 https://vertexaisearch.cloud.google.com/oauth-redirect입니다. GWC 클라이언트 프로필은 해당 URI만 허용하며 하위 경로, 대체 호스트 또는 와일드카드는 허용하지 않습니다.^[1] none 값은 공유 비밀이 아닙니다. PKCE 공개 클라이언트에 대해 양식에서 Client Secret 필드를 요구할 때 Google 자체 Looker MCP 안내에서도 동일한 리터럴 값 none을 사용합니다.^[6]

Verify Auth(인증 확인)를 클릭하고 GWC에 로그인한 뒤, 요청된 GWC 권한을 검토하고 계정과 대상이 올바른 경우에만 승인합니다.
데이터 스토어 생성을 완료하고 상태가 Active가 될 때까지 기다립니다.
데이터 스토어의 Actions(작업) 보기를 열고 필요한 경우 사용자 지정 작업을 다시 로드한 다음, Gemini가 사용하도록 허용할 GWC Bridge 도구만 활성화합니다. Google은 기본적으로 사용자 지정 MCP 작업을 비활성화합니다.^[1]
사용할 Gemini 앱에 데이터 스토어를 연결한 뒤, 읽기 전용 첫 확인을 실행합니다: Use GWC Bridge to show which of my computers and shared folders are available. Do not change files or run commands.

5. Gemini CLI

Gemini CLI는 원격 MCP 서버에 연결할 수 있지만 GWC Bridge는 현재 Gemini CLI OAuth 클라이언트를 활성화하지 않습니다. Gemini CLI에 GWC Bridge OAuth 프로필을 추가하지 마세요. GWC가 별도로 검토된 클라이언트 식별 방식을 게시할 때까지 이 경로는 지원되지 않습니다.

6. 일반 사용자용 Gemini 맞춤 앱

Google의 일반 사용자용 Gemini Apps 도움말에 따르면 적격 사용자는 Settings → Connected Apps(설정 → 연결된 앱)를 열고 MCP 서버 URL로 맞춤 앱을 추가한 뒤, 서버가 동적 클라이언트 등록을 지원하지 않는 경우 Advanced features(고급 기능)를 열어 자격 증명을 입력할 수 있습니다.^[4]

현재로서는 그곳에 GWC의 정적 Client ID 중 어느 것도 입력하지 마세요. 현재 Google 도움말 페이지에는 일반 사용자용 맞춤 앱의 OAuth 콜백 URI가 문서화되어 있지 않으며, GWC에는 동적 클라이언트 등록 엔드포인트가 없습니다. Enterprise 콜백이나 CLI 루프백 콜백을 재사용하는 것은 올바르지 않으며, 와일드카드를 허용하면 OAuth 리디렉션 바인딩이 약화됩니다.

이 경로는 다음 조건 중 적어도 하나가 충족된 후에만 지원될 수 있습니다.

Google이 GWC가 전용 공개 Client ID에 바인딩할 수 있는 안정적이고 정확한 일반 사용자용 콜백 URI를 공개하거나,
GWC가 Gemini의 클라이언트 등록 흐름을 충족하는 동적 클라이언트 등록을 구현하고 보안 검토를 완료하는 경우.

그전까지 이 가이드에서 지원되는 고객 경로는 Gemini뿐입니다.

7. Gemini가 볼 수 있는 것과 연결 해제 방법

Gemini가 GWC Bridge 도구를 호출할 때 도구 결과에는 파일 이름, 파일 내용, 명령 출력, 기기 레이블 또는 권한이 부여된 도구가 반환하는 기타 데이터가 포함될 수 있습니다. 해당 내용은 사용자의 PC를 떠나 사용자가 선택한 Gemini 환경에서 처리됩니다. Google은 타사 사용자 지정 MCP 서버가 Google의 통제 범위 밖에 있음을 명시하며 신뢰할 수 있는 서버만 연결할 것을 권장합니다.^[4]

GWC Bridge 권한은 계속해서 최종적인 기준이 됩니다.

파일 읽기는 활성 GWC Bridge 연결에 공유된 폴더로 제한됩니다.
파일 변경은 연결 및 폴더에서 변경을 허용해야 하며 보호된 작업 확인을 통과해야 합니다.
명령 실행은 연결에서 Commands를 허용해야 하며 승인이 추가로 필요할 수 있습니다.
승인한 것과 다른 PC, 다른 계정 또는 취소된 권한 부여(그랜트)는 상호 대체될 수 없습니다.

연결을 해제하려면:

Gemini: 관리자가 조직 정책에 따라 작업을 비활성화하거나, 앱에서 데이터 스토어 연결을 해제하거나, 사용자 지정 MCP 데이터 스토어를 제거할 수 있습니다.
Gemini CLI: GWC OAuth 클라이언트가 활성화되어 있지 않습니다. 인증을 시도하지 말고 실험적인 GWC Bridge OAuth 프로필을 제거하세요.
GWC에서 기본 Bridge 권한 부여(그랜트)를 취소하면 Gemini 측 구성과 관계없이 액세스가 즉시 무효화됩니다.

8. 문제 해결

증상	확인할 사항
Gemini CLI OAuth를 시도함	중지하세요. GWC Bridge는 현재 Gemini CLI OAuth를 지원하지 않습니다.
Gemini에서 Custom MCP Server가 차단되었다고 표시됨	프로젝트 수준 관리형 제약 조건인 Disable custom MCP server connector for Gemini Enterprise가 Off로 재정의되었는지 확인하세요. VPC Service Controls 또는 관리형 강제 적용이 활성화된 경우 `custom_mcp`와 필요한 이그레스 FQDN도 허용하세요.
Verify Auth에서 잘못된 리디렉션 오류를 보고함	Client ID가 정확히 `gwc-google-gemini-v1`인지 확인하세요. GWC는 해당 클라이언트에 대해 Google이 문서화한 `https://vertexaisearch.cloud.google.com/oauth-redirect`만 허용합니다.
Verify Auth에서 잘못된 클라이언트 시크릿 오류를 보고함	정확히 `none`을 입력하고 PKCE를 활성화한 뒤 Use HTTP Basic을 끈 상태로 두세요. GWC는 이 값을 해당 공개 클라이언트에 대한 Google 양식의 필수 자리 표시자로만 취급하며, 다른 모든 시크릿은 거부합니다.
인증 요청이 즉시 실패함	GWC에서 Gemini 수동 OAuth를 활성화했는지 확인하세요. 서버 측 호환성 플래그는 기본적으로 꺼져 있습니다.
Gemini가 서버나 OAuth 엔드포인트에 연결할 수 없음	이그레스 제어가 적용되는 경우 `mcp.gwc-corp.com`과 `api.gwc-corp.com`을 모두 허용하세요. HTTPS URL이 정확한지 다시 확인하세요.
데이터 스토어는 Active 상태이지만 Gemini가 도구를 호출하지 않음	사용자 지정 MCP 작업은 기본적으로 비활성화되어 있습니다. 사용할 작업을 활성화하고 데이터 스토어를 대상 Gemini 앱에 연결하세요.

| 로그인은 성공했지만 GWC가 액세스를 거부함 | GWC 계정과 활성 Connect Pass를 확인한 다음 Bridge 권한 부여(그랜트)와 PC 권한을 점검하세요. 상태를 변경하는 도구를 무작정 재시도하지 마세요. | | PC 또는 폴더를 사용할 수 없음 | 대상 PC가 온라인 상태이고, GWC Studio 또는 GWC for VS Code가 실행 중이며 연결되어 있고, 해당 폴더가 이 연결에 공유되어 있는지 확인하세요. | | 읽기는 작동하지만 편집이나 명령 실행에 실패함 | GWC Bridge의 Change files / Commands 권한과 승인 프롬프트를 확인하세요. 거부는 정책 경계에 따른 것이며 인증 실패의 증거가 아닙니다. | | 일반 사용자용 Gemini 맞춤 앱에서 자격 증명을 요구함 | Enterprise 또는 CLI용 Client ID를 사용하지 마세요. 현재 일반 사용자용 콜백 URI가 문서화되어 있지 않으므로 GWC는 의도적으로 이 경로를 거부합니다. |

GWC 지원팀에 문의할 때는 사용 중인 Gemini 환경(Enterprise 또는 CLI), 설정 단계 및 정확한 오류 메시지를 함께 알려 주세요. 비밀번호, Bearer 토큰, 비공개 파일 내용 또는 실제 클라이언트 시크릿은 절대 보내지 마세요.

9. 공식 참고 자료

공급업체 절차는 2026-10-22 (Asia/Singapore)에 Google의 현재 공식 영어 문서와 대조하여 확인했습니다.