Gemini CLIのためのAktar
Gemini CLIから自分のバケットへファイルをアップロード
Aktar拡張機能を使うと、Gemini CLIがファイルやスクリーンショットを自分のS3、Cloudflare R2、Backblaze B2バケットにアップロードし、クリップボードの内容をリンクにし、過去のアップロードを探せるようになります。お使いのコンピューター上でAktarアプリと一緒に動くので、ストレージのキーがAktarの外に出ることはありません。
dist/report.pdfをアップロードして、チーム用のリンクをください。
upload_file{ "path": "dist/report.pdf" }アップロードしました。リンクはこちらです:
https://files.example.com/2026/11/report.pdfこんなことを頼めます
-
ファイルを共有
“dist/report.pdfをアップロードして、リンクをください。”
Geminiがプロジェクトのファイルをアップロードします。アップロード先を指定しなければ、メニューバーへのドロップと同じように、Aktarがファイルの種類で選びます。
ツール:
upload_file -
コピーしたものをアップロード
“クリップボードにあるスクリーンショットをアップロードして。”
コピーした画像やファイルをAktarがアップロードし、リンクが会話に返ってきます。
ツール:
upload_clipboard -
短縮リンク
“昨日アップロードしたリリースノートの短縮リンクを作って。”
アップロードを見つけ、そのアップロード先に設定した短縮サービスで短縮リンクを作るようAktarに頼みます。
ツール:
search_uploads,create_short_link
セットアップ
Mac版またはWindows版のAktarをインストールし、アップロード先(自分のバケット)を追加します。Aktarで設定 → 連携を開き、ローカル接続を許可をオンにしてトークンをコピーし、このコマンドに貼り付けます。Node.js 18以降が必要です。
npx @getaktar/cli loginターミナルで拡張機能をインストールします。
gemini extensions install https://github.com/getaktar/agent-pluginsプロジェクトのフォルダーで
geminiを起動し、聞かれたらフォルダーを信頼します。Gemini CLIは、信頼していないフォルダーではMCPサーバーを起動しません。/mcpを実行すると、Aktarのツールが表示されます。
拡張機能は@getaktar/cliの固定バージョンをnpxで実行するので、aktarコマンドをインストールする必要はありません。更新はgemini extensions update aktarで行います。
アップロードするのは、Gemini CLIを起動したフォルダーのファイルだけです。ホームフォルダーで起動するとローカルのファイルは一切アップロードされないので、プロジェクトのフォルダーで起動してください。
触れてよい範囲
ファイルはサーバーが使ってよいフォルダーからだけ取得され、SSH鍵、.envファイル、クラウドの認証情報などの秘密情報がアップロードされることはありません。アップロードの置き換えと削除は、自分でオンにしない限りオフです。ストレージのキーはAktarの中にとどまり、エージェントに返るのはファイル名とリンクだけで、当社には何も送られません。アップロードしたファイルはリンクを知っている誰にでも公開されるので、共有したいものだけを頼んでください。
詳しくはプライバシーポリシーをご覧ください。すべてのツールとオプションはMCPサーバーのページにあります。
よくある質問
拡張機能はストレージのキーを受け取りますか?
いいえ。キーはAktarアプリの中にとどまります。拡張機能が使うのは、npx @getaktar/cli loginが自分だけが読めるファイルに保存するローカルのトークンだけで、127.0.0.1上でAktarと通信します。
GeminiにAktarのツールが表示されないのはなぜですか?
たいていはフォルダーを信頼していないためです。Gemini CLIは、信頼していないフォルダーではMCPサーバーに接続しません。そのフォルダーでgemini trustを実行するか、Geminiに聞かれたときに信頼してから、/mcpで確認してください。
Geminiはアップロードの前に確認しますか?
はい。そのツールを許可したか、Gemini CLIをYOLOモードで起動した場合を除きます。検索と一覧表示は見るだけですが、アップロードはバケットを変更します。
Windowsでも使えますか?
はい。Windows版Aktar 0.11.0以降で使えます。MacではMac版Aktar 0.18.0以降が必要です。