Gemini CLI에서 원격 MCP 서버를 사용할 수 있나요?

네. `httpUrl`로 Streamable HTTP 엔드포인트를 설정할 수 있습니다. 먼저 키 없이 연결을 확인하고 정기 사용에는 환경 변수 Bearer 키를 사용하세요.

이 환율을 결제에 사용할 수 있나요?

아니요. 참고·분석용 인디케이티브 값입니다. timestamp, source, market_session도 함께 보존하세요.

Tutorial/Gemini CLI와 환율

MCP로 Gemini CLI에서 실시간 환율 사용하기

Gemini CLI를 Streamable HTTP로 exchangerate.dev에 연결해 REST 클라이언트를 작성하지 않고 USD/JPY와 USD/KRW 환율을 조회합니다.

ERexchangerate.dev·Sep 5, 2026·6분 읽기

Gemini CLI는 세션 중 MCP 서버를 호출할 수 있습니다. 먼저 익명 연결을 확인한 뒤 필요할 때만 환경 변수로 API 키를 전달합니다. 환율은 참고·분석용 인디케이티브 값이며 결제나 거래 가격이 아닙니다.

Key points

Gemini CLI는 공식 설치 안내를 따르고 프롬프트나 설정에 API 키를 붙여 넣지 않습니다.

원격 MCP 서버는 .gemini/settings.json의 httpUrl로 설정합니다.

list_currencies, get_rate, convert, get_range, search_docs와 사람 확인이 필요한 start_checkout을 제공합니다.

먼저 키 없이 시험하고 정기 사용 때만 EXCHANGERATE_API_KEY를 환경 변수로 사용합니다.

확인 프롬프트를 유지하고 검토하지 않은 프로젝트에서는 --yolo를 사용하지 않습니다.

Gemini CLI 설치하기

공식 설치 안내를 따르세요. 패키지 관리자와 명령은 바뀔 수 있으므로 오래된 전역 설치 예제를 복사하지 마세요. gemini를 실행하고 로그인 안내를 따르세요. Gemini CLI의 인증과 사용 한도는 exchangerate.dev 키 및 쿼터와 별개입니다.

먼저 익명 MCP 서버 추가하기

Gemini CLI는 프로젝트의 .gemini/settings.json을 읽습니다. 아래 설정을 추가하세요. httpUrl은 원격 Streamable HTTP 설정 필드입니다.

.gemini/settings.json · 익명

{
  "mcpServers": {
    "exchangerate": {
      "httpUrl": "https://api.exchangerate.dev/v1/mcp/"
    }
  }
}

익명 접근으로 실제 라이브 데이터를 먼저 확인할 수 있습니다. 익명 요청에는 IP별 제한이 있습니다.

환경 변수로 키 추가하기

반복 작업에서는 키를 파일이나 프롬프트에 적지 말고 환경 변수 확장을 사용하세요. 셸에서 EXCHANGERATE_API_KEY를 설정한 뒤 Gemini CLI를 시작합니다.

.gemini/settings.json · 키 사용

{
  "mcpServers": {
    "exchangerate": {
      "httpUrl": "https://api.exchangerate.dev/v1/mcp/",
      "headers": {
        "Authorization": "Bearer $EXCHANGERATE_API_KEY"
      }
    }
  }
}

실제 키를 설정 파일, 대화 기록, 저장소에 저장하지 마세요.

연결과 도구 확인하기

Gemini CLI를 시작하고 /mcp로 서버와 도구를 확인하세요. start_checkout은 명시적인 사람 확인 뒤에만 청구 절차를 엽니다. 셸에서는 gemini mcp list도 사용할 수 있습니다. 신뢰하지 않은 폴더라서 Disabled가 표시되면 본인 프로젝트에 대한 일반 신뢰 확인 절차를 따르세요. 신뢰 검사를 전역으로 끄지 마세요.

Gemini CLI · 확인 프롬프트

exchangerate MCP 서버의 list_currencies 도구를 사용하세요.
JPY와 KRW 지원 여부만 답하고 멈추세요.
청구 또는 checkout 도구는 호출하지 마세요.

USD/JPY와 USD/KRW 조회하기

통화쌍, 방향, 관측 시점을 프롬프트에 명시하세요. timestamp, source, market_session을 함께 표시해 참고값과 거래 가격을 구분합니다.

Gemini CLI · 최신 환율과 환산

get_rate에서 base USD, quote JPY를 사용하세요.
환율, timestamp, source, market_session을 표시하세요.
인디케이티브 참고 환율이며 거래 가격이 아니라고 밝혀 주세요.

convert로 2500 USD를 KRW로 환산하세요.
도구가 오류를 반환하면 환율을 추측하지 마세요.

추측 없이 과거 데이터 가져오기

get_range에 base, symbol, ISO 날짜 범위를 명시하세요. 일별 데이터에는 휴장일의 전방 보간 행이 포함될 수 있으므로 내보낼 때 메타데이터를 보존합니다.

Gemini CLI · 과거 데이터

base USD, symbols JPY,KRW로 get_range를 호출하세요.
2026-01-01부터 2026-03-31까지 조회하세요.
도구가 반환한 메타데이터만 보고하고 없는 필드는 없다고 설명하세요. is_forward_filled 행도 확인하세요.
인디케이티브 환율을 결제 가격으로 취급하지 마세요.

오류와 안전 확인 처리하기

연결되지 않으면 /mcp와 CLI 진단 출력을 확인하고 URL과 JSON을 점검하세요. 401/403은 인증 또는 접근 설정 문제이고 429는 한도 도달입니다. 무한 재시도나 값 지어내기를 하지 마세요. 데이터 도구 호출은 API 쿼터를 사용합니다.

확인 프롬프트 유지하기

도구 호출, 특히 청구 작업 전에 Gemini CLI의 확인 내용을 검토하세요. 기본 승인 흐름을 유지하세요.

Gemini CLI와 일반 Gemini 채팅 구분하기

이 설정은 Google의 터미널 에이전트 Gemini CLI용입니다. Gemini 소비자 웹·모바일 앱의 설정이 아닙니다.

계약 문서 읽기

MCP 설정 허브와 Gemini CLI 공식 MCP 문서에서 설정, 환경 변수, 확인 동작을 확인하세요.

exchangerate.dev

개발자를 위한 연동 가이드.