Gemini MCPでNarwhalを使う
Antigravity CLI は、Authorization Bearer ヘッダー付きの Streamable HTTP で Narwhal に接続できます。個人ユーザーは Gemini CLI から Antigravity CLI に移行しており、コマンドは agy です。Gemini CLI が引き続き使える環境では、独自の設定形式で接続することもできます。
クイックスタート
- https://narwhalapi.com/signup から無料のNarwhalキーを取得し、プロンプトやURLには含めないでください。
- Antigravity CLI では、
~/.gemini/config/mcp_config.jsonかワークスペースの.agents/mcp_config.jsonを開きます。 serverUrlと Authorization Bearer ヘッダーを持つリモートエントリを追加し、ファイルは非公開に保ってください。- Antigravity の接続を
/mcpで確認します。 - Gemini CLI が使える環境では、
-s userを付けた add コマンドを実行すると、キーがユーザー設定に保存されます。
MCPの設定
Antigravity CLI は、Streamable HTTP には serverUrl、ヘッダーには headers オブジェクトを使います。Gemini CLI の追加コマンドでは、-s user、HTTP トランスポート、Authorization Bearer ヘッダーを指定します。
{
"mcpServers": {
"narwhal": {
"serverUrl": "https://api.narwhalapi.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_NARWHAL_API_KEY"
}
}
}
}gemini mcp add -s user --transport http \ --header "Authorization: Bearer YOUR_NARWHAL_API_KEY" \ narwhal https://api.narwhalapi.com/mcpAntigravity CLI のドキュメントには、ヘッダー内で環境変数を展開する方法の記載がないため、設定ファイルにはキーの値そのものを保存します。ユーザー設定でもワークスペースでも、ファイルは非公開に保ち、バージョン管理に含めないでください。
利用できるツール
どちらの対応CLIも、1つのNarwhal接続で読み取り専用のこれらすべてのグループを利用できます。初期化とツール検出は無料です。呼び出しは成功するたびに1回と数え、RESTと共有するクレジットから差し引かれます。
| グループ | 依頼できる内容 | ツール |
|---|---|---|
| 経済指標 | 国別に、CPI、インフレ率、失業率、労働力率、GDP、GDP成長率、貿易のデータを依頼できます。対象範囲は指標ごとに異なります。 | economics_ economics_ economics_ economics_ economics_ economics_ economics_ economics_ economics_ economics_ economics_ economics_ economics_ economics_ economics_ economics_ economics_ economics_ economics_ economics_ economics_ economics_ economics_ |
| 通貨レート | 通貨ペアについて、現在の為替レート、過去のレート、通貨の換算、レートのバーを依頼できます。 | fx_ fx_ fx_ fx_ |
| コモディティ価格 | 金、銀、プラチナ、パラジウム、銅、WTI原油、ブレント原油のスポット価格とその価格履歴、および現物のパーム油価格(粗パーム油と果房)を取得できます。 | commodities_ commodities_ commodities_ commodities_ commodities_ commodities_ commodities_ commodities_ commodities_ |
| 発表とイベント | 国別のブリーフィングを計画する前に、公式の経済指標の発表日とイベントの詳細を依頼できます。 | economics_ economics_ events_ events_ |
| 祝日 | 国別の祝日、特定の日付の祝日、次の祝日を依頼できます。 | calendars_ calendars_ calendars_ |
| 予測市場の確率 | スカラー、極値、タイミング、二値の結果を持つ予測市場のトピックとイベント、その履歴、当局別の政策パスを依頼できます。 | predictions_ predictions_ predictions_ predictions_ predictions_ predictions_ predictions_ predictions_ predictions_ predictions_ predictions_ predictions_ predictions_ |
| 国債利回り | 米国、英国、ドイツ、日本、カナダ、スウェーデン、ノルウェー、オーストラリア、ユーロ圏の国債利回り曲線を、同じ Narwhal 接続で取得できます。 | economics_ economics_ |
プロンプト例
- 日本の最新のインフレ率を取得します。
- 現在の 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 の設定形式に従ってください。 |
このページは役に立ちましたか?