기준 연결 · OPT-05

Gemini CLI 에 연결하기

Claude Desktop 과 같은 서버를 그대로 씁니다. 서버를 따로 만들 필요가 없고, 설정 파일의 위치와 이름만 다릅니다. command · args 형식은 같습니다.

01

저장소와 파이썬 환경을 준비합니다

Claude Desktop 쪽과 같습니다. 이미 해 두셨다면 그대로 씁니다.

02

설정 파일을 엽니다

전역으로 쓸지 프로젝트에서만 쓸지 골라 씁니다.

전역~/.gemini/settings.json
프로젝트<프로젝트>/.gemini/settings.json

명령으로 넣어도 됩니다 — gemini mcp add Optra-kds /경로/optra/.venv/bin/python3 /경로/optra/server/server.py

03

서버를 등록합니다

{
  "mcpServers": {
    "Optra-kds": {
      "command": "/경로/optra/.venv/bin/python3",
      "args": ["/경로/optra/server/server.py"]
    }
  }
}

Windows 에서는 명령을 cmd 로 감쌉니다 — "command": "cmd", "args": ["/c", "...python.exe", "...server.py"]

04

Gemini CLI 를 다시 시작합니다

다시 켜면 등록된 서버를 자동으로 띄웁니다. /mcp 로 붙은 도구를 확인할 수 있습니다.

기준을 다시 빌드했으면 서버도 다시 시작합니다

서버는 뜰 때 조문 캐시를 한 번만 읽습니다. 캐시를 다시 만든 뒤에는 CLI 를 재시작해야 새 내용이 반영됩니다.

기준 연결 개요로