すべてのドキュメントを閲覧

Gemini MCPでNarwhalを使う

Antigravity CLI は、Authorization Bearer ヘッダー付きの Streamable HTTP で Narwhal に接続できます。個人ユーザーは Gemini CLI から Antigravity CLI に移行しており、コマンドは agy です。Gemini CLI が引き続き使える環境では、独自の設定形式で接続することもできます。

クイックスタート

  1. https://narwhalapi.com/signup から無料のNarwhalキーを取得し、プロンプトやURLには含めないでください。
  2. Antigravity CLI では、~/.gemini/config/mcp_config.json かワークスペースの .agents/mcp_config.json を開きます。
  3. serverUrl と Authorization Bearer ヘッダーを持つリモートエントリを追加し、ファイルは非公開に保ってください。
  4. Antigravity の接続を /mcp で確認します。
  5. Gemini CLI が使える環境では、-s user を付けた add コマンドを実行すると、キーがユーザー設定に保存されます。

MCPの設定

Antigravity CLI は、Streamable HTTP には serverUrl、ヘッダーには headers オブジェクトを使います。Gemini CLI の追加コマンドでは、-s user、HTTP トランスポート、Authorization Bearer ヘッダーを指定します。

~/.gemini/config/mcp_config.json
{
  "mcpServers": {
    "narwhal": {
      "serverUrl": "https://api.narwhalapi.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_NARWHAL_API_KEY"
      }
    }
  }
}
Gemini CLI
gemini mcp add -s user --transport http \ --header "Authorization: Bearer YOUR_NARWHAL_API_KEY" \ narwhal https://api.narwhalapi.com/mcp

Antigravity CLI のドキュメントには、ヘッダー内で環境変数を展開する方法の記載がないため、設定ファイルにはキーの値そのものを保存します。ユーザー設定でもワークスペースでも、ファイルは非公開に保ち、バージョン管理に含めないでください。

利用できるツール

どちらの対応CLIも、1つのNarwhal接続で読み取り専用のこれらすべてのグループを利用できます。初期化とツール検出は無料です。呼び出しは成功するたびに1回と数え、RESTと共有するクレジットから差し引かれます。

グループ依頼できる内容ツール
経済指標国別に、CPI、インフレ率、失業率、労働力率、GDP、GDP成長率、貿易のデータを依頼できます。対象範囲は指標ごとに異なります。economics_get_cpi economics_get_inflation economics_get_unemployment economics_get_labour_force_participation economics_get_gdp economics_get_gdp_growth economics_get_trade economics_get_cpi_history economics_get_inflation_history economics_get_unemployment_history economics_get_labour_force_participation_history economics_get_gdp_history economics_get_gdp_growth_history economics_get_trade_history economics_read_series_observations economics_search_catalogue economics_read_catalogue_series economics_read_catalogue_observations economics_read_catalogue_latest_batch economics_get_policy_rate economics_get_policy_rate_history economics_get_central_bank_reserves economics_get_central_bank_balance_sheet
通貨レート通貨ペアについて、現在の為替レート、過去のレート、通貨の換算、レートのバーを依頼できます。fx_get_rates fx_get_rate_history fx_convert_currency fx_get_rate_bars
コモディティ価格金、銀、プラチナ、パラジウム、銅、WTI原油、ブレント原油のスポット価格とその価格履歴、および現物のパーム油価格(粗パーム油と果房)を取得できます。commodities_get_spot_price commodities_get_price_history commodities_list_palmoil_physical_series commodities_get_palmoil_physical_price commodities_get_palmoil_physical_observations commodities_list_physical_series commodities_get_physical_series commodities_get_physical_latest commodities_get_physical_observations
発表とイベント国別のブリーフィングを計画する前に、公式の経済指標の発表日とイベントの詳細を依頼できます。economics_list_releases economics_get_release events_list events_get
祝日国別の祝日、特定の日付の祝日、次の祝日を依頼できます。calendars_list_holidays calendars_get_holidays_on_date calendars_get_next_holiday
予測市場の確率スカラー、極値、タイミング、二値の結果を持つ予測市場のトピックとイベント、その履歴、当局別の政策パスを依頼できます。predictions_list_topics predictions_get_topic predictions_list_events predictions_get_scalar predictions_get_extreme predictions_get_timing predictions_get_binary predictions_get_scalar_history predictions_get_extreme_history predictions_get_timing_history predictions_get_binary_history predictions_get_policy_path predictions_get_policy_path_history
国債利回り米国、英国、ドイツ、日本、カナダ、スウェーデン、ノルウェー、オーストラリア、ユーロ圏の国債利回り曲線を、同じ Narwhal 接続で取得できます。economics_get_yield_curve economics_get_yield_curve_history

