Gemini 에 연결하기 — 되는 곳과 안 되는 곳

Gemini 는 이름이 하나인데 들어가는 자리가 여럿입니다. 그리고 그중 사람들이 제일 먼저 여는 곳에서는 안 됩니다. 그것부터 적습니다.

gemini.google.com 에서는 안 됩니다

브라우저로 여는 Gemini 앱은 개인 계정용 커스텀 MCP 연결을 지원하지 않습니다. 거기서 찾으시면 안 나옵니다 — Optra 가 안 되는 것이 아니라 그 자리에 그 기능이 없습니다.

Spark 커넥터가 있긴 한데 파트너십으로 붙는 방식이라 저희가 스스로 등록할 수 없습니다.

되는 곳은 아래 넷입니다 — Gemini CLI · Antigravity · Code Assist · Gemini Enterprise.

2026-08-27 기준 Google 안내입니다. 저희가 확인한 것이 아니라 바뀔 수 있습니다.

아래는 Gemini CLI 기준입니다. CLI 는 원격 MCP 서버의 인증을 동적 발견으로 처리합니다 — 저희가 내보내는 규격 그대로입니다. 그러면 주소만 등록하고 로그인하면 됩니다. 다만 저희가 직접 붙여 확인하지 못했습니다. 되는 척하지 않고, 아래는 문서에 적힌 대로만 옮깁니다.

01

주소를 등록합니다

설정 파일에 넣거나 gemini mcp add 로 등록합니다. 전역으로 쓸지 프로젝트에서만 쓸지 고를 수 있습니다.

전역~/.gemini/settings.json
프로젝트<프로젝트>/.gemini/settings.json
주소https://mcp.optra.kr/mcp

끝의 /mcp 까지 넣어야 합니다.

이 절차가 안 맞으면 CLI 판을 먼저 보십시오. CLI 확장 갤러리가 2026-06-18 부로 Antigravity CLI 로 넘어가는 중입니다. gemini mcp add 가 없거나 다르게 동작하면 저희 안내가 낡은 것입니다 — 알려 주시면 고치겠습니다.

2026-08-27 기준 Google 안내입니다. 전환 중이라 특히 잘 바뀝니다.

02

Optra 로 로그인하고 허용을 누릅니다

CLI 가 저희 로그인 화면을 엽니다. 이메일 계정이든 소셜 계정이든 같습니다 — 이 인증은 도구와 Optra 사이의 것이라 어떤 수단으로 가입하셨는지는 상관이 없습니다.

동의 화면에서 가장 큰 글자는 권한이 실제로 가는 주소입니다. 그 아래 이름은 요청하는 쪽이 스스로 밝힌 것이고, 주소만 등록된 것과 글자 하나까지 같아야 지나갑니다. 낯설면 거기서 멈추십시오.

03

붙었는지 봅니다

/mcp 로 확인합니다. search_kds 와 get_kds_figure 두 개가 뜨면 된 것입니다.

"KDS 41 12 00 5.7.3 전체 보여줘" 처럼 조문번호로 물으면 하위 항까지 딸려 옵니다. 없는 조문도 한 번 물어 보십시오 — "없습니다" 라고 답하면 제대로 붙은 것입니다.

여기까지가 저희가 확인하지 못한 부분입니다

Claude Desktop 에서는 위와 같은 방식으로 끝까지 붙여 확인했습니다. Gemini CLI 는 규격이 같아 되어야 맞지만, 저희가 해 보지 않았습니다.

해 보시고 되면 — 또는 안 되면 — 알려 주십시오. 이 자리를 고치겠습니다.

회사에서 Gemini Enterprise 를 쓰신다면

Enterprise 는 Streamable HTTP 를 직접 연결할 수 있습니다. Google Cloud Console 에서 custom Data Store connector 로 프로비저닝하는 방식이고, 그 자리에 넣을 주소는 위와 같습니다 — https://mcp.optra.kr/mcp

Enterprise 는 폐기된 SSE 전송을 거부합니다. 저희는 Streamable HTTP 라 해당 없습니다 — 이건 저희 서버라 저희가 확인한 사실입니다.

Enterprise 절차는 2026-08-27 기준 Google 안내입니다. 전송 방식은 저희가 잰 것입니다.

기준 연결 개요로