본문으로 건너뛰기

Gemini CLI 연결

2026년 9월 29일 공급업체 문서와 대조함, 엔드투엔드 테스트 전

아래 절차는 Gemini CLI 문서 "MCP servers with the Gemini CLI"를 따릅니다. 저희가 Gemini CLI에서 NameBeta 로그인까지 직접 해 보지는 않았습니다.

시작하기 전에​

  • Gemini CLI
  • NameBeta 계정. 계정이 없으면 설정 중에 로그인 페이지에서 만들 수 있습니다.
  • 사전 등록된 클라이언트 ID. Gemini CLI는 OAuth 서버에 자신을 등록할 때 동적 클라이언트 등록(DCR)만 사용하는데, NameBeta는 DCR을 제공하지 않습니다. 또한 Gemini CLI 문서에는 Client ID Metadata Documents가 언급되어 있지 않으며, 메인테이너들은 CIMD 지원 요청을 추가 계획 없이 종료했습니다. 사전 등록된 클라이언트 ID에 설명된 방법으로 클라이언트 ID를 요청하세요. 이때 클라이언트 이름으로 Gemini CLI를, 리디렉션 URI로 http://localhost:7777/oauth/callback을 알려 주세요.

서버 추가​

Gemini CLI는 settings.json에서 MCP 서버를 읽습니다.

파일적용 범위
~/.gemini/settings.json모든 프로젝트
.gemini/settings.json현재 프로젝트

mcpServers 아래에 namebeta 항목을 추가하고 발급받은 클라이언트 ID를 넣습니다.

{
    "mcpServers": {
        "namebeta": {
            "httpUrl": "https://namebeta.com/api/mcp",
            "oauth": {
                "enabled": true,
                "clientId": "<client ID>",
                "redirectUri": "http://localhost:7777/oauth/callback"
            }
        }
    }
}
  • httpUrl을 쓰면 Streamable HTTP 전송 방식이 선택됩니다. url을 쓰면 SSE가 선택됩니다.
  • redirectUri는 포트를 고정합니다. 이 값이 없으면 Gemini CLI가 임의의 포트를 사용하므로, 클라이언트 ID에 등록된 리디렉션 URI와 맞지 않게 됩니다. 컴퓨터에서 7777 포트를 이미 사용 중이라면 클라이언트 ID를 요청할 때 다른 포트를 알려 주세요.

로그인​

  1. Gemini CLI를 시작하고 /mcp auth namebeta를 실행합니다. 브라우저에서 NameBeta 로그인 페이지가 열립니다.
  2. 로그인하고 액세스를 승인한 다음 터미널로 돌아갑니다.

이제 gemini mcp list를 실행하면 서버가 연결된 것으로 표시됩니다.

✓ namebeta: https://namebeta.com/api/mcp (http) - Connected

사용해 보기​

brewlab으로 아직 등록할 수 있는 TLD는 어떤 것이 있나요? 이미 등록된 것 중에서 판매 중인 것은요?

Gemini CLI가 check_availability를 실행합니다. 답변에는 등록됨, 판매 중, 등록 가능 상태의 도메인이 섞여 있어야 합니다. 2026년 9월 29일의 결과는 도구 예시에서 볼 수 있습니다.

연결 해제 및 계정 전환​

  • gemini mcp remove namebeta는 프로젝트 구성에서 서버를 제거합니다. ~/.gemini/settings.json에 추가했다면 -s user를 덧붙입니다.
  • 다른 NameBeta 계정을 사용하려면 계정 전환을 참조한 다음 /mcp auth namebeta를 다시 실행합니다.

연결되지 않을 때​

Gemini CLI에서 /mcp list를 실행해 서버 오류를 확인한 다음 문제 해결을 참조하세요.

최종 수정: 에