プロンプト例

  • 日本の最新のインフレ率を取得します。
  • 現在の USD/IDR 為替レートを表示します。
  • 現在の金のスポット価格を取得します。
  • 米国の次回のCPI公式発表日を調べて。
  • インドネシアの今年の祝日を一覧にします。

よく使うワークフロー

日本のインフレ率ブリーフィングを準備する

日本のインフレ率は、どちらの CLI でも economics_get_inflation で取得できます。日本を指定すると、最新の報告された変化率が得られます。

通貨を換算する前にレートを確認する

USD/IDR は fx_get_rates で確認します。USD を基準通貨、IDR を相手通貨に指定すると、現在の参考レートが得られます。

分析のためにコモディティ価格を確認する

commodities_get_spot_price は銅と建値通貨を受け付け、現在の参考スポット価格を返します。

次の CPI 発表のタイミングを確認する

米国と最大 366 日の期間を指定して economics_list_releases にリクエストすると、次の公式な CPI 発表を見つけられます。

ヒント

  • Antigravity CLI では serverUrl を使ってください。httpUrl と旧来の SSE トランスポートはサポートされていません。
  • Gemini CLI では、-s user を付けるとキーが ~/.gemini/settings.json に保存され、既定のプロジェクトスコープではリポジトリの .gemini/settings.json に書き込まれます。
  • Gemini CLI の設定では、mcpServers の下に httpUrl と headers を持つエントリを使います。

よくある質問

個人の Gemini ユーザーは今でも Gemini CLI を使えますか?

個人ユーザーは Gemini CLI から Antigravity CLI に移行しており、コマンドは agy です。Gemini CLI が引き続き使える環境では、別の設定形式を使います。

Antigravity CLI は Narwhal にどの URL フィールドを使いますか?

Antigravity CLI では、Streamable HTTP エンドポイント https://api.narwhalapi.com/mcp を serverUrl に指定します。Authorization Bearer ヘッダーは headers に追加し、/mcp で接続を確認してください。

Antigravity は環境変数の参照からキーを読み取れますか?

ドキュメントにはヘッダー内の環境変数展開の記載がないため、ファイルにはキーの値を保存します。ユーザーまたはワークスペースの設定ファイルは非公開に保ち、バージョン管理に含めないでください。

トラブルシューティング

症状確認
Narwhal が Antigravity CLI に表示されないユーザーまたはワークスペースの mcp_config.json のエントリを確認し、serverUrl を使っていることを確かめて、/mcp を調べてください。
サーバーが 401 invalid_api_key を返すヘッダーに、未展開の環境変数の参照ではなく、Bearer、空白、有効なキーの順で入っているか確認してください。
httpUrl を使った Antigravity の接続が失敗するリモートエントリを serverUrl と Streamable HTTP に変更してください。Antigravity は httpUrl と旧来の SSE トランスポートに対応していません。
Gemini CLI は、このアカウント区分では利用できなくなりました個人アカウントでは Antigravity CLI を使い、Gemini CLI の設定形式ではなく、Antigravity CLI の設定形式に従ってください。

このページは役に立ちましたか?