ガイドチュートリアル

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

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

2026年9月5日 · 6分で読了

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用の設定項目です。

.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を問い合わせる

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

確認プロンプトを有効にする

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

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

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

仕様を確認する

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

よくある質問

Gemini CLIでリモートMCPサーバーを使えますか?

はい。`httpUrl`でStreamable HTTPエンドポイントを設定できます。まず認証なしで接続を確認し、継続利用では環境変数からBearerキーを渡します。

レートは決済に使えますか?

使えません。参考・分析用のインディケーティブ値です。timestamp、source、market_sessionも保存してください。

関連記事

無料のAPIキーで始める

無料プランで月5,000リクエスト。クレジットカードは不要です。

無料キーを取得