CursorのためのAktar
Cursorから自分のバケットへファイルをアップロード
CursorにAktarを追加すると、エージェントが画像やファイルを自分のS3、Cloudflare R2、Backblaze B2バケットにアップロードし、一時リンクを作り、バケットの中を見られるようになります。お使いのコンピューター上でAktarアプリと一緒に動くので、ストレージのキーがAktarの外に出ることはありません。
セットアップgetaktar/cliv0.6.0
public/og-image.pngをアップロードして、そのURLをog:imageのmetaタグに使って。
upload_file{ "path": "public/og-image.png" }アップロードしました。og:imageタグにこのURLを入れました:
https://files.example.com/2026/11/og-image.pngこんなことを頼めます
-
ドキュメントや変更履歴用の画像
“docs/にあるスクリーンショットをアップロードして、CHANGELOG.mdにリンクを貼って。”
エージェントが画像を1枚ずつアップロードし、リンクを適切な場所に書き込みます。画像の変換やクリーンアップは、アップロード先の設定に従ってAktarが行います。
ツール:
upload_file -
期限付きのリンク
“Buildsバケットにあるbackup.sqlの30分間有効なリンクをください。”
バケット内のどのファイルにも使える署名付きリンクで、プライベートバケットや期間限定の共有に便利です。バケットの中身は変わらず、リンクの有効期限は、延長を許可しない限り最長60分です。
ツール:
create_temporary_link -
バケットの中を見る
“Downloadsバケットのreleasesフォルダーには何が入ってる?”
Aktarでアップロードしていないものも含めて、フォルダーとファイルを一覧表示します。
ツール:
list_bucket
セットアップ
Mac版またはWindows版のAktarをインストールし、アップロード先(自分のバケット)を追加します。Aktarで設定 → 連携を開き、ローカル接続を許可をオンにしてトークンをコピーし、このコマンドに貼り付けます。Node.js 18以降が必要です。
npx @getaktar/cli loginプロジェクトに、次の内容で
.cursor/mcp.jsonを作成します。${workspaceFolder}はプロジェクトのフォルダーなので、Aktarはそのプロジェクトのファイルだけをアップロードします。.cursor/mcp.jsonに記述{ "mcpServers": { "aktar": { "command": "npx", "args": ["-y", "@getaktar/cli", "mcp", "--root", "${workspaceFolder}"] } } }Cursorの設定を開き、MCPの一覧で
aktarを探して、オンになっていることを確認します。これでエージェントがAktarのツールを使えるようになります。
すべてのプロジェクトでAktarを使うには、同じ内容を~/.cursor/mcp.jsonに記述し、${workspaceFolder}の代わりに/Users/you/Projectsのようなフォルダーを指定します(WindowsではC:\\Users\\you\\Projects)。複数のフォルダーを許可するには、--rootとフォルダーを繰り返して指定します。
フォルダーを--rootで指定しているため、クリップボードから直接アップロードする機能は外れます。代わりにエージェントにファイルを指定してください。アップロードの置き換えや削除を許可するには、引数に--allow-replaceや--allow-deleteを追加します。Cursorがnpxを起動できない場合は、which npxで表示されるフルパスをcommandに指定してください。
触れてよい範囲
ファイルはサーバーが使ってよいフォルダーからだけ取得され、SSH鍵、.envファイル、クラウドの認証情報などの秘密情報がアップロードされることはありません。アップロードの置き換えと削除は、自分でオンにしない限りオフです。ストレージのキーはAktarの中にとどまり、エージェントに返るのはファイル名とリンクだけで、当社には何も送られません。アップロードしたファイルはリンクを知っている誰にでも公開されるので、共有したいものだけを頼んでください。
詳しくはプライバシーポリシーをご覧ください。すべてのツールとオプションはMCPサーバーのページにあります。
よくある質問
Cursorはストレージのキーを受け取りますか?
いいえ。キーはAktarアプリの中にとどまります。サーバーが使うのは、npx @getaktar/cli loginが自分だけが読めるファイルに保存するローカルのトークンだけで、127.0.0.1上でAktarと通信します。
エージェントはアップロードの前に確認しますか?
Cursorは、そのツールの自動実行をオンにしていない限り、MCPのツールを実行する前に確認します。検索、一覧表示、一時リンクは見るだけですが、アップロードはバケットを変更します。
すべてのプロジェクトでまとめて使えますか?
はい。代わりに~/.cursor/mcp.jsonに設定を記述し、--rootの後にアップロード元にしてよいフォルダーを指定します。
Windowsでも使えますか?
はい。Windows版Aktar 0.11.0以降で使えます。MacではMac版Aktar 0.18.0以降が必要です。