Gemini에 연결하기

Bridger는 Gemini CLI(개발자용 터미널 도구)와 Gemini Enterprise(조직용)에서 MCP 서버로 연결할 수 있습니다.

소비자용 Gemini 앱(gemini.google.com 웹 · 모바일 앱)은 연결 대상이 아닙니다. 앱의 커스텀 MCP 연결(“Custom apps for Spark”)은 미국 · 영어 환경의 개인 계정에만 제공되는 기능이라 한국 계정에서는 메뉴가 나타나지 않습니다. 한국에서는 아래 Gemini CLI 또는 Gemini Enterprise 경로를 사용하세요.

Gemini CLI

~/.gemini/settings.json에 MCP 서버를 등록합니다.

~/.gemini/settings.json

{
  "mcpServers": {
    "bridger": {
      "httpUrl": "https://mcp.bridger.kr/mcp"
    }
  }
}

또는 명령 한 줄로 등록할 수도 있습니다.

gemini mcp add --transport http bridger https://mcp.bridger.kr/mcp

첫 사용 시 브라우저가 열리며 Bridger 로그인(Google · GitHub)과 권한 동의가 진행됩니다. CLI 안에서 /mcp를 입력하면 서버 연결 상태와 인증 메뉴를 확인할 수 있습니다.

CLI 확장 한 줄 설치는 준비 중입니다. 공개되면 gemini extensions install https://github.com/bridger-kr/bridger-gemini-extension 한 줄로 설치할 수 있습니다. 지금은 위 settings.json 방식을 사용하세요.

Gemini Enterprise

조직의 Gemini Enterprise에서는 관리자가 커스텀 MCP 커넥터를 등록합니다. 커넥터 설정 화면에 다음 값을 입력하세요.

입력 항목	값
MCP server URL	`https://mcp.bridger.kr/mcp`
Transport	Streamable HTTP
Authorization URL	`https://api.bridger.kr/oauth/authorize`
Token URL	`https://api.bridger.kr/oauth/token`
Client ID / Client secret	Bridger에 발급 요청 (hello@bridger.kr)
Scopes (공백 구분)	`tools:read tools:execute offline_access`
PKCE	활성화 — Bridger는 S256만 허용
Redirect URI	`https://vertexaisearch.cloud.google.com/oauth-redirect` (Google 고정 값)

Gemini Enterprise는 동적 클라이언트 등록(DCR)을 지원하지 않아, 사전 등록된 만료 없는 confidential client가 필요합니다. 위 리다이렉트 URI로 발급을 요청해 주시면 Bridger에서 Client ID · secret을 발급해 드립니다. secret은 한 번만 전달되니 안전하게 보관하세요.

스코프	의미
`tools:read`	도구 목록 조회(`tools/list`)
`tools:execute`	도구 실행(`tools/call`)
`offline_access`	리프레시 토큰 발급 — 장기 연결 유지

Gemini Enterprise는 커넥터당 활성화할 수 있는 액션이 최대 100개입니다. Bridger는 Gemini Enterprise 연결에서 도구 목록을 100개 이내로 맞춰 내려주므로 상한을 넘지 않습니다. 저장 후 커넥터의 Actions 목록에서 사용할 액션을 켜 주세요.

문제 해결

Gemini CLI에서 서버가 안 보여요

~/.gemini/settings.json의 JSON 형식과 mcpServers 키 위치를 확인하고, gemini mcp list로 등록 여부를 확인하세요.

인증 브라우저가 열리지 않아요

CLI에서 /mcp → bridger 선택 후 인증을 다시 시도하세요. 헤드리스 환경이라면 브라우저가 있는 환경에서 설정 파일을 만든 뒤 사용하세요.

Enterprise 승인이 invalid_redirect_uri / invalid_target으로 실패해요

발급받은 클라이언트의 리다이렉트가 https://vertexaisearch.cloud.google.com/oauth-redirect와 정확히 일치하는지 확인하세요. resource 값은 생략해도 되며, 보낸다면 https://mcp.bridger.kr/mcp와 정확히 일치해야 합니다.

Enterprise에서 PKCE 오류가 나요

커넥터 설정에서 PKCE를 켜고 방식을 S256으로 지정하세요. plain 방식이나 PKCE 생략은 지원되지 않습니다.

어떤 도구는 실행이 안 돼요

일부 공공데이터 API는 내 인증키(서비스키)가 필요합니다. 대시보드에서 해당 기관의 **내 인증키(서비스키)**를 등록하면 사용할 수 있습니다.

그래도 해결이 안 되면

hello@bridger.kr 또는 채널톡으로 문의해 주세요.

시작하기

가이드

개념

Gemini에 연결하기

Gemini CLI

Gemini Enterprise

문제 해결

​Gemini CLI

​Gemini Enterprise

​문제 해결

Gemini CLI

Gemini Enterprise

문제 해결