Tutorial/Gemini CLIと為替

Gemini CLIでMCP経由の為替レートを使う

Gemini CLIをexchangerate.devにStreamable HTTPで接続し、RESTクライアントを書かずにUSD/JPYやUSD/KRWのレートを取得します。

ERexchangerate.dev·Sep 5, 2026·6分で読了

Gemini CLIはセッション中にMCPサーバーを呼び出せます。このガイドでは、まず認証なしで接続を確認し、必要なら環境変数からAPIキーを渡します。レートは参考・分析用のインディケーティブ値であり、決済や取引の価格ではありません。

Key points
Gemini CLIは公式インストール手順に従い、プロンプトや設定にAPIキーを貼り付けません。
リモートMCPサーバーは.gemini/settings.jsonhttpUrlで設定します。
list_currenciesget_rateconvertget_rangesearch_docs、人の確認が必要なstart_checkoutを利用できます。
まず認証なしで試し、継続利用時だけEXCHANGERATE_API_KEYを環境変数で渡します。
確認プロンプトを有効にし、未確認のプロジェクトで--yoloを使いません。

Gemini CLIをインストールする

公式インストール手順を使ってください。パッケージマネージャーやコマンドは変わるため、古いグローバルインストール例をそのまま使わないでください。

まず認証なしで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 listで確認します。シェルではgemini mcp listも使えます。未信頼フォルダーのためDisabledと表示される場合は、自分のプロジェクトについて通常の信頼確認を行います。信頼チェック自体は無効にしません。start_checkoutは明示的な人の確認後だけ請求処理を開始します。

Gemini CLI・確認プロンプト
exchangerate MCPサーバーのlist_currenciesツールを使ってください。
JPYとKRWが対応しているか答え、その後は停止してください。
請求やチェックアウトのツールは呼び出さないでください。

USD/JPYとUSD/KRWを問い合わせる

通貨ペア、方向、観測時刻をプロンプトに明記します。タイムスタンプ、sourcemarket_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は制限到達を示します。無限リトライや値の創作は避けてください。MCPのデータツール呼び出しはAPIクォータを消費します。

確認プロンプトを有効にする
ツール呼び出し、特に請求操作の前にGemini CLIの確認を読みます。標準の承認フローを有効にしてください。

Gemini CLIとGeminiの一般向けチャットを混同しない

これはGoogleのターミナルエージェントGemini CLI向けの設定です。Geminiのウェブ版・モバイル版の設定ではありません。

仕様を確認する

MCPセットアップハブと、Gemini CLI公式MCPドキュメントで設定、環境変数、確認動作を確認してください。

ER
exchangerate.dev
開発者向けの連携ガイド。

関連記事

GuideLLMエージェントにライブ為替を渡す読む GuideGoogle Sheetsで為替を使う読む ReferenceUSD/JPY為替レート読む
他の比較Fixer vs exchangerate.devOpen Exchange Rates vs exchangerate.devCurrencylayer vs exchangerate.dev
学ぶReading source and market_session in your pipelineIndicative vs executable FX rates: what a rates API actually gives youECB参照レートの解説
ライブレートEUR/USDGBP/USDUSD/JPY