> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bridger.kr/llms.txt
> Use this file to discover all available pages before exploring further.

# Gemini에 연결하기

> Gemini CLI와 Gemini Enterprise에서 Bridger MCP를 사용하는 방법.

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

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

## Gemini CLI

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

```json ~/.gemini/settings.json theme={null}
{
  "mcpServers": {
    "bridger": {
      "httpUrl": "https://mcp.bridger.kr/mcp"
    }
  }
}
```

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

```bash theme={null}
gemini mcp add --transport http bridger https://mcp.bridger.kr/mcp
```

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

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

## 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](mailto:hello@bridger.kr)) |
| Scopes (공백 구분) | `tools:read tools:execute offline_access` |
| PKCE | 활성화 — Bridger는 **S256**만 허용 |
| Redirect URI | `https://vertexaisearch.cloud.google.com/oauth-redirect` (Google 고정 값) |

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

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

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

## 문제 해결

<AccordionGroup>
  <Accordion title="Gemini CLI에서 서버가 안 보여요">
    `~/.gemini/settings.json`의 JSON 형식과 `mcpServers` 키 위치를 확인하고,
    `gemini mcp list`로 등록 여부를 확인하세요.
  </Accordion>

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

  <Accordion title="Enterprise 승인이 invalid_redirect_uri / invalid_target으로 실패해요">
    발급받은 클라이언트의 리다이렉트가 `https://vertexaisearch.cloud.google.com/oauth-redirect`와
    정확히 일치하는지 확인하세요. `resource` 값은 생략해도 되며, 보낸다면
    `https://mcp.bridger.kr/mcp`와 정확히 일치해야 합니다.
  </Accordion>

  <Accordion title="Enterprise에서 PKCE 오류가 나요">
    커넥터 설정에서 PKCE를 켜고 방식을 `S256`으로 지정하세요. plain 방식이나 PKCE 생략은
    지원되지 않습니다.
  </Accordion>

  <Accordion title="어떤 도구는 실행이 안 돼요">
    일부 공공데이터 API는 내 인증키(서비스키)가 필요합니다. [대시보드](https://portal.bridger.kr)에서
    해당 기관의 \*\*내 인증키(서비스키)\*\*를 등록하면 사용할 수 있습니다.
  </Accordion>

  <Accordion title="그래도 해결이 안 되면">
    [hello@bridger.kr](mailto:hello@bridger.kr) 또는 채널톡으로 문의해 주세요.
  </Accordion>
</AccordionGroup>