Gemini CLIはセッション中にMCPサーバーを呼び出せます。このガイドでは、まず認証なしで接続を確認し、必要なら環境変数からAPIキーを渡します。レートは参考・分析用のインディケーティブ値であり、決済や取引の価格ではありません。
- 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をインストールする
公式インストール手順を使ってください。パッケージマネージャーやコマンドは変わるため、古いグローバルインストール例をそのまま使わないでください。
まず認証なしでMCPサーバーを追加する
Gemini CLIはプロジェクトの.gemini/settings.jsonを読み込みます。次の設定を作成してください。httpUrlはリモートStreamable HTTP用の設定項目です。
{ "mcpServers": { "exchangerate": { "httpUrl": "https://api.exchangerate.dev/v1/mcp/" } }}実際のライブデータを匿名アクセスで試せます。匿名アクセスにはIPごとの制限があります。
環境変数でキーを追加する
継続利用ではキーをファイルやプロンプトに書かず、環境変数展開を使います。シェルでEXCHANGERATE_API_KEYを設定してからGemini CLIを起動してください。
{ "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は明示的な人の確認後だけ請求処理を開始します。
exchangerate MCPサーバーのlist_currenciesツールを使ってください。JPYとKRWが対応しているか答え、その後は停止してください。請求やチェックアウトのツールは呼び出さないでください。USD/JPYとUSD/KRWを問い合わせる
通貨ペア、方向、観測時刻をプロンプトに明記します。タイムスタンプ、source、market_sessionも表示させ、参考値と取引価格を混同しないようにします。
get_rateでbase USD、quote JPYを指定してください。レート、timestamp、source、market_sessionを表示してください。インディケーティブな参考レートであり、取引価格ではないと明記してください。convertで2500 USDをKRWに換算してください。ツールがエラーを返したらレートを推測しないでください。履歴を推測せずに取得する
get_rangeにbase、symbol、ISO形式の日付範囲を指定します。日次系列には休場日の前方補完行が含まれることがあります。エクスポート時もメタデータを保持してください。
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ドキュメントで設定、環境変数、確認動作を確認してください。