Gemini CLI / Antigravity 接続詳細手順

最終更新: 2026-08-03

このページは、Google のローカル開発環境でフラクソン（kintone連携）を使うための詳細手順です。主な対象は、ターミナルで使う Gemini CLI、エディタ/IDEとして使う Antigravity、ターミナル版の Antigravity CLI です。

全体の流れ

ステップ0. 前提を確認する

ステップ1. 接続URLを決める

フラクソンのRemote MCP URLは、次の形式です。{{tenant-slug}} は自社テナントの値に置き換えます。波括弧 {{ }} は入力しません。

https://app-fluxon.gusuku.io/t/{{tenant-slug}}/mcp

例としてテナントスラッグが example の場合は、次のようになります。

https://app-fluxon.gusuku.io/t/example/mcp

ステップ2. mcp_config.json を作成・編集する

Antigravity と Antigravity CLI では、個人ごとのグローバル設定として ~/.gemini/config/mcp_config.json を使います。まず設定フォルダを作成します。

mkdir -p ~/.gemini/config

次に、~/.gemini/config/mcp_config.json をエディタで開き、次の内容を保存します。すでに mcpServers がある場合は、その中へ kintone-fluxon を追加してください。

{
  "mcpServers": {
    "kintone-fluxon": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://app-fluxon.gusuku.io/t/{{tenant-slug}}/mcp"
      ]
    }
  }
}

この設定は、ローカルの npx で mcp-remote を起動し、フラクソンのRemote MCP URLへ接続する方式です。Antigravityの公式ドキュメントには serverUrl を直接書くRemote接続方式もありますが、この手順では command と args による stdio 接続として設定します。

ステップ3. JSONを確認する

保存後、JSONの文法エラーがないか確認します。

python3 -m json.tool ~/.gemini/config/mcp_config.json

Windows PowerShell の場合は、ファイルの場所を $HOME\.gemini\config\mcp_config.json と読み替えてください。

ステップ4. Gemini CLI / Antigravity を再起動する

ステップ5. 初回認可を行う

最初にフラクソンのMCPツールを使おうとすると、ブラウザでフラクソンの認可画面が開く場合があります。認可画面では、次の点を確認してから許可してください。

• 接続先が自社のフラクソンURLであること。
• テナント名またはテナントスラッグが想定どおりであること。
• ログインしているフラクソンユーザーが自分であること。
• 要求されているスコープが、管理者から案内された利用範囲と合っていること。

身に覚えのないテナント、ユーザー、スコープが表示された場合は許可せず、フラクソン管理者に確認してください。

ステップ6. 読み取りテストを行う

接続後、まずは読み取り系の依頼で確認します。

フラクソンで利用できるkintoneアプリの一覧を確認してください。

顧客管理アプリの主要フィールドを確認してください。

案件管理アプリで、ステータス別の件数を集計してください。

フラクソンに保存されている自分のkintoneユーザーIDを確認してください。

ツール実行の確認が表示された場合は、ツール名、対象アプリ、操作内容を確認してから許可します。初回から書き込み・削除を試すのではなく、まず読み取りで接続と権限範囲を確認してください。

接続できないとき

安全に使うための注意

• mcp_config.json には、パスワード、OAuth token、kintone API tokenを直接書かないでください。
• 最初から常時許可や自動承認を有効にせず、読み取り系の動作を確認してから必要範囲を広げてください。
• 書き込み、削除、ファイル添付などの操作は、対象アプリ・レコード・フィールドを確認してから許可してください。
• 退職、異動、端末紛失があった場合は、フラクソン側のユーザー権限とRemote MCP接続を見直してください。

関連ページ

• MCPとRemote MCPの基礎
• MCPツール一覧とプロンプトサンプル
• フラクソン用SKILLの解説とインストール方法
• Gemini Spark 接続・設定手順
• FAQとトラブルシューティング

参考

• Gemini CLI: MCP servers with Gemini CLI
• Gemini CLI: configuration
• Google Antigravity: Model Context Protocol
• Google Antigravity CLI: Overview
• Gemini Apps Help: Gemini Spark のカスタムアプリ