--logを使えばすべてのツール呼び出しが記録されるので、エージェントが何をしたかを後から確認できます。- MCPサーバー
- aktar v0.6.0
AIエージェントに、自分のバケットから
ファイルを共有させよう
aktar mcpは、Claude、Cursor、VS Code、Codexなどのエージェントを Aktarアプリにつなぎます。リンクを頼むと、エージェントが自分のS3、Cloudflare R2、Backblaze B2バケットにファイルをアップロードし、URLやMarkdownを返します。ストレージのキーがAktarの外に出ることはありません。
そのあとaktar loginを一度実行します。Cursor、VS Code、Codexなどは下にあります。
デスクトップにあるチェックアウトのバグのスクリーンショットをアップロードして、issue用のMarkdownリンクをください。
Aktarを呼び出しました · upload_file
Screenshotsのアップロード先にアップロードしました。issue用のMarkdownはこちらです:
2ステップでセットアップ
アップロードを行うのはMac版またはWindows版のAktarなので、エージェントと同じコンピューターで起動しておく必要があります。
aktarコマンドをインストールして、Aktarに接続します。Aktarで設定 → 連携を開き、ローカル接続を許可をオンにしてトークンをコピーし、aktar loginに貼り付けます。
npm install -g @getaktar/cli
aktar loginエージェントにAktarを追加します。--rootの後に、ファイルのアップロード元にしてよいフォルダーを指定します(複数のフォルダーは繰り返して指定)。必要になると、エージェントがaktar mcpを自動で起動します。
Claude Code
コマンド1つで、すべてのプロジェクトに追加できます。~/Projectsは、作業しているフォルダーに変えてください。Claude Codeの/mcpで確認できます。
claude mcp add --scope user aktar -- aktar mcp --root ~/ProjectsCodex
コマンド1つで、~/.codex/config.tomlに書き込まれます。
codex mcp add aktar -- aktar mcp --root ~/ProjectsVS Code
コマンド1つでVS Codeのプロファイルに追加されます。CopilotのエージェントモードにAktarのツールが表示されます。
code --add-mcp '{"name":"aktar","command":"aktar","args":["mcp","--root","/Users/you/Projects"]}'Cursor
このファイル、または特定のプロジェクトの.cursor/mcp.jsonに追加します。
Claude Desktop
Settings > Developer > Edit Configを開き、これを追加して、Claude Desktopを再起動します。
Windsurf
このファイルに追加し、Windsurfの設定でMCPサーバーを更新します。
アプリがaktarを見つけられないと表示した場合は、which aktarで表示されるフルパスをcommandに指定してください。デスクトップアプリはシェルのPATHを読み込まないことがあります。グローバルインストールしていない場合は、コマンドにnpx、引数に["-y", "@getaktar/cli", "mcp", "--root", "/Users/you/Projects"]を指定します。/Users/you/Projectsは自分のフォルダーに置き換えてください(WindowsではC:\\Users\\you\\Projectsのように)。--rootがない場合、ファイルはエージェントがサーバーを起動したフォルダーからだけ取得され、それがホームフォルダーやディスクの最上位の場合(デスクトップアプリではよくあります)は、どこからも取得されません。stdioでMCPサーバーを実行できるほかのエージェントでも、同じように使えます。
こんなことを頼めます
同僚に話しかけるように頼んでください。エージェントがツールを選び、Aktarがアップロード先ごとの設定でアップロードして、リンクが会話に返ってきます。
セッション中のファイルを共有
“ビルドをzipにして、QAに送れるリンクをください。”
エージェントがファイルを作ってアップロードします。アップロード先を指定しなければ、メニューバーへのドロップと同じように、Aktarがファイルの種類(各アップロード先の用途)で選びます。
ツール:
upload_fileREADMEやissue用の画像
“docs/imagesにある新しいスクリーンショットをREADMEに追加して。”
画像をアップロードし、Markdownを適切な場所に書き込みます。WebPへの変換や位置情報の削除は、アップロード先の設定に従ってAktarが行います。
ツール:
upload_fileリンクはそのままでファイルを更新
“先週共有したオンボーディングのPDFを、この新しいバージョンに置き換えて。”
履歴からアップロードを見つけ、その上に新しいファイルを書き込みます。リンクを持つ全員に新しいバージョンが表示され、送り直す必要はありません。置き換えると古いファイルは上書きされるため、
--allow-replaceが必要です。ツール:
search_uploadsreplace_fileアップロードしたものを探す
“月曜にアップロードした請求書のリンクはどれだっけ?”
Aktarの履歴を名前と日付で検索し、サムネイルを見てスクリーンショット、写真、ドキュメントを見分けることもできます。
ツール:
search_uploadsget_thumbnail期限付きのリンク
“Legalバケットにある契約書の30分間有効なリンクをください。”
バケット内のどのファイルにも使える署名付きリンクで、プライベートバケットや期間限定の共有に便利です。バケットの中身は変わりません。
ツール:
create_temporary_linkバケットの中を見て回る
“Buildsバケットのreleasesフォルダーには何が入ってる?”
Aktarでアップロードしていないものも含めてフォルダーとファイルを一覧表示し、どのアップロード先がどの種類のファイルに使われるかも把握しています。
ツール:
list_bucketlist_destinations
使っているAIツール別のステップガイド
すぐに使えるプラグインやコピーできる設定と、セットアップ後に頼めることをまとめました。
エージェントが使えるツール
検索、一覧表示、一時リンク、サムネイルは見るだけです。アップロードはバケットを変更するため、許可していない限り、エージェントは使う前に確認します。置き換えと削除は、自分でオンにしたときだけ提供されます。
| ツール | できること |
|---|---|
| upload_ | ファイルをアップロードし、リンク、Markdown、HTMLを返します。アップロード先、名前、フォルダー、有効期限は省略できます。shortで短縮リンクの作成を指定、または抑止できます。 |
| upload_ | クリップボードのファイルまたは画像をアップロードします。shortで短縮リンクの作成を指定、または抑止できます。--rootを指定すると提供されません。 |
| replace_ | リンクを保ったまま、アップロード済みのファイルやバケット内の任意のファイルを新しいファイルで置き換えます。--allow-replaceまたは--allow-deleteを付けたときだけ提供されます。Aktar for Mac 0.14.0 または Windows 0.7.0 が必要です。 |
| create_ | アップロード先の短縮サービスでアップロードの短縮リンクを作成するか、既存のものを返します。--read-onlyでは提供されません。Aktar for Mac 0.17.0 または Windows 0.10.0 が必要です。 |
| search_ | アップロード履歴を検索します。 |
| list_ | アップロード先と、それぞれが使われるファイルの種類を一覧表示します。 |
| list_ | バケット内のフォルダーとファイルを一覧表示します。Aktarでアップロードしていないファイルも含まれます。 |
| create_ | 一定時間後に無効になるリンク(署名付きURL)を作成します。それまでは、リンクを知っていれば誰でも、非公開のバケットからでもファイルをダウンロードできます。--max-link-minutesで延ばさない限り最長60分です。 |
| get_ | アップロードしたもののプレビューをエージェントに見せます。Aktar for Mac 0.13.0 または Windows 0.6.0 が必要です。 |
| list_ | 監視フォルダーとその状態を一覧表示します。 |
| get_ | Aktarへの接続を確認します。 |
| delete_ | バケットからアップロード済みのファイルを削除します。--allow-deleteを付けた場合のみ。 |
触れてよい範囲は自分で決める
アップロードしたファイルは、リンクを知っている誰にでも公開されます。そのためサーバーは最小限の機能で始まり、何を追加するかは自分で決められます。
アップロードは公開すること
エージェントには、共有を頼まれたものだけをアップロードするよう指示されており、アップロードするツールを呼ぶ前には確認します。指定したフォルダーからだけ、秘密情報は対象外
ファイルは、--rootで指定したフォルダーか、エージェントがサーバーを起動したフォルダーからだけ取得されます。うっかりホームフォルダー全体が対象になることはありません。SSH鍵や秘密鍵、.envファイル、クラウドの認証情報、ブラウザーのプロファイル、パスワードデータベースは、シンボリックリンク経由も含め、どこにあっても拒否されます。指示しない限り上書きしない
ファイルの置き換えは--allow-replace、削除は--allow-deleteを付けたときだけ提供されます。--read-onlyを付けると、書き込みを伴うツールがすべて外れます。一時リンクの有効期限は、--max-link-minutesで延ばさない限り最長60分です。キーはAktarの中にとどまる
サーバーは127.0.0.1上でAktarと通信し、トークンを送る前に相手が本当にAktarかどうかを確認します。エージェントがアクセスキーを目にすることはなく、当社のサーバーを経由することもありません。
MCPが使えない? スキルを使おう
スキルは使えてもMCPは使えないエージェント向けに、aktar skillがaktarコマンドの使い方を教えるSKILL.mdを出力します。何を実行し、--jsonをどう読み取り、頼まれたものだけをアップロードする、という内容です。すべてのコマンドはCLIドキュメントにあります。
mkdir -p ~/.claude/skills/aktar
aktar skill > ~/.claude/skills/aktar/SKILL.md必要なもの
- Mac版またはWindows版のAktar(起動中で、アップロード先が1つ以上あること)
-
aktarコマンド0.4.0以降(Node.js 18以降)。aktar 0.6.0以降にはMac版Aktar 0.18.0またはWindows版0.11.0が必要 - stdioでMCPサーバーを実行できるエージェント
- ファイルの置き換え: Mac版Aktar 0.14.0またはWindows版0.7.0。サムネイル: Mac版0.13.0またはWindows版0.6.0
- GitHubで公開されているオープンソース(MIT)で、公式のMCP Registryに掲載されています
よくある質問
ChatGPTや、ブラウザー上のほかのエージェントでも使えますか?
頼んでいないファイルをエージェントがアップロードすることはありますか?
--rootで指定したフォルダー(またはエージェントがサーバーを起動したフォルダー)からだけ取得され、SSH鍵や.envファイルのような秘密情報がアップロードされることはありません。--read-onlyを使うとアップロードはオフになり、--logを使えば何が呼び出されたかを後から確認できます。どのバケットにアップロードされますか?
費用はかかりますか?
Windowsでも使えますか?
aktarコマンドはWindows版のAktarでも同じように動き、上に挙げたエージェントもすべて使えます。